Afficher les stratégies d'accès unifiées

Les stratégies d'accès unifiées (UAP) vous permettent d'accorder et de refuser l'accès des comptes principaux aux ressourcesGoogle Cloud . Ce document explique comment afficher les UAP et les liaisons.

Avant de commencer

  1. Configurez l'authentification.

    Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

    Console

    Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud , vous n'avez pas besoin de configurer l'authentification.

    gcloud

    Dans la console Google Cloud , activez Cloud Shell.

    Activer Cloud Shell

    En bas de la console Google Cloud , une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement de shell dans lequel la Google Cloud CLI est déjà installée, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.

    REST

    Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.

      Installez la Google Cloud CLI.

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

    Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud .

  2. Vérifiez que la facturation est activée pour votre projet Google Cloud .

  3. Facultatif : lisez la présentation des UAP.

Rôles requis pour afficher les stratégies d'accès unifiées

Pour obtenir les autorisations nécessaires pour afficher les UAP, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de règles d'accès (roles/iam.accessPolicyViewer) sur le projet, le dossier ou l'organisation propriétaire de l'UAP que vous souhaitez afficher. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour afficher les UAP. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les UAP :

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

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Rôles requis pour afficher les liaisons de stratégie d'accès unifiée

Pour obtenir les autorisations nécessaires pour afficher les liaisons, demandez à votre administrateur de vous accorder les rôles IAM suivants sur la ressource parente des liaisons :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour afficher les liaisons. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les liaisons :

  • Afficher une seule liaison : iam.policybindings.get
  • Répertorier les liaisons associées à un projet, un dossier ou une organisation : iam.policybindings.list

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Rôles requis pour afficher toutes les liaisons d'une stratégie d'accès unifiée

Pour obtenir l'autorisation nécessaire pour afficher toutes les liaisons d'une UAP, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de règles d'accès (roles/iam.accessPolicyViewer) sur la ressource propriétaire de l'UAP. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient l'autorisation iam.accesspolicies.searchPolicyBindings, qui est nécessaire pour afficher toutes les liaisons d'une UAP.

Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.

Rôles permettant d'afficher toutes les liaisons d'une ressource

Pour obtenir les autorisations nécessaires pour afficher toutes les liaisons incluant une ressource cible spécifique, demandez à votre administrateur de vous accorder un rôle vous permettant de lister les liaisons pour cette ressource. Ce rôle doit inclure l'autorisation SERVICE.RESOURCE.searchPolicyBindings, où RESOURCE est le type de ressource cible et SERVICE est le service propriétaire de la ressource.

Pour trouver un rôle incluant l'autorisation requise, recherchez l'autorisation dans la documentation de référence sur les rôles et les autorisations, cliquez sur le nom de l'autorisation, puis examinez les rôles qui l'incluent.

Vous devez disposer de ce rôle sur la ressource cible ou l'un de ses ancêtres.

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Répertorier les stratégies d'accès unifiées d'un projet, d'un dossier ou d'une organisation

Vous pouvez lister toutes les stratégies d'accès des utilisateurs associées à un projet, un dossier ou une organisation spécifiques à l'aide de la console Google Cloud , de la gcloud CLI ou de l'API REST IAM.

Console

  1. Dans la console Google Cloud , accédez à la page Stratégies d'accès unifiées.

    Accéder à la page "Stratégies d'accès unifiées"
  2. Sélectionnez le projet, le dossier ou l'organisation propriétaire des règles d'accès utilisateur que vous souhaitez afficher.

La console Google Cloud affiche les UAP dont la ressource que vous avez sélectionnée est le parent ou auxquelles elle est liée.

gcloud

La commande gcloud iam access-policies list liste toutes les règles d'accès utilisateur qui sont enfants d'une certaine ressource.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • UAP_PARENT_RESOURCE_TYPE : type de la ressource Resource Manager (projet, dossier ou organisation) qui possède les UAP que vous souhaitez lister. Utilisez la valeur project, folder ou organization.
  • UAP_PARENT_RESOURCE_ID : ID du projet, du dossier ou de l'organisation propriétaire des UAP que vous souhaitez lister. Les ID de projet sont des chaînes alphanumériques, telles que my-project. Les ID de dossier et d'organisation sont numériques, tels que 123456789012.
  • FORMAT : format de la réponse. Utilisez json ou yaml.

