Modifica le policy sul confine di accesso dell'entità

Le policy sul confine di accesso dell'entità (PAB) ti consentono di limitare le risorse a cui un set di entità può accedere. Questa pagina spiega come modificare le policy sul confine di accesso dell'entità esistenti e come modificare le associazioni delle policy sul confine di accesso dell'entità per cambiare le persone a cui si applicano.

Prima di iniziare

  • Configurare l'autenticazione.

    Seleziona la scheda relativa al modo in cui prevedi di utilizzare gli esempi in questa pagina:

    gcloud

    Nella console Google Cloud , attiva Cloud Shell.

    Attiva Cloud Shell

    Nella parte inferiore della console Google Cloud , viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.

    REST

    Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

      Installa Google Cloud CLI.

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

  • Leggi la panoramica delle policy sul confine di accesso dell'entità.

Ruoli richiesti per modificare le policy sul confine di accesso dell'entità

Per ottenere l'autorizzazione necessaria per modificare le policy sul confine di accesso dell'entità, chiedi all'amministratore di concederti il ruolo IAM Amministratore dei confini di accesso dell'entità (roles/iam.principalAccessBoundaryAdmin) nella tua organizzazione. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione iam.principalaccessboundarypolicies.update, necessaria per modificare le policy sul confine di accesso dell'entità.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Ruoli richiesti per modificare le associazioni delle policy di Principal Access Boundary

Le autorizzazioni necessarie per modificare le associazioni delle policy per le policy sul confine di accesso dell'entità dipendono dal set di entità associato alla policy.

Per ottenere le autorizzazioni necessarie per modificare le associazioni delle policy per le policy sul confine di accesso dell'entità, chiedi all'amministratore di concederti i seguenti ruoli IAM:

  • Confine di accesso dell'entità Utente (roles/iam.principalAccessBoundaryUser) nella tua organizzazione
  • Modifica le associazioni delle policy per le policy sul confine di accesso delle entità associate ai pool di identità della forza lavoro: IAM Workforce Pool Admin (roles/iam.workforcePoolAdmin) sul pool di identità della forza lavoro di destinazione
  • Modifica le associazioni delle policy per le policy sul confine di accesso dell'entità associate ai pool di identità del workload: IAM Workload Identity Pool Admin (roles/iam.workloadIdentityPoolAdmin) sul progetto proprietario del pool di identità del workload di destinazione
  • Ottieni lo stato di un'operazione a lunga esecuzione per la modifica di un'associazione che fa riferimento a un pool di identità del workload: IAM Operation Viewer (roles/iam.operationViewer) sul progetto proprietario del pool di identità del workload di destinazione
  • Modifica le associazioni delle policy per le policy sul confine di accesso dell'entità associate a un dominio Google Workspace: Workspace Pool IAM Admin (roles/iam.workspacePoolAdmin) sull'organizzazione
  • Modifica le associazioni delle policy per le policy sul confine di accesso dell'entità associate al set di entità di un progetto: Project IAM Admin (roles/resourcemanager.projectIamAdmin) sul progetto
  • Ottenere lo stato di un'operazione a lunga esecuzione per la modifica di un'associazione che fa riferimento al set di entità di un progetto: IAM Operation Viewer (roles/iam.operationViewer) sul progetto
  • Modifica le associazioni delle policy per le policy sul confine di accesso dell'entità associate al set di entità di una cartella: Amministratore IAM cartella (roles/resourcemanager.folderIamAdmin) sulla cartella
  • Modifica le associazioni delle policy per le policy sul confine di accesso dell'entità associate al set di entità di un'organizzazione: Organization Administrator (roles/resourcemanager.organizationAdmin) sull'organizzazione

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per modificare le associazioni delle policy per le policy sul confine di accesso dell'entità. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per modificare le associazioni delle policy per le policy sul confine di accesso dell'entità sono necessarie le seguenti autorizzazioni:

  • iam.principalaccessboundarypolicies.bind sull'organizzazione
  • Modifica le associazioni delle policy per le policy dei confini di accesso delle entità associate ai pool di identità della forza lavoro: iam.workforcePools.updatePolicyBinding nel pool di identità della forza lavoro di destinazione
  • Modifica le associazioni delle policy per le policy sul confine di accesso dell'entità associate ai pool di identità del workload: iam.workloadIdentityPools.updatePolicyBinding nel progetto proprietario del pool di identità del workload di destinazione
  • Ottenere lo stato di un'operazione a lunga esecuzione per la modifica di un'associazione che fa riferimento a un pool di identità del workload: iam.operations.get sul progetto proprietario del pool di identità del workload di destinazione
  • Modifica le associazioni delle policy per le policy sul confine di accesso dell'entità associate a un dominio Google Workspace: iam.workspacePools.updatePolicyBinding sull'organizzazione
  • Modifica le associazioni delle policy sul confine di accesso dell'entità associate al set di entità di un progetto: resourcemanager.projects.updatePolicyBinding sul progetto
  • Recupera lo stato di un'operazione a lunga esecuzione per la modifica di un'associazione che fa riferimento al set di entità di un progetto: iam.operations.get sul progetto
  • Modifica le associazioni delle policy per le policy sul confine di accesso dell'entità associate al set di entità di una cartella: resourcemanager.folders.updatePolicyBinding sulla cartella
  • Modifica le associazioni delle policy per le policy sul confine di accesso dell'entità associate al set di entità di un'organizzazione: resourcemanager.organizations.updatePolicyBinding sull'organizzazione

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Modifica una policy sul confine di accesso dell'entità esistente

