Supprimer des 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 . 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

  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 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'autorisation iam.accesspolicies.unbind, qui est requise pour supprimer des liaisons.
  • Un rôle incluant l'autorisation SERVICE.RESOURCE.deletePolicyBinding, où RESOURCE est le type de ressource auquel la règle d'accès utilisateur est liée 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 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

  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 la stratégie d'accès utilisateur que vous souhaitez supprimer.
  3. Cliquez sur l'ID de la règle d'accès utilisateur que vous souhaitez supprimer.
  4. Sélectionnez l'onglet Liaisons.
  5. Dans le tableau Liaisons, recherchez la ligne contenant la liaison que vous souhaitez supprimer.
  6. Sur cette ligne, cliquez sur le menu Actions, puis sur Supprimer la liaison.
  7. 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 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.

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

  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 la règle d'accès utilisateur que vous souhaitez supprimer.
  3. Cliquez sur l'ID de la stratégie d'accès utilisateur que vous souhaitez supprimer.
  4. Cliquez sur Supprimer la règle.
  5. 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.
  6. 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 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 supprimer. 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.
  • 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 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 supprimer. 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 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ête force=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