Le Unified Access Policies (UAP) ti consentono di concedere e negare alle entità l'accesso alle risorseCloud de Confiance . Se non vuoi più che una policy di accesso utente venga applicata a una risorsa, puoi eliminare l'associazione della policy che la associa alla risorsa. Se vuoi rimuovere una policy da tutte le risorse a cui è associata, puoi eliminarla.
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 Cloud de Confiance per accedere ai servizi e alle API Cloud de Confiance by S3NS , non devi configurare l'autenticazione.
gcloud
Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il comando seguente:
gcloud initREST
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, quindi accedi a gcloud CLI con la tua identità federata.
Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Cloud de Confiance .
-
Verifica che la fatturazione sia attivata per il tuo progetto Cloud de Confiance .
(Facoltativo) Leggi la panoramica delle UAP.
Ruoli richiesti per eliminare le associazioni delle policy di accesso unificato
Per ottenere le autorizzazioni necessarie per eliminare un'associazione per un UAP, chiedi all'amministratore di concederti i seguenti ruoli IAM:
- Access Policy User (
roles/iam.accessPolicyUser) sulla risorsa proprietaria della policy di accesso utente. Questo ruolo include l'autorizzazioneiam.accesspolicies.unbind, necessaria per eliminare le associazioni. Un ruolo che include l'autorizzazione
SERVICE.RESOURCE.deletePolicyBinding, doveRESOURCEè il tipo di risorsa a cui è associato l'UAP 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.
Ruoli richiesti per eliminare le policy di accesso unificato
Per ottenere le autorizzazioni necessarie per eliminare gli UAP, chiedi all'amministratore di concederti il ruolo IAM Amministratore policy di accesso (roles/iam.accessPolicyAdmin) nel progetto, nella cartella o nell'organizzazione proprietaria dell'UAP che vuoi eliminare.
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 eliminare gli UAP. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per eliminare gli UAP sono necessarie le seguenti autorizzazioni:
-
iam.accesspolicies.delete -
Elimina gli UAP nella console Cloud de Confiance :
-
iam.accesspolicies.get -
iam.accessPolicies.list
-
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Rimuovi una Unified Access Policy da una risorsa
Per rimuovere un UAP da una risorsa, elimina l'associazione che collega l'UAP alla risorsa. Dopo aver eliminato l'associazione, la policy di accesso utente non viene più applicata alla risorsa o ai suoi discendenti. Tuttavia, l'UAP non viene eliminato e le altre associazioni non vengono interessate.
Puoi eliminare le associazioni per progetti, cartelle e organizzazioni utilizzando la consoleCloud de Confiance , gcloud CLI o l'API REST IAM. Per eliminare le associazioni per altre risorse, devi utilizzare gcloud CLI o l'API REST IAM.
Console
-
Nella console Cloud de Confiance , 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 rimuovere.
- Fai clic sull'ID policy della UAP che vuoi rimuovere.
- Seleziona la scheda Associazioni.
- Nella tabella Associazioni, trova la riga contenente l'associazione che vuoi rimuovere.
- In quella riga, fai clic sul menu Azioni e poi su Elimina associazione.
- Nella finestra di dialogo Elimina associazione, fai clic su Elimina.
gcloud
Il comando gcloud iam policy-bindings delete elimina un'associazione.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
-
BINDING_ID: l'ID dell'associazione che vuoi eliminare, 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.
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud iam policy-bindings delete BINDING_ID \ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
Windows (PowerShell)
gcloud iam policy-bindings delete BINDING_ID ` --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
Windows (cmd.exe)
gcloud iam policy-bindings delete BINDING_ID ^ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
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.
Delete request issued for: [example-binding] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374724030-6181fcd1520c5-d21b0a12-b704e1ce] to complete...done. Deleted policyBinding [example-binding].
REST
Il metodo policyBindings.delete elimina 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: l'ID dell'associazione che vuoi eliminare, ad esempioexample-binding.
Metodo HTTP e URL:
DELETE https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings/BINDING_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-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-binding",
"verb": "delete",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
Elimina una policy di accesso unificato
Prima di eliminare un criterio di accesso utente, identifica ed elimina tutte le associazioni esistenti che fanno riferimento al criterio di accesso utente. I tentativi di eliminare una policy di accesso utente senza eliminare le associazioni esistenti generano un errore.
Se vuoi eliminare un UAP senza eliminare le associazioni esistenti, puoi forzare l'eliminazione dell'UAP. L'eliminazione forzata di un UAP lo rimuove da tutte le risorse a cui è associato. Le associazioni che fanno riferimento alla UAP verranno eliminate. Tuttavia, finché non vengono eliminate, le associazioni vengono comunque conteggiate ai fini del limite del numero di associazioni che possono fare riferimento a una singola risorsa.
Puoi eliminare gli UAP utilizzando la console Cloud de Confiance , gcloud CLI o l'API REST IAM.
Console
-
Nella console Cloud de Confiance , 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 eliminare.
- Fai clic sull'ID policy della UAP che vuoi eliminare.
- Fai clic su Elimina policy.
- Se la policy di accesso unificato ha associazioni esistenti, seleziona Elimina questa policy e tutte le relative associazioni. Se provi a eliminare una policy di accesso utente con associazioni esistenti senza selezionare questa opzione, la richiesta non va a buon fine.
- Nella finestra di dialogo Elimina policy, fai clic su Elimina.
gcloud
Il comando gcloud iam access-policies delete elimina una policy di accesso utente e tutte le associazioni correlate.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
-
UAP_ID: l'ID della piattaforma di attivazione utente che vuoi eliminare, ad esempioexample-policy. -
UAP_PARENT_RESOURCE_TYPE: il tipo di risorsa Resource Manager (progetto, cartella o organizzazione) proprietaria della UAP che vuoi eliminare. Utilizza il valoreproject,folderoorganization. -
UAP_PARENT_RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione proprietaria della UAP che vuoi eliminare. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio123456789012. -
FORCE_FLAG: (Facoltativo) Per forzare il comando a eliminare una policy, anche se questa policy è indicata in associazioni esistenti, utilizza il flag--force. Se questo flag non è impostato e la policy è indicata in associazioni esistenti, il comando non va a buon fine.
Esegui questo comando:
Linux, macOS o Cloud Shell
gcloud iam access-policies delete UAP_ID \ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global \ FORCE_FLAG
Windows (PowerShell)
gcloud iam access-policies delete UAP_ID ` --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global ` FORCE_FLAG
Windows (cmd.exe)
gcloud iam access-policies delete UAP_ID ^ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global ^ FORCE_FLAG
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.
Delete request issued for: [example-policy] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete...done. Deleted accessPolicy [example-policy].
REST
Il metodo
accessPolicies.delete
elimina una UAP e tutte le associazioni correlate.
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) proprietaria della UAP che vuoi eliminare. Utilizza il valoreprojects,foldersoorganizations. -
UAP_PARENT_RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione proprietaria della UAP che vuoi eliminare. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio123456789012. -
UAP_ID: l'ID della piattaforma di attivazione utente che vuoi eliminare, ad esempioexample-policy. -
FORCE_DELETE: (Facoltativo) Per forzare la richiesta di eliminazione della policy, anche se viene fatto riferimento alla policy nelle associazioni esistenti, aggiungi il parametro di queryforce=true. Se questo parametro di query non è impostato e la policy è indicata in associazioni esistenti, la richiesta non va a buon fine.
Metodo HTTP e URL:
DELETE https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID?FORCE_DELETE
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-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"verb": "delete",
"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.