Se vuoi aggiungere regole a una policy sul confine di accesso dell'entità, rimuovere regole da una policy sul confine di accesso dell'entità o modificare i metadati di una policy sul confine di accesso dell'entità, modifica la policy sul confine di accesso dell'entità.

Puoi modificare una policy dei confini di accesso delle entità utilizzando la console Google Cloud , gcloud CLI o l'API REST IAM.

Console

  1. Nella console Google Cloud , vai alla pagina Policy dei limiti di accesso delle entità.

    Vai alle policy di Principal Access Boundary

  2. Seleziona l'organizzazione proprietaria della policy sul confine di accesso dell'entità che vuoi modificare.

  3. Fai clic sull'ID della policy sul confine di accesso dell'entità che vuoi modificare.

  4. Fai clic su Modifica policy.

  5. Per modificare le regole della policy, segui questi passaggi:

    1. Fai clic sulla regola che vuoi modificare.
    2. Modifica la descrizione della regola o le risorse incluse nella regola.
    3. Fai clic su Fine.
  6. Per eliminare una regola dalla policy, fai clic su Elimina nella riga della regola.

  7. Per modificare il nome visualizzato della policy, modifica il campo Nome visualizzato.

  8. Per modificare la versione di applicazione della policy, fai clic sull'elenco Versione di applicazione e scegli un nuovo valore.

  9. (Facoltativo) Per testare le modifiche alla policy Principal Access Boundary con Policy Simulator, fai clic su Testa modifiche. Esamina i risultati della simulazione e aggiorna la policy, se necessario.

    Per scoprire di più sul test delle policy sul confine di accesso dell'entità con Policy Simulator, consulta Policy Simulator per le policy sul confine di accesso dell'entità.

  10. Fai clic su Salva.

gcloud

