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 créer et appliquer des stratégies d'accès utilisateur.
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 créer des stratégies d'accès unifiées
Pour obtenir les autorisations nécessaires pour créer des règles d'accès utilisateur, demandez à votre administrateur de vous accorder le rôle IAM Administrateur de règles d'accès (roles/iam.accessPolicyAdmin) sur le projet, le dossier ou l'organisation où vous souhaitez créer la règle.
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 créer des UAP. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Les autorisations suivantes sont requises pour créer des règles d'accès utilisateur :
-
iam.accesspolicies.create -
Créez des règles d'accès utilisateur dans la console Google Cloud :
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 appliquer des stratégies d'accès unifiées
Pour obtenir les autorisations nécessaires pour lier une UAP à une ressource, demandez à votre administrateur de vous accorder les rôles IAM suivants :
- Administrateur de règles d'accès (
roles/iam.accessPolicyAdmin) sur la ressource propriétaire de l'UAP. Ce rôle contient l'autorisationiam.accesspolicies.bind, qui est requise pour créer des liaisons. Un rôle incluant l'autorisation
SERVICE.RESOURCE.createPolicyBinding, oùRESOURCEest le type de ressource auquel vous souhaitez lier la stratégie etSERVICEest 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 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.
Créer une stratégie d'accès unifiée
Vous pouvez créer des UAP à 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 dans lequel vous souhaitez créer la règle d'accès utilisateur. Pour savoir où créer une règle d'accès utilisateur, consultez Où créer des règles d'accès utilisateur.
- Cliquez sur Créer une règle.
-
Dans le champ Nom de la règle, saisissez un nom pour la règle d'accès utilisateur (par exemple,
Example policy). Le nom ne peut pas comporter plus de 63 caractères. - (Facultatif) Dans le champ ID de la stratégie, personnalisez l'ID de la stratégie d'accès utilisateur.
-
Ajoutez des règles à la stratégie. Pour chaque règle, procédez comme suit :
- Facultatif : Dans le champ Description, saisissez une description de la règle.
- Dans le champ Comptes principaux, saisissez les comptes principaux que vous souhaitez inclure dans la règle.
- Facultatif : Dans le champ Comptes principaux exclus, saisissez les comptes principaux que vous ne souhaitez pas inclure dans la règle. Ces comptes principaux ne seront pas inclus, même s'ils font partie d'un groupe dans le champ Comptes principaux.
-
Sélectionnez l'effet que vous souhaitez que la règle ait :
- Pour accorder les autorisations spécifiées aux comptes principaux spécifiés, sélectionnez l'effet Autoriser.
- Pour empêcher les comptes principaux spécifiés d'utiliser les autorisations spécifiées, sélectionnez l'effet Refuser.
-
Sélectionnez les autorisations à inclure dans la règle :
- Pour les règles avec l'effet Autoriser, vous pouvez spécifier les rôles et les autorisations à inclure ou à exclure de la règle. Pour en savoir plus sur les rôles et les autorisations que vous pouvez inclure, consultez Rôles et autorisations dans les règles d'UAP.
- Pour les règles avec l'effet Refuser, spécifiez les autorisations que vous souhaitez inclure ou exclure de la règle. Pour en savoir plus sur les autorisations que vous pouvez inclure, consultez Rôles et autorisations dans les règles UAP.
-
Facultatif : ajoutez les conditions dans lesquelles la règle s'applique. Pour en savoir plus sur les attributs de condition compatibles, consultez Conditions dans les règles d'accès utilisateur.
- Lorsque vous avez terminé de modifier la règle, cliquez sur OK.
- Pour ajouter une autre règle, cliquez sur Ajouter une règle, puis ajoutez les détails de la règle.
- Lorsque vous avez terminé d'ajouter des règles, cliquez sur Créer une stratégie.
gcloud
La commande gcloud iam access-policies create crée une règle d'accès utilisateur.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
-
UAP_ID: Identifiant unique de l'UAP (par exemple,example-policy). -
UAP_PARENT_RESOURCE_TYPE: type de la ressource Resource Manager (projet, dossier ou organisation) dans laquelle vous souhaitez créer la stratégie d'accès utilisateur. Utilisez la valeurproject,folderouorganization. -
UAP_PARENT_RESOURCE_ID: ID du projet, du dossier ou de l'organisation dans lequel vous souhaitez créer la règle d'accès utilisateur. 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. DISPLAY_NAME: facultatif. Description lisible par l'humain de la stratégie d'accès des utilisateurs (par exemple,Example policy). Le nom à afficher ne peut pas comporter plus de 63 caractères.-
FILE_PATH: chemin d'accès à un fichier JSON contenant les détails de la règle UAP. Chaque règle doit respecter le format suivant :{ "description": "DESCRIPTION", "effect": "EFFECT", "principals": [ INCLUDED_PRINCIPALS ], "excludedPrincipals": [ EXCLUDED_PRINCIPALS ], "operation": { "permissions": [ INCLUDED_PERMISSIONS ], "excludedPermissions": [ EXCLUDED_PERMISSIONS ] }, CONDITIONS }
Remplacez les valeurs suivantes :
-
DESCRIPTION: description de la règle dans un format lisible par l'humain. -
EFFECT: impact de la règle sur l'accès. Les valeurs acceptées sontALLOWetDENY:-
ALLOW: accorde les autorisations spécifiées aux comptes principaux spécifiés. -
DENY: empêche les comptes principaux spécifiés d'utiliser les autorisations spécifiées.
-
-
Remplacez les valeurs suivantes pour spécifier les comptes principaux inclus dans la règle :
-
INCLUDED_PRINCIPALS: comptes principaux à inclure dans la règle. -
EXCLUDED_PRINCIPALS: facultatif. Comptes principaux à exclure de la règle, même s'ils figurent dans la liste des comptes principaux inclus. Par exemple, vous pouvez ajouter un groupe Google à la liste des comptes principaux inclus, puis exclure des utilisateurs spécifiques appartenant à ce groupe.
Pour obtenir la liste des identifiants de comptes principaux compatibles, consultez Types de comptes principaux pour les UAP.
-
-
Remplacez les valeurs suivantes pour spécifier les autorisations à inclure dans la règle :
-
INCLUDED_PERMISSIONS: autorisations à inclure dans la règle. -
EXCLUDED_PERMISSIONS: facultatif. Autorisations à exclure de la règle, même si elles figurent dans la liste des autorisations incluses. Par exemple, vous pouvez ajouter un rôle à la liste des autorisations incluses, puis exclure des autorisations spécifiques de ce rôle.
Lorsque vous créez ces listes d'autorisations, vous pouvez référencer des noms d'autorisations, des noms de rôles et des groupes d'autorisations. Pour en savoir plus, consultez Rôles et autorisations dans les règles UAP.
-
-
CONDITIONS: facultatif. Conditions dans lesquelles la règle s'applique. Utilisez le format suivant :"conditions": { "SERVICE": { "title": "CONDITION_TITLE", "description": "CONDITION_DESCRIPTION", "expression": "CONDITION_EXPRESSION" } }
Remplacez les valeurs suivantes :
-
SERVICE: service qui fournit les attributs utilisés dans l'expression de condition. -
CONDITION_TITLE: facultatif. Un bref résumé de l'objectif de la condition. -
CONDITION_DESCRIPTION: facultatif. Une description plus longue de la condition. -
CONDITION_EXPRESSION: expression booléenne faisant référence aux attributs de la tentative d'accès, tels que les tags associés à la ressource dans la tentative d'accès. Si l'expression renvoietrue, la règle s'applique à la tentative d'accès. Si elle renvoiefalse, la règle ne s'applique pas à la tentative d'accès.
Pour obtenir la liste des attributs compatibles et de leurs services, consultez Attributs de condition compatibles.
-
-
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud iam access-policies create UAP_ID \ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \ --location=global --display-name=DISPLAY_NAME \ --details-rules=FILE_PATH
Windows (PowerShell)
gcloud iam access-policies create UAP_ID ` --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ` --location=global --display-name=DISPLAY_NAME ` --details-rules=FILE_PATH
Windows (cmd.exe)
gcloud iam access-policies create UAP_ID ^ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^ --location=global --display-name=DISPLAY_NAME ^ --details-rules=FILE_PATH
La réponse contient une opération de longue durée représentant votre requête. Pour savoir comment obtenir l'état d'une opération de longue durée, consultez la section Vérifier l'état d'une opération de longue durée sur cette page.
Create request issued for: [example-policy] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715373988044-6181fa136df85-3b06a30a-4816d25b] to complete...done. Created accessPolicy [example-policy].
REST
La méthode accessPolicies.create crée une stratégie d'accès utilisateur.
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) dans laquelle vous souhaitez créer la stratégie d'accès utilisateur. Utilisez la valeurprojects,foldersouorganizations. -
UAP_PARENT_RESOURCE_ID: ID du projet, du dossier ou de l'organisation dans lequel vous souhaitez créer la règle d'accès utilisateur. 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: Identifiant unique de l'UAP (par exemple,example-policy). DISPLAY_NAME: facultatif. Description lisible par l'humain de la stratégie d'accès des utilisateurs (par exemple,Example policy). Le nom à afficher ne peut pas comporter plus de 63 caractères.-
UAP_RULES: liste de règles UAP, qui définissent l'accès à accorder ou à refuser, ainsi que les comptes principaux auxquels accorder ou refuser l'accès. Un UAP peut comporter jusqu'à 100 règles. Chaque règle a le format suivant :{ "description": "DESCRIPTION", "effect": "EFFECT", "principals": [ INCLUDED_PRINCIPALS ], "excludedPrincipals": [ EXCLUDED_PRINCIPALS ], "operation": { "permissions": [ INCLUDED_PERMISSIONS ], "excludedPermissions": [ EXCLUDED_PERMISSIONS ] }, CONDITIONS }
Remplacez les valeurs suivantes :
-
DESCRIPTION: description de la règle dans un format lisible par l'humain. -
EFFECT: impact de la règle sur l'accès. Les valeurs acceptées sontALLOWetDENY:-
ALLOW: accorde les autorisations spécifiées aux comptes principaux spécifiés. -
DENY: empêche les comptes principaux spécifiés d'utiliser les autorisations spécifiées.
-
-
Remplacez les valeurs suivantes pour spécifier les comptes principaux inclus dans la règle :
-
INCLUDED_PRINCIPALS: comptes principaux à inclure dans la règle. -
EXCLUDED_PRINCIPALS: facultatif. Comptes principaux à exclure de la règle, même s'ils figurent dans la liste des comptes principaux inclus. Par exemple, vous pouvez ajouter un groupe Google à la liste des comptes principaux inclus, puis exclure des utilisateurs spécifiques appartenant à ce groupe.
Pour obtenir la liste des identifiants de comptes principaux compatibles, consultez Types de comptes principaux pour les UAP.
-
-
Remplacez les valeurs suivantes pour spécifier les autorisations à inclure dans la règle :
-
INCLUDED_PERMISSIONS: autorisations à inclure dans la règle. -
EXCLUDED_PERMISSIONS: facultatif. Autorisations à exclure de la règle, même si elles figurent dans la liste des autorisations incluses. Par exemple, vous pouvez ajouter un rôle à la liste des autorisations incluses, puis exclure des autorisations spécifiques de ce rôle.
Lorsque vous créez ces listes d'autorisations, vous pouvez référencer des noms d'autorisations, des noms de rôles et des groupes d'autorisations. Pour en savoir plus, consultez Rôles et autorisations dans les règles UAP.
-
-
CONDITIONS: facultatif. Conditions dans lesquelles la règle s'applique. Utilisez le format suivant :"conditions": { "SERVICE": { "title": "CONDITION_TITLE", "description": "CONDITION_DESCRIPTION", "expression": "CONDITION_EXPRESSION" } }
Remplacez les valeurs suivantes :
-
SERVICE: service qui fournit les attributs utilisés dans l'expression de condition. -
CONDITION_TITLE: facultatif. Un bref résumé de l'objectif de la condition. -
CONDITION_DESCRIPTION: facultatif. Une description plus longue de la condition. -
CONDITION_EXPRESSION: expression booléenne faisant référence aux attributs de la tentative d'accès, tels que les tags associés à la ressource dans la tentative d'accès. Si l'expression renvoietrue, la règle s'applique à la tentative d'accès. Si elle renvoiefalse, la règle ne s'applique pas à la tentative d'accès.
Pour obtenir la liste des attributs compatibles et de leurs services, consultez Attributs de condition compatibles.
-
-
Méthode HTTP et URL :
POST https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies?accessPolicyId=UAP_ID
Corps JSON de la requête :
{
"displayName": "DISPLAY_NAME",
"details": {
"rules": [
UAP_RULES
]
}
}
Pour envoyer votre requête, développez l'une des options suivantes :
La réponse contient une opération de longue durée représentant votre requête. Pour savoir comment obtenir l'état d'une opération de longue durée, consultez la section Vérifier l'état d'une opération de longue durée sur cette page.
{
"name": "organizations/123456789012/locations/global/operations/operation-1715373120647-6181f6d8371d2-83309b71-2b8a7532",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:32:00.898809495Z",
"target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
Appliquer une stratégie d'accès unifiée à une ressource
Pour appliquer une règle d'accès utilisateur à une ressource, vous devez créer une liaison. Une fois que vous avez créé une liaison pour une stratégie, les règles de cette stratégie s'appliquent à la ressource spécifiée, ainsi qu'à tous ses descendants.
Avant de créer une liaison, assurez-vous que la contrainte de règle d'administration iam.managed.disableAccessPolicyBinding est désactivée. Pour savoir comment activer ou désactiver cette contrainte, consultez Utiliser des contraintes gérées dans une règle d'administration.
Vous pouvez appliquer des règles d'accès utilisateur aux projets, dossiers et organisations à l'aide de la console Google Cloud , de la gcloud CLI ou de l'API REST IAM. Pour appliquer des règles d'accès utilisateur à d'autres ressources, vous devez utiliser la gcloud CLI ou 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 la règle d'accès utilisateur que vous souhaitez appliquer.
- Cliquez sur l'ID de la règle d'accès utilisateur que vous souhaitez appliquer.
- Sélectionnez l'onglet Liaisons, puis cliquez sur Ajouter une liaison.
-
Dans le volet Ajouter une liaison, modifiez les détails de la liaison :
- Dans le menu Emplacement de la liaison, sélectionnez la ressource à laquelle vous souhaitez appliquer la règle d'accès utilisateur.
-
Facultatif : Dans le champ Nom à afficher de la liaison, saisissez une description lisible par l'humain de la liaison (par exemple,
Example binding). Le nom à afficher ne peut pas comporter plus de 63 caractères. -
Dans le champ ID de la liaison, saisissez un nom unique pour la liaison, par exemple
example-binding.
- Cliquez sur Ajouter une liaison.
gcloud
La commande gcloud iam policy-bindings create crée une liaison.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
-
BINDING_ID: nom unique de la liaison, par exempleexample-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. -
POLICY_PARENT_RESOURCE: ressource où la règle d'accès utilisateur a été créée, au formatRESOURCE_TYPE/RESOURCE_ID. Exemple :organizations/0123456789012. Les règles d'accès utilisateur peuvent être créées dans des projets, des dossiers ou des organisations. Les ID de dossier et les ID d'organisation doivent être numériques. Les ID de projet peuvent être numériques ou alphanumériques. -
UAP_ID: ID de la stratégie d'accès utilisateur que vous souhaitez lier à la ressource (par exemple,example-uap). Vous ne pouvez pas modifier cette valeur après avoir créé la liaison. -
TARGET_RESOURCE: ressource à laquelle vous souhaitez lier la règle d'accès utilisateur. Pour obtenir la liste des ressources valides, consultez Ressources compatibles. Vous ne pouvez pas modifier cette valeur après avoir créé la liaison. DISPLAY_NAME: facultatif. Description lisible par l'humain de la liaison (par exemple,Example binding). Le nom à afficher ne peut pas comporter plus de 63 caractères.
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud iam policy-bindings create BINDING_ID \ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global \ --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" \ --target-resource=TARGET_RESOURCE \ --display-name=DISPLAY_NAME
Windows (PowerShell)
gcloud iam policy-bindings create BINDING_ID ` --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global ` --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" ` --target-resource=TARGET_RESOURCE ` --display-name=DISPLAY_NAME
Windows (cmd.exe)
gcloud iam policy-bindings create BINDING_ID ^ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global ^ --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" ^ --target-resource=TARGET_RESOURCE ^ --display-name=DISPLAY_NAME
La réponse contient une opération de longue durée représentant votre requête. Pour savoir comment obtenir l'état d'une opération de longue durée, consultez la section Vérifier l'état d'une opération de longue durée sur cette page.
Create request issued for: [example-binding] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374545618-6181fc272c6f9-55ff07f4-97d0ac76] to complete...done. Created policyBinding [example-binding].
REST
La méthode policyBindings.create crée 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: nom unique de la liaison, par exempleexample-binding. DISPLAY_NAME: facultatif. Description lisible par l'humain de la liaison (par exemple,Example binding). Le nom à afficher ne peut pas comporter plus de 63 caractères.-
TARGET_RESOURCE: ressource à laquelle vous souhaitez lier la règle d'accès utilisateur. Pour obtenir la liste des ressources valides, consultez Ressources compatibles. Vous ne pouvez pas modifier cette valeur après avoir créé la liaison. -
POLICY_PARENT_RESOURCE: ressource où la règle d'accès utilisateur a été créée, au formatRESOURCE_TYPE/RESOURCE_ID. Exemple :organizations/0123456789012. Les règles d'accès utilisateur peuvent être créées dans des projets, des dossiers ou des organisations. Les ID de dossier et les ID d'organisation doivent être numériques. Les ID de projet peuvent être numériques ou alphanumériques. -
UAP_ID: ID de la stratégie d'accès utilisateur que vous souhaitez lier à la ressource (par exemple,example-uap). Vous ne pouvez pas modifier cette valeur après avoir créé la liaison.
Méthode HTTP et URL :
POST https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings?policyBindingId=BINDING_ID
Corps JSON de la requête :
{
"displayName": "DISPLAY_NAME",
"target": {
"resource": "TARGET_RESOURCE"
},
"policyKind": "ACCESS",
"policy": "POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID"
}
Pour envoyer votre requête, développez l'une des options suivantes :
La réponse contient une opération de longue durée représentant votre requête. Pour savoir comment obtenir l'état d'une opération de longue durée, consultez la section Vérifier l'état d'une opération de longue durée sur cette page.
{
"name": "organizations/123456789012/locations/global/operations/operation-1715373120647-6181f6d8371d2-83309b71-2b8a7532",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:32:00.898809495Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-binding",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
Vérifier l'état d'une opération de longue durée
Lorsque vous utilisez l'API REST ou les bibliothèques clientes, toute méthode modifiant une stratégie ou une liaison renvoie une opération de longue durée (LRO). L'opération de longue durée suit l'état de la requête et indique si la modification de la stratégie ou de la liaison est terminée.
REST
La méthode operations.get renvoie l'état d'une opération de longue durée.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
-
OPERATION_NAME: nom complet de l'opération. Vous recevez ce nom dans la réponse à votre requête d'origine.Le nom de l'opération est au format suivant :
RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
Méthode HTTP et URL :
GET https://iam.googleapis.com/v3/OPERATION_NAME
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{
"name": "organizations/314340013352/locations/global/operations/operation-1732752311821-627edd607a3df-9a62cdea-2a7d9f07",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2024-11-28T00:05:12.006289686Z",
"endTime": "2024-11-28T00:05:12.192141801Z",
"target": "organizations/314340013352/locations/global/POLICY_TYPE/POLICY_ID",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": true,
"response": {
POLICY
}
}
Si le champ done de l'opération n'est pas présent, continuez à surveiller son état en récupérant l'opération de manière répétée. Utilisez une temporisation de retransmission exponentielle tronquée pour introduire un délai entre chaque requête. Lorsque le champ done est défini sur true, l'opération est terminée et vous pouvez cesser de l'obtenir.
Étapes suivantes
- Afficher les règles d'accès utilisateur et les liaisons
- Modifier les règles d'accès des utilisateurs et les liaisons
- Supprimer des UAP