Rimuovi le Unified Access Policies

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

  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 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'autorizzazione iam.accesspolicies.unbind, necessaria per eliminare le associazioni.
  • Un ruolo che include l'autorizzazione SERVICE.RESOURCE.deletePolicyBinding, dove RESOURCE è il tipo di risorsa a cui è associato l'UAP 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.

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

  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 rimuovere.
  3. Fai clic sull'ID policy della UAP che vuoi rimuovere.
  4. Seleziona la scheda Associazioni.
  5. Nella tabella Associazioni, trova la riga contenente l'associazione che vuoi rimuovere.
  6. In quella riga, fai clic sul menu Azioni e poi su Elimina associazione.
  7. 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 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.

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 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: l'ID dell'associazione che vuoi eliminare, ad esempio example-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

  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 eliminare.
  3. Fai clic sull'ID policy della UAP che vuoi eliminare.
  4. Fai clic su Elimina policy.
  5. 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.
  6. 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 esempio example-policy.
  • UAP_PARENT_RESOURCE_TYPE: il tipo di risorsa Resource Manager (progetto, cartella o organizzazione) proprietaria della UAP che vuoi eliminare. Utilizza il valore project, folder o organization.
  • 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, come my-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio 123456789012.
  • 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 valore projects, folders o organizations.
  • 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, come my-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio 123456789012.
  • UAP_ID: l'ID della piattaforma di attivazione utente che vuoi eliminare, ad esempio example-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 query force=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