Il comando gcloud iam principal-access-boundary-policies update aggiorna una policy di Principal Access Boundary esistente.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • PAB_POLICY_ID: l'ID della policy dei confini di accesso dell'entità che vuoi aggiornare, ad esempio example-policy.
  • ORG_ID: l'ID dell'organizzazione proprietaria della policy dei confini di accesso dell'entità. Gli ID organizzazione sono numerici, ad esempio 123456789012.
  • FIELD_TO_UPDATE=UPDATED_VALUE: i campi che vuoi aggiornare e il valore aggiornato corrispondente.

    Di seguito sono riportati esempi di flag che puoi utilizzare per aggiornare i campi della policy:

    • --display-name=DISPLAY_NAME: sostituisci il nome visualizzato della policy con DISPLAY_NAME.
    • --details-enforcement-version=ENFORCEMENT_VERSION: aggiorna la versione di applicazione della policy impostandola su ENFORCEMENT_VERSION.
    • --details-rules=RULES_FILE.json: sostituisce le regole della policy di Principal Access Boundary con le regole in RULES_FILE.json. Per scoprire come formattare il file delle regole, consulta Crea una policy sul confine di accesso dell'entità.

      Se utilizzi questo flag, non puoi utilizzare il flag --add-details-rules.

    • --add-details-rules=RULES_FILE: aggiunge le regole in RULES_FILE.json alle regole esistenti della policy. Per scoprire come formattare il file delle regole, consulta Crea una policy sul confine di accesso dell'entità.

      Se utilizzi questo flag, non puoi utilizzare il flag --details-rules.

    • --remove-details-rules=RULES_FILE: rimuovi le regole in RULES_FILE.json dalle regole esistenti della policy. Per scoprire come formattare il file delle regole, consulta Crea una policy sul confine di accesso dell'entità. Vengono rimosse solo le regole che corrispondono esattamente a una delle regole in RULES_FILE.json.

      Se utilizzi questo flag, non puoi utilizzare il flag --clear-rule-details.

    • --clear-details-rules: cancella tutte le regole dalla policy sul confine di accesso dell'entità.

      Se utilizzi questo flag, non puoi utilizzare il flag --remove-rule-details.

    Per un elenco completo dei flag che puoi utilizzare per aggiornare una policy sui confini di accesso dell'entità, consulta il riferimento dei comandi gcloud iam principal-access-boundary-policies update.

  • FORMAT: il formato della risposta. Utilizza json o yaml.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam principal-access-boundary-policies update PAB_POLICY_ID \
    --organization=ORG_ID --location=global \
    --FIELD_TO_UPDATE=UPDATED_VALUE \
    --format=FORMAT

Windows (PowerShell)

