Visualizza le policy di accesso unificato

Le Unified Access Policies (UAP) ti consentono di concedere e negare alle entità l'accesso alle risorseGoogle Cloud . Questo documento spiega come visualizzare le policy di accesso utente e le associazioni.

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 visualizzare le policy Unified Access Policies

Per ottenere le autorizzazioni necessarie per visualizzare le UAP, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore policy di accesso (roles/iam.accessPolicyViewer) nel progetto, nella cartella o nell'organizzazione proprietaria della UAP che vuoi visualizzare. 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 visualizzare gli UAP. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare gli UAP sono necessarie le seguenti autorizzazioni:

  • iam.accesspolicies.get
  • iam.accessPolicies.list

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Ruoli richiesti per visualizzare le associazioni delle Unified Access Policies

Per ottenere le autorizzazioni necessarie per visualizzare le associazioni, chiedi all'amministratore di concederti i seguenti ruoli IAM sulla risorsa padre delle associazioni:

  • Visualizza le associazioni in un progetto: Project IAM Admin (roles/resourcemanager.projectIamAdmin)
  • Visualizza le associazioni in una cartella: Folder IAM Admin (roles/resourcemanager.folderIamAdmin)
  • Visualizza le associazioni in un'organizzazione: Organization Administrator (roles/resourcemanager.organizationAdmin)

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 visualizzare le associazioni. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le associazioni sono necessarie le seguenti autorizzazioni:

  • Visualizza una singola associazione: iam.policybindings.get
  • Elenca le associazioni con un progetto, una cartella o un'organizzazione come risorsa padre: iam.policybindings.list

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Ruoli richiesti per visualizzare tutte le associazioni per una Unified Access Policy

Per ottenere l'autorizzazione necessaria per visualizzare tutte le associazioni per una policy di accesso unificato, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore policy di accesso (roles/iam.accessPolicyViewer) sulla risorsa proprietaria della policy di accesso unificato. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione iam.accesspolicies.searchPolicyBindings necessaria per visualizzare tutte le associazioni per un UAP.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Ruoli per visualizzare tutte le associazioni per una risorsa

Per ottenere le autorizzazioni necessarie per visualizzare tutte le associazioni che includono una risorsa di destinazione specifica, chiedi all'amministratore di concederti un ruolo che ti consenta di elencare le associazioni per quella risorsa. Questo ruolo deve includere l'autorizzazione SERVICE.RESOURCE.searchPolicyBindings, dove RESOURCE è il tipo di risorsa di destinazione 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 di destinazione o su uno dei suoi predecessori.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Elenca le Unified Access Policies in un progetto, una cartella o un'organizzazione

Puoi elencare tutte le UAP associate a un progetto, una cartella o un'organizzazione specifici 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 delle policy di accesso utente che vuoi visualizzare.

La console Google Cloud mostra le policy di accesso utente associate o collegate alla risorsa selezionata.

gcloud

Il comando gcloud iam access-policies list elenca tutte le UAP secondarie di una determinata risorsa.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • UAP_PARENT_RESOURCE_TYPE: il tipo di risorsa Resource Manager (progetto, cartella o organizzazione) proprietaria degli UAP che vuoi elencare. Utilizza il valore project, folder o organization.
  • UAP_PARENT_RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione proprietaria delle policy di accesso utente che vuoi elencare. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio 123456789012.
  • FORMAT: il formato della risposta. Utilizza json o yaml.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam access-policies list --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \
    --location=global --format=FORMAT

Windows (PowerShell)

