Crea e applica policy Unified Access Policies

Le Unified Access Policies (UAP) ti consentono di concedere e negare alle entità l'accesso alle risorseGoogle Cloud . Questo documento spiega come creare e applicare le UAP.

Prima di iniziare

  1. Configurare l'autenticazione.

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

    Console

    Quando utilizzi la console Google Cloud per accedere ai servizi e alle API Google Cloud , non devi configurare l'autenticazione.

    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 .

  2. Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud .

  3. (Facoltativo) Leggi la panoramica delle UAP.

Ruoli richiesti per creare Unified Access Policies

Per ottenere le autorizzazioni necessarie per creare policy di accesso utente, chiedi all'amministratore di concederti il ruolo IAM Amministratore policy di accesso (roles/iam.accessPolicyAdmin) nel progetto, nella cartella o nell'organizzazione in cui vuoi creare la policy. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare i criteri di accesso degli utenti. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare UAP sono necessarie le seguenti autorizzazioni:

  • iam.accesspolicies.create
  • Crea UAP nella console Google Cloud : iam.accesspolicies.list

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

Ruoli richiesti per applicare le Unified Access Policies

Per ottenere le autorizzazioni necessarie per associare un UAP a una risorsa, chiedi all'amministratore di concederti i seguenti ruoli IAM:

  • Amministratore delle policy di accesso (roles/iam.accessPolicyAdmin) sulla risorsa proprietaria della UAP. Questo ruolo contiene l'autorizzazione iam.accesspolicies.bind, necessaria per creare associazioni.
  • Un ruolo che include l'autorizzazione SERVICE.RESOURCE.createPolicyBinding, dove RESOURCE è il tipo di risorsa a cui vuoi associare la policy e SERVICE è il servizio proprietario della risorsa.

    Per trovare un ruolo che includa l'autorizzazione richiesta, cerca l'autorizzazione nel riferimento per ruoli e autorizzazioni, fai clic sul nome dell'autorizzazione, quindi esamina i ruoli che includono l'autorizzazione.

    Devi avere questo ruolo sulla risorsa o su uno dei suoi predecessori.

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

Crea una Unified Access Policy

Puoi creare UAP utilizzando la console Google Cloud , gcloud CLI o l'API REST IAM.

Console

  1. Nella console Google Cloud , vai alla pagina Policy di accesso unificato.

    Vai a Policy di accesso unificato
  2. Seleziona il progetto, la cartella o l'organizzazione in cui vuoi creare la UAP. Per indicazioni su dove creare un UAP, consulta Dove creare UAP.
  3. Fai clic su Crea policy.
  4. Nel campo Nome policy, inserisci un nome per la policy di accesso uniforme, ad esempio Example policy. Il nome può contenere un massimo di 63 caratteri.
  5. (Facoltativo) Nel campo ID policy, personalizza l'ID per la policy di accesso utente.
  6. Aggiungi regole alla policy. Per ogni regola, segui questi passaggi:

    1. (Facoltativo) Nel campo Descrizione, inserisci una descrizione della regola.
    2. Nel campo Entità, inserisci le entità che vuoi includere nella regola.
    3. (Facoltativo) Nel campo Entità escluse, inserisci le entità che non vuoi includere nella regola. Queste entità non verranno incluse, anche se fanno parte di un gruppo nel campo Entità.
    4. Seleziona l'effetto che vuoi che abbia la regola:

      • Per concedere le autorizzazioni specificate alle entità specificate, seleziona l'effetto Consenti.
      • Per impedire alle entità specificate di utilizzare le autorizzazioni specificate, seleziona l'effetto Nega.
    5. Seleziona le autorizzazioni da includere nella regola:

      • Per le regole con l'effetto Consenti, puoi specificare i ruoli e le autorizzazioni da includere o escludere dalla regola. Per saperne di più sui ruoli e sulle autorizzazioni che puoi includere, consulta Ruoli e autorizzazioni nelle regole UAP.
      • Per le regole con l'effetto Nega, specifica le autorizzazioni che vuoi includere o escludere dalla regola. Per saperne di più sulle autorizzazioni che puoi includere, consulta Ruoli e autorizzazioni nelle regole UAP.
    6. (Facoltativo) Aggiungi le condizioni in base alle quali viene applicata la regola. Per saperne di più sugli attributi delle condizioni supportati, consulta Condizioni nelle UAP.

    7. Al termine della modifica della regola, fai clic su Fine.
  7. Per aggiungere un'altra regola, fai clic su Aggiungi regola e poi aggiungi i dettagli della regola.
  8. Al termine dell'aggiunta delle regole per gli annunci, fai clic su Crea policy.