gcloud iam principal-access-boundary-policies update PAB_POLICY_ID `
    --organization=ORG_ID --location=global `
    --FIELD_TO_UPDATE=UPDATED_VALUE `
    --format=FORMAT

Windows (cmd.exe)

gcloud iam principal-access-boundary-policies update PAB_POLICY_ID ^
    --organization=ORG_ID --location=global ^
    --FIELD_TO_UPDATE=UPDATED_VALUE ^
    --format=FORMAT

La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Al termine dell'operazione, la risposta stampa la policy dei limiti di accesso all'entità aggiornata.

Request issued for: [example-policy]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374208720-6181fae5e2034-2d8a712b-5c92e5b9] to complete...done.
Updated principalAccessBoundaryPolicy [example-policy].
{
  "name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
  "uid": "puid_13364150419245236225",
  "etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
  "displayName": "Updated display name",
  "createTime": "2024-05-07T00:05:48.295209Z",
  "updateTime": "2024-05-10T20:50:09.200421Z",
  "details": [
    "rules": {
      [
        "description": "Make principals eligible to access example.com"
        "resources": {
          "//cloudresourcemanager.googleapis.com/organizations/123456789012"
        },
        "effect": ALLOW
      ]
    },
    "enforcementVersion": "1"
  ]
}

REST

Il metodo principalAccessBoundaryPolicies.patch aggiorna una policy di Principal Access Boundary esistente.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • ORG_ID: l'ID dell'organizzazione proprietaria della policy dei confini di accesso dell'entità. Gli ID organizzazione sono numerici, ad esempio 123456789012.
  • PAB_POLICY_ID: l'ID della policy dei confini di accesso dell'entità che vuoi aggiornare, ad esempio example-policy.
  • FIELDS_TO_UPDATE: un elenco separato da virgole di campi che vuoi aggiornare. Se non specifichi i campi da aggiornare, IAM sostituisce la policy esistente con i contenuti del corpo della richiesta.

    I valori accettati sono displayName, details, details.rules, details.rules.description, details.rules.resources, details.rules.effect e details.enforcementVersion.

  • DISPLAY_NAME: (Facoltativo) Una descrizione leggibile della policy di Principal Access Boundary, ad esempio Example policy. Il nome visualizzato può contenere un massimo di 63 caratteri.
  • PAB_RULES: un elenco di regole del confine di accesso dell'entità, che definiscono le risorse a cui le entità interessate possono accedere. Una policy sul confine di accesso dell'entità può avere fino a 500 regole. Ogni regola ha il seguente formato:

    {
      "description": "DESCRIPTION",
      "resources": [
        RESOURCES
      ],
      "effect": "ALLOW"
    }

    Sostituisci i seguenti valori:

    • DESCRIPTION: (Facoltativo) La descrizione della regola della policy sul confine di accesso dell'entità. La descrizione può contenere un massimo di 256 caratteri.
    • RESOURCES: un elenco di risorse di Resource Manager (progetti, cartelle e organizzazioni) a cui vuoi che le entità possano accedere. Qualsiasi entità soggetta a questa policy è idonea ad accedere a queste risorse.

      Ogni policy di Principal Access Boundary può fare riferimento a un massimo di 500 risorse in tutte le regole della policy.

  • ENFORCEMENT_VERSION: la versione delle policy sul confine di accesso dell'entità utilizzata da IAM quando applica la policy. La versione di applicazione determina per quali autorizzazioni IAM applica la policy sul confine di accesso dell'entità.

    I valori accettati sono 1, 2, 3, 4 e latest.

    Per saperne di più su come impostare e gestire le versioni di applicazione, consulta Gestione delle versioni di applicazione.

Metodo HTTP e URL:

PATCH https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID?updateMask=FIELDS_TO_UPDATE

Corpo JSON della richiesta:

{
  "displayName": DISPLAY_NAME,
  "details": {
    "rules": [
      PAB_RULES
    ],
    "enforcementVersion": "ENFORCEMENT_VERSION",
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Per scoprire come ottenere lo stato di un'operazione a lunga esecuzione, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715626721931-6185a7953ef76-76f80ee4-19cd1bf7",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-05-13T18:58:43.721277235Z",
    "target": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

Modifica i soggetti a cui viene applicata una policy sul confine di accesso dell'entità

Dopo aver creato un'associazione delle policy per una policy di Principal Access Boundary, non puoi modificare l'ID della policy o il set di entità nell'associazione. Di conseguenza, se vuoi modificare i soggetti a cui viene applicata una policy di Principal Access Boundary, devi eseguire una delle seguenti operazioni:

  • Per perfezionare l'insieme di entità a cui viene applicata una policy di Principal Access Boundary, puoi modificare le condizioni nell'associazione della policy. Per modificare le condizioni di un'associazione, modifica l'associazione della policy.
  • Per applicare la policy sul confine di accesso dell'entità a un set di entità aggiuntivo, crea una nuova associazione delle policy che associa la policy al set di entità.
  • Per rimuovere una policy sul confine di accesso dell'entità da un set di entità, elimina l'associazione della policy che associa la policy al set di entità.

Modifica le associazioni delle policy esistenti per le policy sul confine di accesso dell'entità

Dopo aver creato un'associazione delle policy, puoi modificarla per cambiare le condizioni o il nome visualizzato.

Puoi modificare un'associazione delle policy utilizzando la console Google Cloud , gcloud CLI o l'API REST IAM.

Console

  1. Nella console Google Cloud , vai alla pagina Policy dei limiti di accesso delle entità.

    Vai alle policy di Principal Access Boundary

  2. Seleziona l'organizzazione proprietaria della policy sul confine di accesso dell'entità che vuoi modificare.

  3. Fai clic sull'ID della policy sul confine di accesso dell'entità di cui vuoi modificare le associazioni.

  4. Fai clic sulla scheda Associazioni.

  5. Trova l'ID dell'associazione che vuoi modificare. Nella riga dell'associazione, fai clic su Azioni, quindi su Modifica associazione.

  6. Per aggiornare il nome visualizzato dell'associazione, modifica il campo Nome visualizzato.

  7. Per aggiungere una condizione all'associazione, segui questi passaggi:

    1. Fai clic su Aggiungi condizione.
    2. Nel campo Titolo, inserisci un breve riepilogo dello scopo della condizione.
    3. (Facoltativo) Nel campo Descrizione, inserisci una descrizione più lunga della condizione.
    4. Nel campo Espressione, inserisci un'espressione di condizione che utilizza la sintassi Common Expression Language (CEL). L'espressione deve fare riferimento agli attributi principal.type o principal.subject. Gli altri attributi non sono supportati.
    5. Fai clic su Salva.
  8. Per aggiornare una condizione esistente:

    1. Fai clic su Modifica condizione accanto al nome della condizione.
    2. Aggiorna il titolo, la descrizione o l'espressione della condizione.
    3. Fai clic su Salva.
  9. (Facoltativo) Per testare le modifiche all'associazione delle policy dei limiti di accesso delle entità con Policy Simulator, fai clic su Testa modifiche. Esamina i risultati della simulazione e aggiorna l'associazione della policy, se necessario.

    Per scoprire di più sul test delle policy sul confine di accesso dell'entità con Policy Simulator, consulta Policy Simulator per le policy sul confine di accesso dell'entità.

  10. Per salvare le modifiche, fai clic su Salva.

gcloud

Il comando gcloud iam policy-bindings update aggiorna un'associazione di policy esistente.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • BINDING_ID: l'ID dell'associazione delle policy che vuoi aggiornare, ad esempio example-binding.
  • RESOURCE_TYPE: il tipo di risorsa di Resource Manager (progetto, cartella o organizzazione) di cui l'associazione della policy è un elemento secondario. Utilizza il valore project, folder o organization.

    Il tipo di risorsa dipende dall'entità impostata nell'associazione della policy. Per capire quale tipo di risorsa utilizzare, consulta Tipi di entità supportati.

  • RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione di cui l'associazione delle policy è un elemento secondario. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio 123456789012.
  • FIELD_TO_UPDATE=UPDATED_VALUE: i campi che vuoi aggiornare e il valore aggiornato corrispondente.

    Di seguito sono riportati esempi di flag che puoi utilizzare per aggiornare i campi in un'associazione delle policy:

    • --display-name=DISPLAY_NAME: sostituisci il nome visualizzato dell'associazione con DISPLAY_NAME.
    • --condition-description=CONDITION_DESCRIPTION: se l'associazione ha una condizione, sostituisci la descrizione della condizione con CONDITION_DESCRIPTION. In caso contrario, aggiungi una nuova condizione all'associazione con la descrizione specificata. Se utilizzi questo flag per aggiornare un'associazione che non ha una condizione, devi impostare anche il flag --condition-expression.
    • --condition-expression=CONDITION_EXPRESSION: se l'associazione ha una condizione, sostituisci l'espressione della condizione con CONDITION_EXPRESSION. In caso contrario, aggiungi una nuova condizione all'associazione con l'espressione specificata.
    • --condition-title=CONDITION_TITLE: se l'associazione ha una condizione, sostituisci il titolo della condizione con CONDITION_TITLE. In caso contrario, aggiungi una nuova condizione all'associazione con il titolo specificato. Se utilizzi questo flag per aggiornare un'associazione che non ha una condizione, devi impostare anche il flag --condition-expression.

    Per un elenco completo dei campi che puoi aggiornare, consulta il riferimento del comando gcloud iam policy-bindings update.

  • FORMAT: il formato della risposta. Utilizza json o yaml.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam policy-bindings update BINDING_ID \
    --RESOURCE_TYPE=RESOURCE_ID --location=global \
    --FIELD_TO_UPDATE=UPDATED_VALUE \
    --format=FORMAT

Windows (PowerShell)

gcloud iam policy-bindings update BINDING_ID `
    --RESOURCE_TYPE=RESOURCE_ID --location=global `
    --FIELD_TO_UPDATE=UPDATED_VALUE `
    --format=FORMAT