gcloud iam access-policies list --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID `
    --location=global --format=FORMAT

Windows (cmd.exe)

gcloud iam access-policies list --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^
    --location=global --format=FORMAT

La risposta contiene le UAP secondarie della risorsa nella richiesta.

{
  "accessPolicies": [
    {
      "createTime": "2026-08-31T21:43:39.822441Z",
      "details": {
        "rules": [
          {
            "conditions": {
              "iam.googleapis.com": {
                "expression": "resource.matchTag('environment', 'prod')"
              }
            },
            "description": "Grant non-delete compute permissions to compute admins in prod",
            "effect": "ALLOW",
            "excludedPrincipals": [
              "principal://goog/subject/access-restricted@example.com"
            ],
            "operation": {
              "excludedPermissions": [
                "*/*.delete"
              ],
              "permissions": [
                "role:roles/compute.admin"
              ]
            },
            "principals": [
              "principalSet://goog/group/compute-admins@example.com"
            ]
          }
        ]
      },
      "displayName": "Example policy 1",
      "etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
      "name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
      "uid": "puid_0123456789012345678",
      "updateTime": "2026-08-31T21:43:39.822441Z"
    },
    {
      "createTime": "2026-05-29T23:25:01.606730Z",
      "details": {
        "rules": [
          {
            "description": "Deny group from publishing to message buses",
            "effect": "DENY",
            "operation": {
              "permissions": [
                "eventarc.googleapis.com/messageBuses.publish"
              ]
            },
            "principals": [
              "principalSet://goog/group/example-group@example.com"
            ]
          }
        ]
      },
      "displayName": "Example policy 2",
      "etag": "d6BJBTsk2+oDCygmr5ANxA==",
      "name": "organizations/123456789012/locations/global/accessPolicies/example-policy-2",
      "uid": "puid_13064942519001808897",
      "updateTime": "2026-05-29T23:25:01.606730Z"
    }
  ]
}

REST

Il metodo accessPolicies.list elenca tutte le UAP secondarie di una determinata risorsa.

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 degli UAP che vuoi elencare. Utilizza il valore projects, folders o organizations.
  • UAP_PARENT_RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione proprietaria delle policy di accesso utente che vuoi elencare. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio 123456789012.

Metodo HTTP e URL:

GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene le UAP secondarie della risorsa nella richiesta.

{
  "accessPolicies": [
    {
      "name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
      "uid": "puid_0123456789012345678",
      "etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
      "displayName": "Example policy",
      "createTime": "2026-08-31T21:43:39.822441Z",
      "updateTime": "2026-08-31T21:43:39.822441Z",
      "details": {
        "rules": [
          {
            "principals": [
              "principalSet://goog/group/compute-admins@example.com"
            ],
            "excludedPrincipals": [
              "principal://goog/subject/access-restricted@example.com"
            ],
            "operation": {
              "permissions": [
                "role:roles/compute.admin"
              ],
              "excludedPermissions": [
                "*/*.delete"
              ]
            },
            "conditions": {
              "iam.googleapis.com": {
                "expression": "resource.matchTag('environment', 'prod')"
              }
            },
            "description": "Grant non-delete compute permissions to compute admins in prod",
            "effect": "ALLOW"
          }
        ]
      }
    },
    {
      "name": "organizations/123456789012/locations/global/accessPolicies/example-policy-2",
      "uid": "puid_13064942519001808897",
      "etag": "d6BJBTsk2+oDCygmr5ANxA==",
      "displayName": "Example policy 2",
      "createTime": "2026-05-29T23:25:01.606730Z",
      "updateTime": "2026-05-29T23:25:01.606730Z",
      "details": {
        "rules": [
          {
            "description": "Deny group from publishing to message buses",
            "principals": [
              "principalSet://goog/group/example-group@example.com"
            ],
            "operation": {
              "permissions": [
                "eventarc.googleapis.com/messageBuses.publish"
              ]
            },
            "effect": "DENY"
          }
        ]
      }
    }
  ]
}

Ottieni una singola policy di accesso unificato

Puoi ottenere i dettagli di un singolo UAP utilizzando la consoleGoogle 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 dell'UAP di cui vuoi visualizzare i dettagli.
  3. Fai clic sull'ID della policy della UAP di cui vuoi visualizzare i dettagli.

La console Google Cloud mostra i dettagli della policy di accesso utente, tra cui l'ID, l'ora di creazione, l'ora dell'ultimo aggiornamento e l'elenco delle regole.

gcloud

Il comando gcloud iam access-policies describe recupera un singolo UAP.

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 recuperare, ad esempio example-policy.
  • UAP_PARENT_RESOURCE_TYPE: il tipo di risorsa Resource Manager (progetto, cartella o organizzazione) proprietaria della UAP che vuoi recuperare. 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 recuperare. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio 123456789012.
  • FORMAT: il formato della risposta. Utilizza json o yaml.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam access-policies describe UAP_ID \
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \
    --location=global --format=FORMAT

Windows (PowerShell)

gcloud iam access-policies describe UAP_ID `
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID `
    --location=global --format=FORMAT

Windows (cmd.exe)

gcloud iam access-policies describe UAP_ID ^
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^
    --location=global --format=FORMAT

La risposta contiene l'UAP specificato nella richiesta.

{
  "createTime": "2026-08-31T21:43:39.822441Z",
  "details": {
    "rules": [
      {
        "conditions": {
          "iam.googleapis.com": {
            "expression": "resource.matchTag('environment', 'prod')"
          }
        },
        "description": "Grant non-delete compute permissions to compute admins in prod",
        "effect": "ALLOW",
        "excludedPrincipals": [
          "principal://goog/subject/access-restricted@example.com"
        ],
        "operation": {
          "excludedPermissions": [
            "*/*.delete"
          ],
          "permissions": [
            "role:roles/compute.admin"
          ]
        },
        "principals": [
          "principalSet://goog/group/compute-admins@example.com"
        ]
      }
    ]
  },
  "displayName": "Example policy",
  "etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
  "name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
  "uid": "puid_0123456789012345678",
  "updateTime": "2026-08-31T21:43:39.822441Z"
}

REST

Il metodo accessPolicies.get recupera un singolo 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) proprietaria della UAP che vuoi recuperare. 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 recuperare. 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 recuperare, ad esempio example-policy.

Metodo HTTP e URL:

GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene l'UAP specificato nella richiesta.

{
  "name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
  "uid": "puid_0123456789012345678",
  "etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
  "displayName": "Example policy",
  "createTime": "2026-08-31T21:43:39.822441Z",
  "updateTime": "2026-08-31T21:43:39.822441Z",
  "details": {
    "rules": [
      {
        "principals": [
          "principalSet://goog/group/compute-admins@example.com"
        ],
        "excludedPrincipals": [
          "principal://goog/subject/access-restricted@example.com"
        ],
        "operation": {
          "permissions": [
            "role:roles/compute.admin"
          ],
          "excludedPermissions": [
            "*/*.delete"
          ]
        },
        "conditions": {
          "iam.googleapis.com": {
            "expression": "resource.matchTag('environment', 'prod')"
          }
        },
        "description": "Grant non-delete compute permissions to compute admins in prod",
        "effect": "ALLOW"
      }
    ]
  }
}

Elenca le associazioni per Unified Access Policies

Puoi elencare le associazioni per gli indirizzi IP assegnati dall'utente in diversi modi:

Elenca le associazioni per una policy Unified Access Policies

Per visualizzare tutte le associazioni che includono una determinata UAP, cerca le associazioni per la UAP.

Puoi visualizzare tutte le associazioni per un UAP utilizzando la consoleGoogle 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 di cui vuoi visualizzare le associazioni.
  3. Fai clic sull'ID policy della UAP di cui vuoi visualizzare le associazioni.
  4. Seleziona la scheda Associazioni.

La console Google Cloud mostra un elenco delle associazioni per la UAP, insieme al nome visualizzato e alla risorsa di destinazione di ogni associazione.

gcloud

Il comando gcloud iam access-policies search-policy-bindings elenca tutte le associazioni per la UAP specificata.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • UAP_ID: l'ID della piattaforma di accesso utente per cui vuoi elencare le associazioni, ad esempio example-policy.
  • UAP_PARENT_RESOURCE_TYPE: il tipo di risorsa Resource Manager (progetto, cartella o organizzazione) proprietaria della UAP per cui vuoi elencare le associazioni. Utilizza il valore project, folder o organization.
  • UAP_PARENT_RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione proprietaria della UAP per cui vuoi elencare le associazioni. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio 123456789012.
  • FORMAT: il formato della risposta. Utilizza json o yaml.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam access-policies search-policy-bindings UAP_ID \
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \
    --location=global --format=FORMAT

Windows (PowerShell)

gcloud iam access-policies search-policy-bindings UAP_ID `
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID `
    --location=global --format=FORMAT

Windows (cmd.exe)

gcloud iam access-policies search-policy-bindings UAP_ID ^
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^
    --location=global --format=FORMAT

La risposta contiene le associazioni per la UAP specificata.

{
  "policyBindings": [
    {
      "createTime": "2026-05-06T18:08:24.729843Z",
      "displayName": "Example binding 1",
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
      "policyKind": "ACCESS",
      "policyUid": "puid_9519202237377675265",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "uid": "buid_9904260005517852673", 
      "updateTime": "2026-05-06T18:08:24.729843Z"
    },
    {
      "createTime": "2026-05-07T07:05:06.203861Z",
      "displayName": "Example binding 2",
      "etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
      "policyKind": "ACCESS",
      "policyUid": "puid_9519202237377675265",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/projects/example-project"
      },
      "uid": "buid_4331055466646863873", 
      "updateTime": "2026-05-07T07:05:06.203861Z"
    }
  ]
}

REST

Il metodo accessPolicies.searchPolicyBindings elenca tutte le associazioni per la piattaforma UAP specificata.

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 per cui vuoi elencare le associazioni. Utilizza il valore projects, folders o organizations.
  • UAP_PARENT_RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione proprietaria della UAP per cui vuoi elencare le associazioni. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio 123456789012.
  • UAP_ID: l'ID della piattaforma di accesso utente per cui vuoi elencare le associazioni, ad esempio example-policy.

Metodo HTTP e URL:

GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID:searchPolicyBindings

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene le associazioni per la UAP specificata.

{
  "policyBindings": [
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
      "uid": "buid_9904260005517852673", 
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "displayName": "Example binding 1",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "policyKind": "ACCESS",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
      "policyUid": "puid_9519202237377675265",
      "createTime": "2026-05-06T18:08:24.729843Z",
      "updateTime": "2026-05-06T18:08:24.729843Z"
    },
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
      "uid": "buid_4331055466646863873", 
      "etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
      "displayName": "Example binding 2",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/projects/example-project"
      },
      "policyKind": "ACCESS",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
      "policyUid": "puid_9519202237377675265",
      "createTime": "2026-05-07T07:05:06.203861Z",
      "updateTime": "2026-05-07T07:05:06.203861Z"
    }
  ]
}

Elenca tutte le associazioni per una risorsa

Per visualizzare tutte le associazioni che includono una risorsa di destinazione specifica, cerca le associazioni per quella risorsa.

Ogni associazione contiene l'ID della UAP associata alla risorsa. Per visualizzare i dettagli di una policy, utilizza l'ID della policy per recuperare i dettagli della policy.

Puoi visualizzare tutte le associazioni per una risorsa utilizzando la consoleGoogle 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 di cui vuoi visualizzare le associazioni.
  3. Nel campo Filtro, inserisci il filtro Applicazione: applicato.

La tabella mostra tutte le policy di accesso utente associate alla risorsa.

gcloud

Il comando gcloud iam policy-bindings search-target-policy-bindings recupera tutte le associazioni UAP che includono la risorsa.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • BINDING_PARENT_RESOURCE_TYPE: il tipo di risorsa Resource Manager (progetto, cartella o organizzazione) che contiene le associazioni per la risorsa di destinazione. Utilizza il valore project, folder o organization.

    Per scoprire quali risorse sono principali di quali associazioni, consulta Risorse supportate.

  • BINDING_PARENT_RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione che contiene le associazioni per la risorsa di destinazione. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio 123456789012.
  • TARGET_RESOURCE: la risorsa di cui vuoi elencare le associazioni. Per un elenco delle risorse valide, consulta Risorse supportate.
  • FORMAT: il formato della risposta. Utilizza json o yaml.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam policy-bindings search-target-policy-bindings \
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID \
    --target=TARGET_RESOURCE \
    --format=FORMAT

Windows (PowerShell)

gcloud iam policy-bindings search-target-policy-bindings `
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID `
    --target=TARGET_RESOURCE `
    --format=FORMAT