gcloud

Il comando gcloud iam access-policies create crea un UAP.

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

  • UAP_ID: un ID univoco per la UAP, ad esempio example-policy.
  • UAP_PARENT_RESOURCE_TYPE: il tipo di risorsa Resource Manager (progetto, cartella o organizzazione) in cui vuoi creare l'UAP. Utilizza il valore project, folder o organization.
  • UAP_PARENT_RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione in cui vuoi creare l'UAP. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio 123456789012.
  • DISPLAY_NAME: (Facoltativo) Una descrizione della policy di accesso utente leggibile da una persona, ad esempio Example policy. Il nome visualizzato può contenere un massimo di 63 caratteri.
  • FILE_PATH: Il percorso di un file JSON contenente i dettagli della regola UAP. Ogni regola deve avere il seguente formato:

    {
      "description": "DESCRIPTION",
      "effect": "EFFECT",
      "principals": [
        INCLUDED_PRINCIPALS
      ],
      "excludedPrincipals": [
        EXCLUDED_PRINCIPALS
      ],
      "operation": {
        "permissions": [
          INCLUDED_PERMISSIONS
        ],
        "excludedPermissions": [
          EXCLUDED_PERMISSIONS
        ]
      },
      CONDITIONS
    }

    Sostituisci i seguenti valori:

    • DESCRIPTION: una descrizione della regola leggibile da una persona.
    • EFFECT: l'impatto della regola sull'accesso. I valori supportati sono ALLOW e DENY:

      • ALLOW: concede le autorizzazioni specificate alle entità specificate.
      • DENY: impedisce alle entità specificate di utilizzare le autorizzazioni specificate.
    • Sostituisci i seguenti valori per specificare le entità incluse nella regola:

      • INCLUDED_PRINCIPALS: le entità da includere nella regola.
      • EXCLUDED_PRINCIPALS: (Facoltativo) Le entità da escludere dalla regola, anche se sono presenti nell'elenco delle entità incluse. Ad esempio, puoi aggiungere un gruppo Google all'elenco delle entità incluse, quindi escludere utenti specifici che appartengono a quel gruppo.

      Per un elenco degli identificatori delle entità supportati, consulta Tipi di entità per le UAP.

    • Sostituisci i seguenti valori per specificare le autorizzazioni da includere nella regola:

      • INCLUDED_PERMISSIONS: le autorizzazioni da includere nella regola.
      • EXCLUDED_PERMISSIONS: (Facoltativo) Le autorizzazioni da escludere dalla regola, anche se sono presenti nell'elenco delle autorizzazioni incluse. Ad esempio, puoi aggiungere un ruolo all'elenco delle autorizzazioni incluse, quindi escludere autorizzazioni specifiche in quel ruolo.

      Quando crei questi elenchi di autorizzazioni, puoi fare riferimento ai nomi delle autorizzazioni, ai nomi dei ruoli e ai gruppi di autorizzazioni. Per scoprire di più, consulta Ruoli e autorizzazioni nelle regole UAP.

    • CONDITIONS: (Facoltativo) Le condizioni in base alle quali viene applicata la regola. Utilizza il formato seguente:

      "conditions": {
        "SERVICE": {
          "title": "CONDITION_TITLE",
          "description": "CONDITION_DESCRIPTION",
          "expression": "CONDITION_EXPRESSION"
        }
      }
          

      Sostituisci i seguenti valori:

      • SERVICE: il servizio che fornisce gli attributi utilizzati nell'espressione della condizione.
      • CONDITION_TITLE: (Facoltativo) Un breve riepilogo dello scopo della condizione.
      • CONDITION_DESCRIPTION: (Facoltativo) Una descrizione più lunga della condizione.
      • CONDITION_EXPRESSION: un'espressione booleana che fa riferimento agli attributi del tentativo di accesso, ad esempio i tag associati alla risorsa nel tentativo di accesso. Se l'espressione restituisce true, la regola viene applicata al tentativo di accesso. Se restituisce false, la regola non viene applicata al tentativo di accesso.

      Per un elenco degli attributi di supporto e dei relativi servizi, consulta Attributi di supporto supportati.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam access-policies create UAP_ID \
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \
    --location=global --display-name=DISPLAY_NAME \
    --details-rules=FILE_PATH

