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
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.
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 .
-
Vérifiez que la facturation est activée pour votre projet Google Cloud .
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 :
-
Afficher les liaisons dans un projet : Administrateur IAM de projet (
roles/resourcemanager.projectIamAdmin) -
Afficher les liaisons dans un dossier : Administrateur IAM du dossier (
roles/resourcemanager.folderIamAdmin) -
Afficher les liaisons dans une organisation : Administrateur de l'organisation (
roles/resourcemanager.organizationAdmin)
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
-
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" - 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 valeurproject,folderouorganization. -
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 quemy-project. Les ID de dossier et d'organisation sont numériques, tels que123456789012. FORMAT: format de la réponse. Utilisezjsonouyaml.
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 valeurprojects,foldersouorganizations. -
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 quemy-project. Les ID de dossier et d'organisation sont numériques, tels que123456789012.
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
-
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" - Sélectionnez le projet, le dossier ou l'organisation propriétaire de l'UAP dont vous souhaitez afficher les détails.
- 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 valeurproject,folderouorganization. -
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 quemy-project. Les ID de dossier et d'organisation sont numériques, tels que123456789012. FORMAT: format de la réponse. Utilisezjsonouyaml.
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 valeurprojects,foldersouorganizations. -
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 quemy-project. Les ID de dossier et d'organisation sont numériques, tels que123456789012. -
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 :
- Lister les liaisons d'un UAP : affichez toutes les liaisons qui incluent un UAP spécifique.
- Lister les liaisons d'une ressource : affichez toutes les liaisons qui incluent une ressource cible spécifique.
- Répertorier toutes les liaisons d'un projet, d'un dossier ou d'une organisation : affichez toutes les liaisons associées à un projet, un dossier ou une organisation spécifique.
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
-
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" - Sélectionnez le projet, le dossier ou l'organisation propriétaire de l'UAP dont vous souhaitez afficher les liaisons.
- Cliquez sur l'ID de la stratégie UAP dont vous souhaitez afficher les liaisons.
- 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 valeurproject,folderouorganization. -
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 quemy-project. Les ID de dossier et d'organisation sont numériques, tels que123456789012. FORMAT: format de la réponse. Utilisezjsonouyaml.
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 valeurprojects,foldersouorganizations. -
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 quemy-project. Les ID de dossier et d'organisation sont numériques, tels que123456789012. -
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
-
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" - Sélectionnez le projet, le dossier ou l'organisation dont vous souhaitez afficher les liaisons.
- 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 valeurproject,folderouorganization.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 quemy-project. Les ID de dossier et d'organisation sont numériques, tels que123456789012. -
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. Utilisezjsonouyaml.
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 valeurprojects,foldersouorganizations.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 quemy-project. Les ID de dossier et d'organisation sont numériques, tels que123456789012. -
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 valeurproject,folderouorganization.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 quemy-project. Les ID de dossier et d'organisation sont numériques, tels que123456789012. FORMAT: format de la réponse. Utilisezjsonouyaml.
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 valeurprojects,foldersouorganizations.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 quemy-project. Les ID de dossier et d'organisation sont numériques, tels que123456789012.
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
-
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" - Sélectionnez le projet, le dossier ou l'organisation propriétaire de l'UAP dont vous souhaitez afficher les liaisons.
- Cliquez sur l'ID de la stratégie UAP dont vous souhaitez afficher les liaisons.
- Sélectionnez l'onglet Liaisons.
- 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 valeurproject,folderouorganization.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 quemy-project. Les ID de dossier et d'organisation sont numériques, tels que123456789012. FORMAT: format de la réponse. Utilisezjsonouyaml.
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 valeurprojects,foldersouorganizations.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 quemy-project. Les ID de dossier et d'organisation sont numériques, tels que123456789012. -
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
- Créer et appliquer des règles d'accès utilisateur
- Modifier les règles d'accès des utilisateurs et les liaisons
- Supprimer les règles d'accès utilisateur et les liaisons