Windows (cmd.exe)

gcloud iam policy-bindings search-target-policy-bindings ^
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ^
    --target=TARGET_RESOURCE ^
    --format=FORMAT

La risposta contiene tutte le associazioni UAP che includono la risorsa di destinazione.

{
  "policyBindings": [
    {
      "createTime": "2026-05-06T18:08:24.729843Z",
      "displayName": "Example binding 1",
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-1",
      "policyKind": "ACCESS",
      "policyUid": "puid_9519202237377675265",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "uid": "buid_9904260005517852673", 
      "updateTime": "2026-05-06T18:11:16.798841Z"
    },
    {
      "createTime": "2026-05-06T18:08:24.729843Z",
      "displayName": "Example binding 2",
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-2",
      "policyKind": "ACCESS",
      "policyUid": "puid_10358560617928851457",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "uid": "buid_4331055466646863873", 
      "updateTime": "2026-05-06T18:11:16.798841Z"
    }
  ]
}

REST

Il metodo SearchTargetPolicyBindings.search recupera tutte le associazioni UAP che includono la risorsa.

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) che contiene le associazioni per la risorsa di destinazione. Utilizza il valore projects, folders o organizations.

    Per scoprire quali risorse sono principali di quali associazioni, consulta Risorse supportate.

  • BINDING_PARENT_RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione che contiene le associazioni per la risorsa di destinazione. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e ID organizzazione sono numerici, ad esempio 123456789012.
  • TARGET_RESOURCE: la risorsa di cui vuoi elencare le associazioni. Per un elenco delle risorse valide, consulta Risorse supportate.