Exécutez la commande suivante :

Linux, macOS ou 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 réponse contient les UAP qui sont des enfants de la ressource dans la requête.

{
  "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

La méthode accessPolicies.list liste toutes les règles d'administration utilisateur qui sont enfants d'une certaine ressource.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • UAP_PARENT_RESOURCE_TYPE : type de la ressource Resource Manager (projet, dossier ou organisation) qui possède les UAP que vous souhaitez lister. Utilisez la valeur projects, folders ou organizations.
  • UAP_PARENT_RESOURCE_ID : ID du projet, du dossier ou de l'organisation propriétaire des UAP que vous souhaitez lister. Les ID de projet sont des chaînes alphanumériques, telles que my-project. Les ID de dossier et d'organisation sont numériques, tels que 123456789012.

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse contient les UAP qui sont des enfants de la ressource dans la requête.

{
  "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"
          }
        ]
      }
    }
  ]
}

Obtenir une stratégie d'accès unifiée

Vous pouvez obtenir les détails d'une seule stratégie d'accès utilisateur à l'aide de la consoleGoogle Cloud , de la gcloud CLI ou de l'API REST IAM.

Console

  1. Dans la console Google Cloud , accédez à la page Stratégies d'accès unifiées.

    Accéder à la page "Stratégies d'accès unifiées"
  2. Sélectionnez le projet, le dossier ou l'organisation propriétaire de l'UAP dont vous souhaitez afficher les détails.
  3. Cliquez sur l'ID de la stratégie d'accès utilisateur dont vous souhaitez afficher les détails.

La console Google Cloud affiche les détails de la stratégie d'accès utilisateur, y compris l'ID, l'heure de création, l'heure de la dernière mise à jour et la liste des règles.

gcloud

La commande gcloud iam access-policies describe obtient une seule UAP.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • UAP_ID : ID de l'UAP que vous souhaitez obtenir (par exemple, example-policy).
  • UAP_PARENT_RESOURCE_TYPE : type de la ressource Resource Manager (projet, dossier ou organisation) propriétaire de l'UAP que vous souhaitez obtenir. Utilisez la valeur project, folder ou organization.
  • UAP_PARENT_RESOURCE_ID : ID du projet, du dossier ou de l'organisation propriétaire de la règle d'accès utilisateur que vous souhaitez obtenir. Les ID de projet sont des chaînes alphanumériques, telles que my-project. Les ID de dossier et d'organisation sont numériques, tels que 123456789012.
  • FORMAT : format de la réponse. Utilisez json ou yaml.

Exécutez la commande suivante :

Linux, macOS ou 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 réponse contient l'UAP spécifiée dans la requête.

{
  "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

La méthode accessPolicies.get obtient une seule UAP.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • UAP_PARENT_RESOURCE_TYPE : type de la ressource Resource Manager (projet, dossier ou organisation) propriétaire de l'UAP que vous souhaitez obtenir. Utilisez la valeur projects, folders ou organizations.
  • UAP_PARENT_RESOURCE_ID : ID du projet, du dossier ou de l'organisation propriétaire de la règle d'accès utilisateur que vous souhaitez obtenir. Les ID de projet sont des chaînes alphanumériques, telles que my-project. Les ID de dossier et d'organisation sont numériques, tels que 123456789012.
  • UAP_ID : ID de l'UAP que vous souhaitez obtenir (par exemple, example-policy).

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse contient l'UAP spécifiée dans la requête.

{
  "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"
      }
    ]
  }
}

Répertorier les liaisons pour les stratégies d'accès unifiées

Vous pouvez lister les liaisons pour les règles d'accès utilisateur de plusieurs manières :

Répertorier les liaisons d'une stratégie d'accès unifiée

Pour afficher toutes les liaisons incluant une certaine règle d'accès utilisateur, recherchez les liaisons de cette règle.