Windows (PowerShell)

gcloud iam access-policies create UAP_ID `
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID `
    --location=global --display-name=DISPLAY_NAME `
    --details-rules=FILE_PATH

Windows (cmd.exe)

gcloud iam access-policies create UAP_ID ^
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^
    --location=global --display-name=DISPLAY_NAME ^
    --details-rules=FILE_PATH

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.

Create request issued for: [example-policy]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715373988044-6181fa136df85-3b06a30a-4816d25b] to complete...done.
Created accessPolicy [example-policy].

REST

Il metodo accessPolicies.create crea un UAP.

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

  • UAP_PARENT_RESOURCE_TYPE: il tipo di risorsa Resource Manager (progetto, cartella o organizzazione) in cui vuoi creare l'UAP. Utilizza il valore projects, folders o organizations.
  • UAP_PARENT_RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione in cui vuoi creare l'UAP. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio 123456789012.
  • UAP_ID: un ID univoco per la UAP, ad esempio example-policy.
  • DISPLAY_NAME: (Facoltativo) Una descrizione della policy di accesso utente leggibile da una persona, ad esempio Example policy. Il nome visualizzato può contenere un massimo di 63 caratteri.
  • UAP_RULES: un elenco di regole UAP, che definiscono l'accesso da concedere o negare e le entità a cui concedere o negare l'accesso. Un UAP può avere fino a 100 regole. Ogni regola ha il seguente formato:

    {
      "description": "DESCRIPTION",
      "effect": "EFFECT",
      "principals": [
        INCLUDED_PRINCIPALS
      ],
      "excludedPrincipals": [
        EXCLUDED_PRINCIPALS
      ],
      "operation": {
        "permissions": [
          INCLUDED_PERMISSIONS
        ],
        "excludedPermissions": [
          EXCLUDED_PERMISSIONS
        ]
      },
      CONDITIONS
    }

    Sostituisci i seguenti valori:

    • DESCRIPTION: una descrizione della regola leggibile da una persona.
    • EFFECT: l'impatto della regola sull'accesso. I valori supportati sono ALLOW e DENY:

      • ALLOW: concede le autorizzazioni specificate alle entità specificate.
      • DENY: impedisce alle entità specificate di utilizzare le autorizzazioni specificate.
    • Sostituisci i seguenti valori per specificare le entità incluse nella regola:

      • INCLUDED_PRINCIPALS: le entità da includere nella regola.
      • EXCLUDED_PRINCIPALS: (Facoltativo) Le entità da escludere dalla regola, anche se sono presenti nell'elenco delle entità incluse. Ad esempio, puoi aggiungere un gruppo Google all'elenco delle entità incluse, quindi escludere utenti specifici che appartengono a quel gruppo.

      Per un elenco degli identificatori delle entità supportati, consulta Tipi di entità per le UAP.

    • Sostituisci i seguenti valori per specificare le autorizzazioni da includere nella regola:

      • INCLUDED_PERMISSIONS: le autorizzazioni da includere nella regola.
      • EXCLUDED_PERMISSIONS: (Facoltativo) Le autorizzazioni da escludere dalla regola, anche se sono presenti nell'elenco delle autorizzazioni incluse. Ad esempio, puoi aggiungere un ruolo all'elenco delle autorizzazioni incluse, quindi escludere autorizzazioni specifiche in quel ruolo.

      Quando crei questi elenchi di autorizzazioni, puoi fare riferimento ai nomi delle autorizzazioni, ai nomi dei ruoli e ai gruppi di autorizzazioni. Per scoprire di più, consulta Ruoli e autorizzazioni nelle regole UAP.

    • CONDITIONS: (Facoltativo) Le condizioni in base alle quali viene applicata la regola. Utilizza il formato seguente:

      "conditions": {
        "SERVICE": {
          "title": "CONDITION_TITLE",
          "description": "CONDITION_DESCRIPTION",
          "expression": "CONDITION_EXPRESSION"
        }
      }
          

      Sostituisci i seguenti valori:

      • SERVICE: il servizio che fornisce gli attributi utilizzati nell'espressione della condizione.
      • CONDITION_TITLE: (Facoltativo) Un breve riepilogo dello scopo della condizione.
      • CONDITION_DESCRIPTION: (Facoltativo) Una descrizione più lunga della condizione.
      • CONDITION_EXPRESSION: un'espressione booleana che fa riferimento agli attributi del tentativo di accesso, ad esempio i tag associati alla risorsa nel tentativo di accesso. Se l'espressione restituisce true, la regola viene applicata al tentativo di accesso. Se restituisce false, la regola non viene applicata al tentativo di accesso.

      Per un elenco degli attributi di supporto e dei relativi servizi, consulta Attributi di supporto supportati.

Metodo HTTP e URL:

POST https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies?accessPolicyId=UAP_ID

Corpo JSON della richiesta:

{
  "displayName": "DISPLAY_NAME",
  "details": {
    "rules": [
      UAP_RULES
    ]
  }
}

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-1715373120647-6181f6d8371d2-83309b71-2b8a7532",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2026-05-10T20:32:00.898809495Z",
    "target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

Applica una policy Unified Access Policies a una risorsa

Per applicare una policy di accesso utente a una risorsa, devi creare un'associazione. Dopo aver creato un'associazione per una policy, le regole della policy diventano effettive per la risorsa specificata e per tutti i suoi discendenti.

Prima di creare un'associazione, assicurati che il vincolo della policy dell'organizzazione iam.managed.disableAccessPolicyBinding sia disattivato. Per scoprire come attivare o disattivare questo vincolo, consulta Utilizzo dei vincoli gestiti in una policy dell'organizzazione.

Puoi applicare le policy di accesso utente a progetti, cartelle e organizzazioni utilizzando la console Google Cloud , gcloud CLI o l'API REST IAM. Per applicare le policy di accesso degli utenti ad altre risorse, devi utilizzare gcloud CLI o l'API REST IAM.

Console

  1. Nella console Google Cloud , vai alla pagina Policy di accesso unificato.

    Vai a Policy di accesso unificato
  2. Seleziona il progetto, la cartella o l'organizzazione proprietaria della UAP che vuoi applicare.
  3. Fai clic sull'ID della UAP che vuoi applicare.
  4. Seleziona la scheda Associazioni, quindi fai clic su Aggiungi associazione.
  5. Nel riquadro Aggiungi associazione, modifica i dettagli dell'associazione:

    1. Nel menu Località di associazione, seleziona la risorsa a cui vuoi applicare la UAP.
    2. (Facoltativo) Nel campo Nome visualizzato dell'associazione, inserisci una descrizione leggibile dell'associazione, ad esempio Example binding. Il nome visualizzato può contenere un massimo di 63 caratteri.
    3. Nel campo ID associazione, inserisci un nome univoco per l'associazione, ad esempio example-binding.
  6. Fai clic su Aggiungi associazione.

gcloud

Il comando gcloud iam policy-bindings create crea un'associazione.

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

  • BINDING_ID: un nome univoco per l'associazione, ad esempio example-binding.
  • BINDING_PARENT_RESOURCE_TYPE: il tipo di risorsa Resource Manager (progetto, cartella o organizzazione) di cui l'associazione è un elemento secondario. Utilizza il valore project, folder o organization.

    La risorsa padre dell'associazione dipende dalla risorsa di destinazione nell'associazione. Per ulteriori informazioni, consulta Risorse supportate.

  • BINDING_PARENT_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.
  • POLICY_PARENT_RESOURCE: la risorsa in cui è stato creato l'UAP, nel formato RESOURCE_TYPE/RESOURCE_ID. Ad esempio organizations/0123456789012. Le policy di accesso utente possono essere create in progetti, cartelle o organizzazioni. Gli ID cartella e ID organizzazione devono essere numerici. Gli ID progetto possono essere numerici o alfanumerici.
  • UAP_ID: l'ID della UAP che vuoi associare alla risorsa, ad esempio example-uap. Non puoi modificare questo valore dopo aver creato l'associazione.
  • TARGET_RESOURCE: la risorsa a cui vuoi associare l'UAP. Per un elenco delle risorse valide, consulta Risorse supportate. Non puoi modificare questo valore dopo aver creato l'associazione.
  • 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.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam policy-bindings create BINDING_ID \
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global \
    --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" \
    --target-resource=TARGET_RESOURCE \
    --display-name=DISPLAY_NAME

Windows (PowerShell)

gcloud iam policy-bindings create BINDING_ID `
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global `
    --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" `
    --target-resource=TARGET_RESOURCE `
    --display-name=DISPLAY_NAME

Windows (cmd.exe)

gcloud iam policy-bindings create BINDING_ID ^
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global ^
    --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" ^
    --target-resource=TARGET_RESOURCE ^
    --display-name=DISPLAY_NAME

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.

Create request issued for: [example-binding]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374545618-6181fc272c6f9-55ff07f4-97d0ac76] to complete...done.
Created policyBinding [example-binding].

REST

Il metodo policyBindings.create crea un'associazione.

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

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

    La risorsa padre dell'associazione dipende dalla risorsa di destinazione nell'associazione. Per ulteriori informazioni, consulta Risorse supportate.

  • BINDING_PARENT_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: un nome univoco per l'associazione, ad esempio example-binding.
  • 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.
  • TARGET_RESOURCE: la risorsa a cui vuoi associare la UAP. Per un elenco delle risorse valide, consulta Risorse supportate. Non puoi modificare questo valore dopo aver creato l'associazione.
  • POLICY_PARENT_RESOURCE: la risorsa in cui è stato creato l'UAP, nel formato RESOURCE_TYPE/RESOURCE_ID. Ad esempio organizations/0123456789012. Le policy di accesso utente possono essere create in progetti, cartelle o organizzazioni. Gli ID cartella e ID organizzazione devono essere numerici. Gli ID progetto possono essere numerici o alfanumerici.
  • UAP_ID: l'ID della UAP che vuoi associare alla risorsa, ad esempio example-uap. Non puoi modificare questo valore dopo aver creato l'associazione.

Metodo HTTP e URL:

POST https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings?policyBindingId=BINDING_ID

Corpo JSON della richiesta:

{
  "displayName": "DISPLAY_NAME",
  "target": {
    "resource": "TARGET_RESOURCE"
  },
  "policyKind": "ACCESS",
  "policy": "POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID"
}

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-1715373120647-6181f6d8371d2-83309b71-2b8a7532",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2026-05-10T20:32:00.898809495Z",
    "target": "organizations/123456789012/locations/global/policyBindings/example-binding",
    "verb": "create",
    "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