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 . Si vous ne souhaitez plus qu'une règle d'accès utilisateur s'applique à une ressource, vous pouvez supprimer la liaison de stratégie qui lie la stratégie à la ressource. Si vous souhaitez supprimer une stratégie de toutes les ressources auxquelles elle est associée, vous pouvez la supprimer.
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 supprimer des liaisons de stratégie d'accès unifiée
Pour obtenir les autorisations nécessaires pour supprimer une liaison pour une UAP, demandez à votre administrateur de vous accorder les rôles IAM suivants :
- Utilisateur de règles d'accès (
roles/iam.accessPolicyUser) sur la ressource propriétaire de la règle d'accès utilisateur. Ce rôle inclut l'autorisationiam.accesspolicies.unbind, qui est requise pour supprimer des liaisons. Un rôle incluant l'autorisation
SERVICE.RESOURCE.deletePolicyBinding, oùRESOURCEest le type de ressource auquel la règle d'accès utilisateur est liée 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.
Rôles requis pour supprimer des stratégies d'accès unifiées
Pour obtenir les autorisations nécessaires pour supprimer des règles d'accès utilisateur, demandez à votre administrateur de vous accorder le rôle IAM Administrateur des règles d'accès (roles/iam.accessPolicyAdmin) sur le projet, le dossier ou l'organisation propriétaire de la règle d'accès utilisateur que vous souhaitez supprimer.
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 supprimer des UAP. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Les autorisations suivantes sont requises pour supprimer des UAP :
-
iam.accesspolicies.delete -
Supprimez les UAP dans la console Google Cloud :
-
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.
Supprimer une stratégie d'accès unifiée d'une ressource
Pour supprimer une stratégie d'accès utilisateur d'une ressource, supprimez la liaison qui associe la stratégie d'accès utilisateur à la ressource. Une fois la liaison supprimée, la règle d'administration de l'utilisateur ne s'applique plus à la ressource ni à ses descendants. Toutefois, l'UAP n'est pas supprimée et aucune de ses autres liaisons n'est affectée.
Vous pouvez supprimer des liaisons pour des projets, des dossiers et des organisations à l'aide de laGoogle Cloud console, de la gcloud CLI ou de l'API REST IAM. Pour supprimer les liaisons 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 stratégie d'accès utilisateur que vous souhaitez supprimer.
- Cliquez sur l'ID de la règle d'accès utilisateur que vous souhaitez supprimer.
- Sélectionnez l'onglet Liaisons.
- Dans le tableau Liaisons, recherchez la ligne contenant la liaison que vous souhaitez supprimer.
- Sur cette ligne, cliquez sur le menu Actions, puis sur Supprimer la liaison.
- Dans la boîte de dialogue Supprimer la liaison, cliquez sur Supprimer.
gcloud
La commande gcloud iam policy-bindings delete supprime 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 supprimer (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.
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud iam policy-bindings delete BINDING_ID \ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
Windows (PowerShell)
gcloud iam policy-bindings delete BINDING_ID ` --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
Windows (cmd.exe)
gcloud iam policy-bindings delete BINDING_ID ^ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
La 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.
Delete request issued for: [example-binding] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374724030-6181fcd1520c5-d21b0a12-b704e1ce] to complete...done. Deleted policyBinding [example-binding].
REST
La méthode policyBindings.delete supprime 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 supprimer (par exemple,example-binding).
Méthode HTTP et URL :
DELETE 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 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-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-binding",
"verb": "delete",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
Supprimer une stratégie d'accès unifiée
Avant de supprimer une règle d'accès utilisateur, identifiez et supprimez toutes les liaisons existantes qui y font référence. Les tentatives de suppression d'une UAP sans supprimer les liaisons existantes entraînent une erreur.
Si vous souhaitez supprimer une UAP sans supprimer les liaisons existantes, vous pouvez forcer la suppression de l'UAP. La suppression forcée d'une stratégie d'accès utilisateur la supprime de toutes les ressources auxquelles elle est liée. Toutes les liaisons qui font référence à l'UAP seront supprimées. Toutefois, tant qu'elles ne sont pas supprimées, les liaisons sont toujours comptabilisées dans la limite du nombre de liaisons pouvant faire référence à une seule ressource.
Vous pouvez supprimer des stratégies d'accès utilisateur à 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 de la règle d'accès utilisateur que vous souhaitez supprimer.
- Cliquez sur l'ID de la stratégie d'accès utilisateur que vous souhaitez supprimer.
- Cliquez sur Supprimer la règle.
- Si la règle d'accès utilisateur comporte des liaisons existantes, sélectionnez Supprimer cette stratégie et toutes ses liaisons. Si vous essayez de supprimer une stratégie d'accès utilisateur avec des liaisons existantes sans sélectionner cette option, la requête échoue.
- Dans la boîte de dialogue Supprimer la règle, cliquez sur Supprimer.
gcloud
La commande gcloud iam access-policies delete supprime une stratégie d'accès utilisateur et toutes les liaisons associées.
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 que vous souhaitez supprimer (par exemple,example-policy). -
UAP_PARENT_RESOURCE_TYPE: type de la ressource Resource Manager (projet, dossier ou organisation) propriétaire de la règle d'accès utilisateur que vous souhaitez supprimer. 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 supprimer. 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. -
FORCE_FLAG: facultatif. Pour forcer la commande à supprimer une stratégie, même si elle est référencée dans des liaisons existantes, utilisez l'option--force. Si cet indicateur n'est pas défini et que la stratégie est référencée dans des liaisons existantes, la commande échoue.
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud iam access-policies delete UAP_ID \ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global \ FORCE_FLAG
Windows (PowerShell)
gcloud iam access-policies delete UAP_ID ` --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global ` FORCE_FLAG
Windows (cmd.exe)
gcloud iam access-policies delete UAP_ID ^ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global ^ FORCE_FLAG
La 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.
Delete request issued for: [example-policy] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete...done. Deleted accessPolicy [example-policy].
REST
La méthode accessPolicies.delete supprime une stratégie d'accès utilisateur et toutes les liaisons associées.
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 la règle d'accès utilisateur que vous souhaitez supprimer. 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 supprimer. 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 que vous souhaitez supprimer (par exemple,example-policy). -
FORCE_DELETE: facultatif. Pour forcer la requête à supprimer la stratégie, même si elle est référencée dans des liaisons existantes, ajoutez le paramètre de requêteforce=true. Si ce paramètre de requête n'est pas défini et que la stratégie est référencée dans des liaisons existantes, la requête échoue.
Méthode HTTP et URL :
DELETE https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID?FORCE_DELETE
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-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"verb": "delete",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
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
- Créer et appliquer des règles d'accès utilisateur
- Afficher les règles d'accès utilisateur et les liaisons
- Modifier les règles d'accès des utilisateurs et les liaisons