Vous pouvez afficher toutes les liaisons d'une stratégie d'accès utilisateur à l'aide de la consoleGoogle Cloud , de la gcloud CLI ou de l'API REST IAM.

Console

  1. Dans la console Google Cloud , accédez à la page Stratégies d'accès unifiées.

    Accéder à la page "Stratégies d'accès unifiées"
  2. Sélectionnez le projet, le dossier ou l'organisation propriétaire de l'UAP dont vous souhaitez afficher les liaisons.
  3. Cliquez sur l'ID de la stratégie UAP dont vous souhaitez afficher les liaisons.
  4. Sélectionnez l'onglet Liaisons.

La console Google Cloud affiche la liste des liaisons pour l'UAP, ainsi que le nom à afficher et la ressource cible de chaque liaison.

gcloud

La commande gcloud iam access-policies search-policy-bindings liste toutes les liaisons pour l'UAP spécifiée.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • UAP_ID : ID de la stratégie d'accès utilisateur pour laquelle vous souhaitez lister les liaisons (par exemple, example-policy).
  • UAP_PARENT_RESOURCE_TYPE : type de la ressource Resource Manager (projet, dossier ou organisation) propriétaire de l'UAP dont vous souhaitez lister les liaisons. Utilisez la valeur project, folder ou organization.
  • UAP_PARENT_RESOURCE_ID : ID du projet, du dossier ou de l'organisation propriétaire de la règle d'accès utilisateur pour laquelle vous souhaitez lister les liaisons. Les ID de projet sont des chaînes alphanumériques, telles que my-project. Les ID de dossier et d'organisation sont numériques, tels que 123456789012.
  • FORMAT : format de la réponse. Utilisez json ou yaml.

Exécutez la commande suivante :

Linux, macOS ou 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 réponse contient les liaisons pour l'UAP spécifiée.

{
  "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

La méthode accessPolicies.searchPolicyBindings liste toutes les liaisons pour l'UAP spécifiée.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • UAP_PARENT_RESOURCE_TYPE : type de la ressource Resource Manager (projet, dossier ou organisation) propriétaire de l'UAP dont vous souhaitez lister les liaisons. Utilisez la valeur projects, folders ou organizations.
  • UAP_PARENT_RESOURCE_ID : ID du projet, du dossier ou de l'organisation propriétaire de la règle d'accès utilisateur pour laquelle vous souhaitez lister les liaisons. Les ID de projet sont des chaînes alphanumériques, telles que my-project. Les ID de dossier et d'organisation sont numériques, tels que 123456789012.
  • UAP_ID : ID de la stratégie d'accès utilisateur pour laquelle vous souhaitez lister les liaisons (par exemple, example-policy).

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse contient les liaisons pour l'UAP spécifiée.

{
  "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"
    }
  ]
}

Répertorier toutes les liaisons d'une ressource

Pour afficher toutes les liaisons qui incluent une ressource cible spécifique, recherchez les liaisons de cette ressource.

Chaque liaison contient l'ID de la stratégie d'accès utilisateur liée à la ressource. Pour afficher les détails d'une stratégie, utilisez l'ID de la stratégie afin d'obtenir les détails de la stratégie.

Vous pouvez afficher toutes les liaisons d'une ressource à l'aide de la consoleGoogle Cloud , de la gcloud CLI ou de l'API REST IAM.

Console

  1. Dans la console Google Cloud , accédez à la page Stratégies d'accès unifiées.

    Accéder à la page "Stratégies d'accès unifiées"
  2. Sélectionnez le projet, le dossier ou l'organisation dont vous souhaitez afficher les liaisons.
  3. Dans le champ Filtre, saisissez le filtre Application : Appliquée.

Le tableau affiche toutes les règles d'accès utilisateur liées à la ressource.

gcloud

