Le Unified Access Policies (UAP) ti consentono di concedere e negare alle entità l'accesso alle risorseGoogle Cloud . 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 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 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 Google Cloud :
-
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 consoleGoogle Cloud , 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 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 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 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 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.
Passaggi successivi
- Crea e applica i profili di attività degli utenti
- Visualizza le associazioni e le policy di accesso degli utenti
- Modifica le policy di accesso degli utenti e le associazioni