Metodo HTTP e URL:

GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings:searchTargetPolicyBindings?target=TARGET_RESOURCE

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene tutte le associazioni UAP che includono la risorsa di destinazione.

{
  "policyBindings": [
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
      "uid": "buid_9904260005517852673", 
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "displayName": "Example binding 1",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-1",
      "createTime": "2026-05-06T18:08:24.729843Z",
      "updateTime": "2026-05-06T18:11:16.798841Z",
      "policyKind": "ACCESS",
      "policyUid": "puid_9519202237377675265"
    },
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
      "uid": "buid_4331055466646863873", 
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "displayName": "Example binding 2",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-2",
      "createTime": "2026-05-06T18:08:24.729843Z",
      "updateTime": "2026-05-06T18:11:16.798841Z",
      "policyKind": "ACCESS",
      "policyUid": "puid_10358560617928851457"
    }
  ]
}

Elenca tutte le associazioni in un progetto, una cartella o un'organizzazione

Se utilizzi gcloud CLI o l'API REST IAM per visualizzare le associazioni, puoi anche elencare tutte le associazioni secondarie di un progetto, una cartella o un'organizzazione specifici.

La visualizzazione dell'elenco delle associazioni per un progetto, una cartella o un'organizzazione è simile alla ricerca delle associazioni per la risorsa in questione. Tuttavia, a differenza della ricerca delle associazioni, l'elenco delle associazioni per una risorsa include anche tutte le associazioni che sono elementi secondari immediati di quella risorsa.