Windows (cmd.exe)

gcloud iam policy-bindings update BINDING_ID ^
    --RESOURCE_TYPE=RESOURCE_ID --location=global ^
    --FIELD_TO_UPDATE=UPDATED_VALUE ^
    --format=FORMAT

La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Per scoprire come ottenere lo stato di un'operazione a lunga esecuzione, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.

Update request issued for: [example-binding]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374545618-6181fc272c6f9-55ff07f4-97d0ac76] to complete...done.
Updated policyBinding [example-binding].
{
  "createTime": "2024-05-06T18:08:24.729843Z",
  "displayName": "Updated display name",
  "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
  "name": "organizations/123456789012/locations/global/policyBindings/example-binding",
  "policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
  "policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
  "policyUid": "puid_9519202237377675265",
  "target": {
    "principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
  },
  "uid": "buid_9904260005517852673", 
  "updateTime": "2024-05-06T18:11:16.798841Z"
}

REST

Il metodo policyBindings.patch aggiorna un'associazione di policy esistente.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • RESOURCE_TYPE: il tipo di risorsa di Resource Manager (progetto, cartella o organizzazione) di cui l'associazione della policy è un elemento secondario. Utilizza il valore projects, folders o organizations.

    Il tipo di risorsa dipende dall'entità impostata nell'associazione della policy. Per capire quale tipo di risorsa utilizzare, consulta Tipi di entità supportati.

  • RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione di cui l'associazione delle policy è un elemento secondario. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio 123456789012.
  • BINDING_ID: l'ID dell'associazione delle policy che vuoi aggiornare, ad esempio example-binding.
  • FIELDS_TO_UPDATE: un elenco separato da virgole di campi che vuoi aggiornare. Se non specifichi i campi da aggiornare, IAM sostituisce l'associazione esistente con il contenuto del corpo della richiesta.

    I valori accettati sono displayName, condition, condition.expression, condition.title e condition.description.

  • DISPLAY_NAME: (Facoltativo) Una descrizione dell'associazione leggibile da una persona, ad esempio Example binding. Il nome visualizzato può contenere un massimo di 63 caratteri.
  • CONDITION_DETAILS: (Facoltativo) Un'espressione di condizione che specifica per quali entità nel set di entità viene applicata la policy sul confine di accesso dell'entità. Contiene i seguenti campi:

    • expression: un'espressione di condizione che utilizza la sintassi Common Expression Language (CEL). L'espressione deve fare riferimento agli attributi principal.type o principal.subject. Gli altri attributi non sono supportati.

      L'espressione può contenere fino a 10 operatori logici (&&, ||, !) e può avere una lunghezza massima di 250 caratteri.

    • title: (Facoltativo) Un breve riepilogo dello scopo della condizione.
    • description: (Facoltativo) Una descrizione più lunga della condizione.