La commande gcloud iam policy-bindings search-target-policy-bindings récupère toutes les liaisons de stratégie d'accès utilisateur qui incluent la ressource.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • BINDING_PARENT_RESOURCE_TYPE : type de la ressource Resource Manager (projet, dossier ou organisation) qui est le parent des liaisons pour la ressource cible. Utilisez la valeur project, folder ou organization.

    Pour savoir quelles ressources sont parentes de quelles liaisons, consultez Ressources compatibles.

  • BINDING_PARENT_RESOURCE_ID : ID du projet, du dossier ou de l'organisation qui est le parent des liaisons pour la ressource cible. Les ID de projet sont des chaînes alphanumériques, telles que my-project. Les ID de dossier et d'organisation sont numériques, tels que 123456789012.
  • TARGET_RESOURCE : ressource dont vous souhaitez lister les liaisons. Pour obtenir la liste des ressources valides, consultez Ressources compatibles.
  • FORMAT : format de la réponse. Utilisez json ou yaml.

Exécutez la commande suivante :

Linux, macOS ou 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 réponse contient toutes les liaisons UAP qui incluent la ressource cible.

{
  "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

La méthode SearchTargetPolicyBindings.search obtient toutes les liaisons UAP qui incluent la ressource.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • BINDING_PARENT_RESOURCE_TYPE : type de la ressource Resource Manager (projet, dossier ou organisation) qui est le parent des liaisons pour la ressource cible. Utilisez la valeur projects, folders ou organizations.

    Pour savoir quelles ressources sont parentes de quelles liaisons, consultez Ressources compatibles.

  • BINDING_PARENT_RESOURCE_ID : ID du projet, du dossier ou de l'organisation qui est le parent des liaisons pour la ressource cible. Les ID de projet sont des chaînes alphanumériques, telles que my-project. Les ID de dossier et d'organisation sont numériques, tels que 123456789012.
  • TARGET_RESOURCE : ressource dont vous souhaitez lister les liaisons. Pour obtenir la liste des ressources valides, consultez Ressources compatibles.

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse contient toutes les liaisons UAP qui incluent la ressource cible.

{
  "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"
    }
  ]
}

Répertorier toutes les liaisons d'un projet, d'un dossier ou d'une organisation

Si vous utilisez la gcloud CLI ou l'API REST IAM pour afficher les liaisons, vous pouvez également lister toutes les liaisons enfants d'un projet, d'un dossier ou d'une organisation spécifiques.

Lister les liaisons d'un projet, d'un dossier ou d'une organisation est semblable à rechercher les liaisons de cette ressource. Toutefois, contrairement à la recherche de liaisons, la liste des liaisons d'une ressource inclut également toutes les liaisons qui sont des enfants immédiats de cette ressource.

Par exemple, imaginez que vous disposez d'une liaison qui associe une stratégie à une passerelle Agent Gateway de l'API Network Services. La ressource parente de cette liaison est le projet parent de l'Agent Gateway. En d'autres termes, la liaison est un enfant immédiat du projet. Par conséquent, si vous listez les liaisons pour ce projet, la réponse inclut la liaison pour la passerelle d'agent. Toutefois, si vous listez les liaisons pour l'organisation parente du projet, la réponse n'inclut pas la liaison. En effet, même si la liaison est un descendant de l'organisation, elle n'est pas un enfant immédiat de l'organisation.

La ressource parente d'une liaison dépend de la ressource cible dans la liaison. Pour en savoir plus, consultez la section Ressources compatibles.

Chaque liaison contient l'ID de la stratégie d'accès utilisateur liée à la ressource. Pour afficher les détails d'une stratégie, utilisez l'ID de la stratégie afin d'obtenir les détails de la stratégie.

Vous pouvez afficher toutes les liaisons enfants d'un projet, d'un dossier ou d'une organisation à l'aide de la gcloud CLI ou de l'API REST IAM.

gcloud

La commande gcloud iam policy-bindings list liste toutes les liaisons UAP qui sont enfants d'une certaine ressource.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • BINDING_PARENT_RESOURCE_TYPE : type de la ressource Resource Manager (projet, dossier ou organisation) dont la liaison est un enfant. Utilisez la valeur project, folder ou organization.

    La ressource parente de la liaison dépend de la ressource cible dans la liaison. Pour en savoir plus, consultez la section Ressources compatibles.

  • BINDING_PARENT_RESOURCE_ID : ID du projet, du dossier ou de l'organisation dont l'association de stratégies est un enfant. Les ID de projet sont des chaînes alphanumériques, telles que my-project. Les ID de dossier et d'organisation sont numériques, tels que 123456789012.
  • FORMAT : format de la réponse. Utilisez json ou yaml.