Ad esempio, immagina di avere un'associazione che collega una policy a un Agent Gateway dell'API Network Services. La risorsa padre di questa associazione è il progetto padre dell'Agent Gateway. In altre parole, l'associazione è un elemento figlio diretto del progetto. Di conseguenza, se elenchi le associazioni per quel progetto, la risposta include l'associazione per l'Agent Gateway. Tuttavia, se elenchi le associazioni per l'organizzazione principale del progetto, la risposta non include l'associazione. Questo perché, anche se l'associazione è un discendente dell'organizzazione, non è un elemento secondario immediato dell'organizzazione.

La risorsa padre di un'associazione dipende dalla risorsa di destinazione nell'associazione. Per saperne di più, consulta Risorse supportate.

Ogni associazione contiene l'ID della UAP associata alla risorsa. Per visualizzare i dettagli di una policy, utilizza l'ID della policy per recuperare i dettagli della policy.

Puoi visualizzare tutte le associazioni secondarie di un progetto, una cartella o un'organizzazione utilizzando gcloud CLI o l'API REST IAM.

gcloud

Il comando gcloud iam policy-bindings list elenca tutte le associazioni UAP secondarie di una determinata risorsa.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • 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.
  • FORMAT: il formato della risposta. Utilizza json o yaml.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam policy-bindings list --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID \
    --location=global \
    --filter=policyKind:ACCESS \
    --format=FORMAT

Windows (PowerShell)

