Le policy sul confine di accesso dell'entità (PAB) ti consentono di limitare le risorse a cui un set di entità può accedere. In questa pagina viene spiegato come creare e applicare le policy sul confine di accesso dell'entità.
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 .
Leggi la panoramica delle policy sul confine di accesso dell'entità.
Ruoli richiesti per creare policy sul confine di accesso dell'entità
Per ottenere l'autorizzazione necessaria per creare 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.create, necessaria per creare policy sul confine di accesso dell'entità.
Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.
Ruoli richiesti per applicare le policy sul confine di accesso dell'entità
Le autorizzazioni necessarie per applicare una policy sul confine di accesso dell'entità dipendono dal set di entità a cui vuoi applicare la policy.
Per ottenere le autorizzazioni necessarie per applicare le policy sul confine di accesso dell'entità, chiedi all'amministratore di concederti i seguenti ruoli IAM:
- Confine di accesso dell'entità principale Utente (
roles/iam.principalAccessBoundaryUser) sull'organizzazione -
Applicare le policy sul confine di accesso dell'entità ai pool di identità della forza lavoro:
IAM Workforce Pool Admin (
roles/iam.workforcePoolAdmin) sul pool di identità della forza lavoro di destinazione -
Applica le policy sul confine di accesso dell'entità ai pool di identità del workload:
IAM Workload Identity Pool Admin (
roles/iam.workloadIdentityPoolAdmin) sul progetto proprietario del pool di federazione delle identità per i workload di destinazione -
Ottenere lo stato di un'operazione a lunga esecuzione per l'applicazione di una policy Principal Access Boundary a un pool di identità del workload:
IAM Operation Viewer (
roles/iam.operationViewer) sul progetto proprietario del pool di identità del workload di destinazione -
Applicare policy sul confine di accesso dell'entità a un dominio Google Workspace:
Workspace Pool IAM Admin (
roles/iam.workspacePoolAdmin) sull'organizzazione -
Applicare le policy sul confine di accesso dell'entità al set di entità di un progetto:
Project IAM Admin (
roles/resourcemanager.projectIamAdmin) sul progetto -
Ottieni lo stato di un'operazione a lunga esecuzione per l'applicazione di una policy Principal Access Boundary al set di entità di un progetto:
IAM Operation Viewer (
roles/iam.operationViewer) sul progetto -
Applica le policy sul confine di accesso dell'entità al set di entità di una cartella:
Folder IAM Admin (
roles/resourcemanager.folderIamAdmin) sulla cartella -
Applicare le policy sul confine di accesso dell'entità 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 applicare le policy sul confine di accesso dell'entità. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per applicare le policy sul confine di accesso dell'entità, sono necessarie le seguenti autorizzazioni:
-
iam.principalaccessboundarypolicies.bindsull'organizzazione -
Applica le policy sul confine di accesso dell'entità ai pool di federazione delle identità per la forza lavoro:
iam.workforcePools.createPolicyBindingsul pool di federazione delle identità per la forza lavoro di destinazione -
Applica le policy sul confine di accesso dell'entità ai pool di federazione delle identità per i workload:
iam.workloadIdentityPools.createPolicyBindingsul progetto proprietario del pool di federazione delle identità per i workload di destinazione -
Ottieni lo stato di un'operazione a lunga esecuzione per l'applicazione di una policy Principal Access Boundary a un pool di identità del workload:
iam.operations.getsul progetto proprietario del pool di identità del workload di destinazione -
Applica le policy sul confine di accesso dell'entità a un dominio Google Workspace:
iam.workspacePools.createPolicyBindingnell'organizzazione -
Applica le policy sul confine di accesso dell'entità al set di entità di un progetto:
resourcemanager.projects.createPolicyBindingsul progetto -
Ottieni lo stato di un'operazione a lunga esecuzione per l'applicazione di una policy sul confine di accesso dell'entità al set di entità di un progetto:
iam.operations.getsul progetto -
Applica le policy sul confine di accesso dell'entità al set di entità di una cartella:
resourcemanager.folders.createPolicyBindingsulla cartella -
Applica le policy sul confine di accesso dell'entità al set di entità di un'organizzazione:
resourcemanager.organizations.createPolicyBindingsull'organizzazione
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Crea una policy sul confine di accesso dell'entità
Puoi creare una policy dei confini di accesso dell'entità utilizzando la console Google Cloud , gcloud CLI o l'API REST IAM.
Console
Nella console Google Cloud , vai alla pagina Policy dei limiti di accesso delle entità.
Seleziona l'organizzazione per cui vuoi creare le policy sul confine di accesso dell'entità.
Fai clic su Crea policy.
Aggiungi regole di confine di accesso dell'entità alla policy:
- Fai clic su Aggiungi regola di confine.
- Nel campo Descrizione, aggiungi una descrizione della regola della policy Principal Access Boundary. La descrizione può contenere un massimo di 256 caratteri.
Nella sezione Risorse, inserisci tutte le 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 sul confine di accesso dell'entità può fare riferimento a un massimo di 500 risorse in tutte le regole della policy.
Fai clic su Fine.
Per aggiungere altre regole della policy, ripeti questi passaggi. Ogni policy Principal Access Boundary può avere fino a 500 regole.
Nella sezione Nome policy, inserisci un nome per la policy. Il nome può contenere un massimo di 63 caratteri.
Nell'elenco Versione di applicazione, seleziona la versione di applicazione per la policy. La versione della policy sul confine di accesso dell'entità determina le autorizzazioni per cui IAM applica la policy sul confine di accesso dell'entità.
Per saperne di più su come impostare e gestire le versioni di applicazione, consulta Gestisci le versioni di applicazione.
Fai clic su Crea.
gcloud
Il comando gcloud iam principal-access-boundary-policies create crea una policy sul confine di accesso dell'entità.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
-
PAB_POLICY_ID: un ID univoco per la policy dei confini di accesso dell'entità, ad esempioexample-policy. ORG_ID: l'ID dell'organizzazione in cui vuoi creare la policy dei limiti di accesso delle entità. Gli ID organizzazione sono numerici, ad esempio123456789012.DISPLAY_NAME: (Facoltativo) Una descrizione leggibile della policy di Principal Access Boundary, 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 della policy Principal Access Boundary. Ogni regola deve avere 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,4elatest.Per saperne di più su come impostare e gestire le versioni di applicazione, consulta Gestione delle versioni di applicazione.
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud iam principal-access-boundary-policies create PAB_POLICY_ID \ --organization=ORG_ID --location=global \ --display-name=DISPLAY_NAME --details-rules=FILE_PATH.json \ --details-enforcement-version=ENFORCEMENT_VERSION
Windows (PowerShell)
gcloud iam principal-access-boundary-policies create PAB_POLICY_ID ` --organization=ORG_ID --location=global ` --display-name=DISPLAY_NAME --details-rules=FILE_PATH.json ` --details-enforcement-version=ENFORCEMENT_VERSION
Windows (cmd.exe)
gcloud iam principal-access-boundary-policies create PAB_POLICY_ID ^ --organization=ORG_ID --location=global ^ --display-name=DISPLAY_NAME --details-rules=FILE_PATH.json ^ --details-enforcement-version=ENFORCEMENT_VERSION
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 principalAccessBoundaryPolicy [example-policy].
REST
Il metodo principalAccessBoundaryPolicies.create crea una policy sul confine di accesso dell'entità.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
ORG_ID: l'ID dell'organizzazione in cui vuoi creare la policy dei limiti di accesso delle entità. Gli ID organizzazione sono numerici, ad esempio123456789012.-
PAB_POLICY_ID: un ID univoco per la policy dei confini di accesso dell'entità, ad esempioexample-policy. DISPLAY_NAME: (Facoltativo) Una descrizione leggibile della policy di Principal Access Boundary, ad esempioExample 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,4elatest.Per saperne di più su come impostare e gestire le versioni di applicazione, consulta Gestione delle versioni di applicazione.
Metodo HTTP e URL:
POST https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global?principalAccessBoundaryPolicyId=PAB_POLICY_ID
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-1715373120647-6181f6d8371d2-83309b71-2b8a7532",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2024-05-10T20:32:00.898809495Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-policy",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
Applica una policy sul confine di accesso dell'entità a un set di entità
Per applicare una policy sul confine di accesso dell'entità a un set di entità, crea una risorsa di associazione delle policy che associa la policy al set di entità. Dopo aver creato un'associazione delle policy, la policy di Principal Access Boundary nell'associazione viene applicata alle entità nell'associazione.
Puoi creare un'associazione delle policy utilizzando la console Google Cloud , gcloud CLI o l'API REST IAM.
Console
Nella console Google Cloud , vai alla pagina Policy dei limiti di accesso delle entità.
Seleziona l'organizzazione proprietaria della policy sul confine di accesso dell'entità per cui vuoi creare un'associazione.
Fai clic sull'ID della policy sul confine di accesso dell'entità per cui vuoi creare un'associazione.
Fai clic sulla scheda Associazioni, quindi su Aggiungi associazione.
Inserisci i dettagli dell'associazione:
- (Facoltativo) Nel campo Nome visualizzato, inserisci un nome visualizzato per l'associazione. 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. Nella sezione Set di entità di destinazione, inserisci il tipo e l'ID del set di entità a cui vuoi associare la policy. Non puoi modificare questo valore dopo aver creato l'associazione della policy.
Per scoprire di più sulle entità incluse in ogni set di entità, consulta Set di entità supportati.
(Facoltativo) Per specificare le entità nel set di entità per cui viene applicata la policy di Principal Access Boundary, aggiungi una condizione all'associazione:
- Fai clic su Aggiungi condizione.
- Nel campo Titolo, inserisci un breve riepilogo dello scopo della condizione.
- (Facoltativo) Nel campo Descrizione, inserisci una descrizione più lunga della condizione.
- Nel campo Espressione, inserisci un'espressione di condizione che utilizza la sintassi Common Expression Language (CEL). L'espressione deve fare riferimento agli attributi
principal.typeoprincipal.subject. Gli altri attributi non sono supportati. - Fai clic su Salva.
(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à.
Per creare l'associazione, fai clic su Aggiungi.
gcloud
Il comando gcloud iam policy-bindings create crea un'associazione di policy.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
-
BINDING_ID: un nome univoco per l'associazione della policy, ad esempioexample-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 valoreproject,folderoorganization.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, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio123456789012. -
ORG_ID: l'ID dell'organizzazione proprietaria della policy sul confine di accesso dell'entità che vuoi associare al set di entità. Gli ID organizzazione sono numerici, ad esempio123456789012. -
PAB_POLICY_ID: l'ID della policy Principal Access Boundary che vuoi associare al set di entità, ad esempioexample-pab-policy. Non puoi modificare questo valore dopo aver creato l'associazione della policy. -
PRINCIPAL_SET: il set di entità a cui vuoi associare la policy. Per un elenco dei tipi di entità validi, consulta Set di entità supportati. Non puoi modificare questo valore dopo aver creato l'associazione della policy. DISPLAY_NAME: (Facoltativo) Una descrizione dell'associazione leggibile da una persona, ad esempioExample 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 attributiprincipal.typeoprincipal.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.
-
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud iam policy-bindings create BINDING_ID \ --RESOURCE_TYPE=RESOURCE_ID --location=global \ --policy="organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID" \ --target-principal-set=PRINCIPAL_SET \ --display-name=DISPLAY_NAME \ CONDITION_DETAILS
Windows (PowerShell)
gcloud iam policy-bindings create BINDING_ID ` --RESOURCE_TYPE=RESOURCE_ID --location=global ` --policy="organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID" ` --target-principal-set=PRINCIPAL_SET ` --display-name=DISPLAY_NAME ` CONDITION_DETAILS
Windows (cmd.exe)
gcloud iam policy-bindings create BINDING_ID ^ --RESOURCE_TYPE=RESOURCE_ID --location=global ^ --policy="organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID" ^ --target-principal-set=PRINCIPAL_SET ^ --display-name=DISPLAY_NAME ^ CONDITION_DETAILS
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 di policy.
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 valoreprojects,foldersoorganizations.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, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio123456789012. -
BINDING_ID: un nome univoco per l'associazione della policy, 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.-
PRINCIPAL_SET: il set di entità a cui vuoi associare la policy. Per un elenco dei tipi di entità validi, consulta Set di entità supportati. Non puoi modificare questo valore dopo aver creato l'associazione della policy. -
ORG_ID: l'ID dell'organizzazione proprietaria della policy sul confine di accesso dell'entità che vuoi associare al set di entità. Gli ID organizzazione sono numerici, ad esempio123456789012. -
PAB_POLICY_ID: l'ID della policy Principal Access Boundary che vuoi associare al set di entità, ad esempioexample-pab-policy. Non puoi modificare questo valore dopo aver creato l'associazione della policy. -
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 attributiprincipal.typeoprincipal.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:
POST https://iam.googleapis.com/v3/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings?policyBindingId=BINDING_ID
Corpo JSON della richiesta:
{
"displayName": "DISPLAY_NAME",
"target": {
"principalSet": "PRINCIPAL_SET"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID",
"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-1715373120647-6181f6d8371d2-83309b71-2b8a7532",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2024-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 policy sul confine di accesso dell'entità
- Modifica le policy sul confine di accesso dell'entità
- Rimuovi le policy sul confine di accesso dell'entità