Exécutez la commande suivante :

Linux, macOS ou 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 réponse contient les liaisons UAP qui sont des enfants de la ressource dans la commande.

{
  "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

La méthode policyBindings.list liste toutes les liaisons UAP qui sont enfants d'une certaine ressource.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • BINDING_PARENT_RESOURCE_TYPE : type de la ressource Resource Manager (projet, dossier ou organisation) dont la liaison est un enfant. Utilisez la valeur projects, folders ou organizations.

    La ressource parente de la liaison dépend de la ressource cible dans la liaison. Pour en savoir plus, consultez la section Ressources compatibles.

  • BINDING_PARENT_RESOURCE_ID : ID du projet, du dossier ou de l'organisation dont l'association de stratégies est un enfant. Les ID de projet sont des chaînes alphanumériques, telles que my-project. Les ID de dossier et d'organisation sont numériques, tels que 123456789012.

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse contient les liaisons UAP qui sont des enfants de la ressource dans la requête.

{
  "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"
    }
  ]
}

Obtenir une liaison pour une stratégie d'accès unifiée

Vous pouvez obtenir les détails d'une liaison à l'aide de la console Google Cloud , de gcloud CLI ou de l'API REST IAM.

Console

  1. Dans la console Google Cloud , accédez à la page Stratégies d'accès unifiées.

    Accéder à la page "Stratégies d'accès unifiées"
  2. Sélectionnez le projet, le dossier ou l'organisation propriétaire de l'UAP dont vous souhaitez afficher les liaisons.
  3. Cliquez sur l'ID de la stratégie UAP dont vous souhaitez afficher les liaisons.
  4. Sélectionnez l'onglet Liaisons.
  5. Recherchez la liaison à l'aide de son ID ou de son nom.

Le tableau affiche les détails de la liaison, y compris l'ID de liaison, le nom de la liaison et la ressource cible dans la liaison.

gcloud

La commande gcloud iam policy-bindings describe obtient une liaison.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • BINDING_ID : ID de la liaison que vous souhaitez obtenir (par exemple, example-binding).
  • BINDING_PARENT_RESOURCE_TYPE : type de la ressource Resource Manager (projet, dossier ou organisation) dont la liaison est un enfant. Utilisez la valeur project, folder ou organization.

    La ressource parente de la liaison dépend de la ressource cible dans la liaison. Pour en savoir plus, consultez la section Ressources compatibles.

  • BINDING_PARENT_RESOURCE_ID : ID du projet, du dossier ou de l'organisation dont l'association de stratégies est un enfant. Les ID de projet sont des chaînes alphanumériques, telles que my-project. Les ID de dossier et d'organisation sont numériques, tels que 123456789012.
  • FORMAT : format de la réponse. Utilisez json ou yaml.

Exécutez la commande suivante :

Linux, macOS ou 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 réponse contient la liaison.

{
  "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

La méthode policyBindings.get obtient une liaison.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • BINDING_PARENT_RESOURCE_TYPE : type de la ressource Resource Manager (projet, dossier ou organisation) dont la liaison est un enfant. Utilisez la valeur projects, folders ou organizations.

    La ressource parente de la liaison dépend de la ressource cible dans la liaison. Pour en savoir plus, consultez la section Ressources compatibles.

  • BINDING_PARENT_RESOURCE_ID : ID du projet, du dossier ou de l'organisation dont l'association de stratégies est un enfant. Les ID de projet sont des chaînes alphanumériques, telles que my-project. Les ID de dossier et d'organisation sont numériques, tels que 123456789012.
  • BINDING_ID : ID de la liaison que vous souhaitez obtenir (par exemple, example-binding).

Méthode HTTP et URL :

GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings/BINDING_ID

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse contient la liaison.

{
  "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"
}

Étapes suivantes