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
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.
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 .
-
Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud .
(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'autorizzazioneiam.accesspolicies.bind, necessaria per creare associazioni. Un ruolo che include l'autorizzazione
SERVICE.RESOURCE.createPolicyBinding, doveRESOURCEè il tipo di risorsa a cui vuoi associare la policy eSERVICEè 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
-
Nella console Google Cloud , vai alla pagina Policy di accesso unificato.
Vai a Policy di accesso unificato - 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.
- Fai clic su Crea policy.
-
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. - (Facoltativo) Nel campo ID policy, personalizza l'ID per la policy di accesso utente.
-
Aggiungi regole alla policy. Per ogni regola, segui questi passaggi:
- (Facoltativo) Nel campo Descrizione, inserisci una descrizione della regola.
- Nel campo Entità, inserisci le entità che vuoi includere nella regola.
- (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à.
-
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.
-
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.
-
(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.
- Al termine della modifica della regola, fai clic su Fine.
- Per aggiungere un'altra regola, fai clic su Aggiungi regola e poi aggiungi i dettagli della regola.
- 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 esempioexample-policy. -
UAP_PARENT_RESOURCE_TYPE: il tipo di risorsa Resource Manager (progetto, cartella o organizzazione) in cui vuoi creare l'UAP. Utilizza il valoreproject,folderoorganization. -
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, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio123456789012. DISPLAY_NAME: (Facoltativo) Una descrizione della policy di accesso utente leggibile da una persona, ad esempioExample 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 sonoALLOWeDENY:-
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 restituiscetrue, la regola viene applicata al tentativo di accesso. Se restituiscefalse, 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 valoreprojects,foldersoorganizations. -
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, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio123456789012. -
UAP_ID: un ID univoco per la UAP, ad esempioexample-policy. DISPLAY_NAME: (Facoltativo) Una descrizione della policy di accesso utente leggibile da una persona, ad esempioExample 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 sonoALLOWeDENY:-
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 restituiscetrue, la regola viene applicata al tentativo di accesso. Se restituiscefalse, 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
-
Nella console Google Cloud , vai alla pagina Policy di accesso unificato.
Vai a Policy di accesso unificato - Seleziona il progetto, la cartella o l'organizzazione proprietaria della UAP che vuoi applicare.
- Fai clic sull'ID della UAP che vuoi applicare.
- Seleziona la scheda Associazioni, quindi fai clic su Aggiungi associazione.
-
Nel riquadro Aggiungi associazione, modifica i dettagli dell'associazione:
- Nel menu Località di associazione, seleziona la risorsa a cui vuoi applicare la UAP.
-
(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. -
Nel campo ID associazione, inserisci un nome univoco per l'associazione, ad esempio
example-binding.
- 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 esempioexample-binding. -
BINDING_PARENT_RESOURCE_TYPE: il tipo di risorsa Resource Manager (progetto, cartella o organizzazione) di cui l'associazione è un elemento secondario. Utilizza il valoreproject,folderoorganization.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, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio123456789012. -
POLICY_PARENT_RESOURCE: la risorsa in cui è stato creato l'UAP, nel formatoRESOURCE_TYPE/RESOURCE_ID. Ad esempioorganizations/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 esempioexample-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 esempioExample 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 valoreprojects,foldersoorganizations.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, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio123456789012. -
BINDING_ID: un nome univoco per l'associazione, ad esempioexample-binding. DISPLAY_NAME: (Facoltativo) Una descrizione dell'associazione leggibile da una persona, ad esempioExample 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 formatoRESOURCE_TYPE/RESOURCE_ID. Ad esempioorganizations/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 esempioexample-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
- Visualizza le associazioni e le policy di accesso degli utenti
- Modifica le policy di accesso degli utenti e le associazioni
- Rimuovi gli UAP