gcloud iam policy-bindings list --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID `
    --location=global `
    --filter=policyKind:ACCESS `
    --format=FORMAT

Windows (cmd.exe)

gcloud iam policy-bindings list --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ^
    --location=global ^
    --filter=policyKind:ACCESS ^
    --format=FORMAT

La risposta contiene le associazioni UAP secondarie della risorsa nel comando.

{
  "policyBindings": [
    {
      "createTime": "2026-05-06T18:08:24.729843Z",
      "displayName": "Example binding 1",
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding-1",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-1",
      "policyKind": "ACCESS",
      "policyUid": "puid_9519202237377675265",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "uid": "buid_9904260005517852673", 
      "updateTime": "2026-05-06T18:08:24.729843Z"
    },
    {
      "createTime": "2026-05-07T07:05:06.203861Z",
      "displayName": "Example binding 2",
      "etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding-2",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-2",
      "policyKind": "ACCESS",
      "policyUid": "puid_1566408245394800641",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "uid": "buid_4331055466646863873", 
      "updateTime": "2026-05-07T07:05:06.203861Z"
    }
  ]
}

REST

Il metodo policyBindings.list elenca tutte le associazioni UAP secondarie di una determinata risorsa.

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.

Metodo HTTP e URL:

GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings?filter=policyKind:ACCESS

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene le associazioni UAP secondarie della risorsa nella richiesta.

{
  "policyBindings": [
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding-1",
      "uid": "buid_9904260005517852673", 
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "displayName": "Example binding 1",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "policyKind": "ACCESS",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-1",
      "policyUid": "puid_9519202237377675265",
      "createTime": "2026-05-06T18:08:24.729843Z",
      "updateTime": "2026-05-06T18:08:24.729843Z"
    },
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding-2",
      "uid": "buid_4331055466646863873", 
      "etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
      "displayName": "Example binding 2",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "policyKind": "ACCESS",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-2",
      "policyUid": "puid_1566408245394800641",
      "createTime": "2026-05-07T07:05:06.203861Z",
      "updateTime": "2026-05-07T07:05:06.203861Z"
    }
  ]
}

Ottieni un'associazione per una policy Unified Access Policy

Puoi ottenere i dettagli di un'associazione 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 di cui vuoi visualizzare le associazioni.
  3. Fai clic sull'ID policy della UAP di cui vuoi visualizzare le associazioni.
  4. Seleziona la scheda Associazioni.
  5. Trova l'associazione utilizzando l'ID o il nome dell'associazione.

La tabella mostra i dettagli dell'associazione, tra cui l'ID, il nome e la risorsa di destinazione nell'associazione.

gcloud

Il comando gcloud iam policy-bindings describe recupera un'associazione.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • BINDING_ID: l'ID dell'associazione che vuoi recuperare, 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.
  • FORMAT: il formato della risposta. Utilizza json o yaml.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam policy-bindings describe BINDING_ID \
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID \
    --location=global --format=FORMAT

Windows (PowerShell)

gcloud iam policy-bindings describe BINDING_ID `
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID `
    --location=global --format=FORMAT

Windows (cmd.exe)

gcloud iam policy-bindings describe BINDING_ID ^
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ^
    --location=global --format=FORMAT

La risposta contiene l'associazione.

{
  "createTime": "2026-05-06T18:08:24.729843Z",
  "displayName": "Example binding",
  "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
  "name": "organizations/123456789012/locations/global/policyBindings/example-binding",
  "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap",
  "policyKind": "ACCESS",
  "policyUid": "puid_9519202237377675265",
  "target": {
    "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
  },
  "uid": "buid_9904260005517852673", 
  "updateTime": "2026-05-06T18:08:24.729843Z"
}

REST

Il metodo policyBindings.get recupera 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 recuperare, ad esempio example-binding.

Metodo HTTP e URL:

GET 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 l'associazione.

{
  "name": "organizations/123456789012/locations/global/policyBindings/example-binding",
  "uid": "buid_9904260005517852673", 
  "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
  "displayName": "Example binding",
  "target": {
    "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
  },
  "policyKind": "ACCESS",
  "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap",
  "policyUid": "puid_9519202237377675265",
  "createTime": "2026-05-06T18:08:24.729843Z",
  "updateTime": "2026-05-06T18:08:24.729843Z"
}

Passaggi successivi