Metodo HTTP e URL:

PATCH https://iam.googleapis.com/v3/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings/BINDING_ID?updateMask=FIELDS_TO_UPDATE

Corpo JSON della richiesta:

{
  "displayName": "DISPLAY_NAME",
  "condition": {
    CONDITION_DETAILS
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Per scoprire come ottenere lo stato di un'operazione a lunga esecuzione, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715373159010-6181f6fcccfa7-dcd0055c-00c22cad",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-05-10T20:32:39.254910121Z",
    "target": "organizations/123456789012/locations/global/policyBindings/example-binding",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

Controlla lo stato di un'operazione a lunga esecuzione

Quando utilizzi l'API REST o le librerie client, qualsiasi metodo che modifica una policy o un'associazione restituisce un'operazione a lunga esecuzione (LRO). L'operazione a lunga esecuzione monitora lo stato della richiesta e indica se la modifica della policy o dell'associazione è stata completata.

REST

Il metodo operations.get restituisce lo stato di un'operazione a lunga esecuzione.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • OPERATION_NAME: il nome completo dell'operazione. Ricevi questo nome nella risposta alla tua richiesta originale.

    Il nome dell'operazione ha il seguente formato:

    RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
        

Metodo HTTP e URL:

GET https://iam.googleapis.com/v3/OPERATION_NAME

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "organizations/314340013352/locations/global/operations/operation-1732752311821-627edd607a3df-9a62cdea-2a7d9f07",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-11-28T00:05:12.006289686Z",
    "endTime": "2024-11-28T00:05:12.192141801Z",
    "target": "organizations/314340013352/locations/global/POLICY_TYPE/POLICY_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": true,
  "response": {
    POLICY
  }
}

Se il campo done dell'operazione non è presente, continua a monitorare lo stato recuperando ripetutamente l'operazione. Utilizza il backoff esponenziale troncato per introdurre un ritardo tra ogni richiesta. Quando il campo done è impostato su true, l'operazione è completata e puoi interrompere il recupero dell'operazione.

Passaggi successivi