統合アクセス ポリシー(UAP)を使用すると、プリンシパルにGoogle Cloud リソースへのアクセス権を付与したり、アクセスを拒否したりできます。UAP をリソースに適用する必要がなくなった場合は、ポリシーをリソースにバインドするポリシー バインディングを削除できます。ポリシーを、バインドされているすべてのリソースから削除するには、ポリシーを削除します。
始める前に
認証を設定する。
このページのサンプルをどのように使うかに応じて、タブを選択してください。
コンソール
Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。
gcloud
Google Cloud コンソールで Cloud Shell をアクティブにします。
Google Cloud コンソールの下部で Cloud Shell セッションが開始し、コマンドライン プロンプトが表示されます。Cloud Shell はシェル環境です。Google Cloud CLI がすでにインストールされており、現在のプロジェクトの値もすでに設定されています。セッションが初期化されるまで数秒かかることがあります。
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
Google Cloud CLI をインストールします。
外部 ID プロバイダ(IdP)を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。
詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。
省略可: UAP の概要を確認します。
統合アクセス ポリシー バインディングの削除に必要なロール
UAP のバインディングを削除するために必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。
- UAP を所有するリソースに対するアクセス ポリシー ユーザー(
roles/iam.accessPolicyUser)。このロールには、バインディングの削除に必要なiam.accesspolicies.unbind権限が含まれています。 SERVICE.RESOURCE.deletePolicyBinding権限を含むロール。ここで、RESOURCEは UAP がバインドされているリソースタイプ、SERVICEはリソースを所有するサービスです。必要な権限を含むロールを見つけるには、ロールと権限のリファレンスで権限を検索し、権限名をクリックして、その権限を含むロールを確認します。
このロールは、リソースまたはその祖先のいずれかに必要です。
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
統合アクセス ポリシーの削除に必要なロール
UAP の削除に必要な権限を取得するには、削除する UAP を所有するプロジェクト、フォルダ、または組織に対するアクセス ポリシー管理者(roles/iam.accessPolicyAdmin)IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。
この事前定義ロールには、UAP の削除に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
UAP を削除するには、次の権限が必要です。
-
iam.accesspolicies.delete -
Google Cloud コンソールで UAP を削除します。
-
iam.accesspolicies.get -
iam.accessPolicies.list
-
カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。
リソースから統合アクセス ポリシーを削除する
リソースから UAP を削除するには、UAP をリソースにバインドするバインディングを削除します。バインディングを削除すると、UAP はリソースまたはリソースの子孫に適用されなくなります。ただし、UAP は削除されず、他のバインディングは影響を受けません。
プロジェクト、フォルダ、組織のバインディングを削除するには、Google Cloud コンソール、gcloud CLI、または IAM REST API を使用します。他のリソースのバインディングを削除するには、gcloud CLI または IAM REST API を使用する必要があります。
コンソール
-
Google Cloud コンソールで、[統合アクセス ポリシー] ページに移動します。
[統合アクセス ポリシー] に移動 - 削除する UAP を所有するプロジェクト、フォルダ、または組織を選択します。
- 削除する UAP のポリシー ID をクリックします。
- [バインディング] タブを選択します。
- [バインディング] テーブルで、削除するバインディングを含む行を見つけます。
- その行で、 [アクション] メニューをクリックし、[バインディングを削除] をクリックします。
- [バインディングを削除] ダイアログで、[削除] をクリックします。
gcloud
gcloud iam policy-bindings delete コマンドは、バインディングを削除します。
後述のコマンドデータを使用する前に、次のように置き換えます。
-
BINDING_ID: 削除するバインディングの ID(例:example-binding)。 -
BINDING_PARENT_RESOURCE_TYPE: バインディングが子である Resource Manager リソースのタイプ(プロジェクト、フォルダ、組織)。値project、folder、またはorganizationを使用します。バインディングの親リソースは、バインディングのターゲット リソースによって異なります。詳細については、サポート対象のリソースをご覧ください。
-
BINDING_PARENT_RESOURCE_ID: ポリシー バインディングが子であるプロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です(例:my-project)。フォルダ ID と組織 ID は数値です(例:123456789012)。
次のコマンドを実行します。
Linux、macOS、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
レスポンスには、リクエストを表す長時間実行オペレーションが含まれます。長時間実行オペレーションのステータスを取得する方法については、このページの長時間実行オペレーションのステータスを確認するをご覧ください。
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
policyBindings.delete メソッドは、バインディングを削除します。
リクエストのデータを使用する前に、次のように置き換えます。
-
BINDING_PARENT_RESOURCE_TYPE: バインディングが子である Resource Manager リソースのタイプ(プロジェクト、フォルダ、組織)。値projects、folders、またはorganizationsを使用します。バインディングの親リソースは、バインディングのターゲット リソースによって異なります。詳細については、サポート対象のリソースをご覧ください。
-
BINDING_PARENT_RESOURCE_ID: ポリシー バインディングが子であるプロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です(例:my-project)。フォルダ ID と組織 ID は数値です(例:123456789012)。 -
BINDING_ID: 削除するバインディングの ID(例:example-binding)。
HTTP メソッドと URL:
DELETE https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings/BINDING_ID
リクエストを送信するには、次のいずれかのオプションを展開します。
レスポンスには、リクエストを表す長時間実行オペレーションが含まれます。長時間実行オペレーションのステータスを取得する方法については、このページの長時間実行オペレーションのステータスを確認するをご覧ください。
{
"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
}
統合アクセス ポリシーを削除する
UAP を削除する前に、UAP を参照する既存のバインディングをすべて特定して削除します。既存のバインディングを削除せずに UAP を削除しようとすると、エラーが発生します。
既存のバインディングを削除せずに UAP を削除する場合は、UAP を強制的に削除できます。UAP を強制的に削除すると、バインドされているすべてのリソースから UAP が削除されます。UAP を参照するバインディングは最終的に削除されます。ただし、それらのバインディングは、削除されるまで、1 つのリソースを参照できるバインディング数の上限に引き続きカウントされます。
UAP は、 Google Cloud コンソール、gcloud CLI、または IAM REST API を使用して削除できます。
コンソール
-
Google Cloud コンソールで、[統合アクセス ポリシー] ページに移動します。
[統合アクセス ポリシー] に移動 - 削除する UAP を所有するプロジェクト、フォルダ、または組織を選択します。
- 削除する UAP のポリシー ID をクリックします。
- [ ポリシーを削除] をクリックします。
- UAP に既存のバインディングがある場合は、[このポリシーとそのすべてのバインディングを削除する] を選択します。このオプションを選択せずに、既存のバインディングを持つ UAP を削除しようとすると、リクエストは失敗します。
- [ポリシーの削除] ダイアログで、[削除] をクリックします。
gcloud
gcloud iam access-policies delete コマンドは、UAP とそれに関連付けられているすべてのバインディングを削除します。
後述のコマンドデータを使用する前に、次のように置き換えます。
-
UAP_ID: 削除する UAP の ID(例:example-policy)。 -
UAP_PARENT_RESOURCE_TYPE: 削除する UAP を所有する Resource Manager リソース(プロジェクト、フォルダ、組織)のタイプ。値project、folder、またはorganizationを使用します。 -
UAP_PARENT_RESOURCE_ID: 削除する UAP を所有するプロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です(例:my-project)。フォルダ ID と組織 ID は数値です(例:123456789012)。 -
FORCE_FLAG: 省略可。既存のバインディングでポリシーが参照されている場合でも、そのポリシーをコマンドによって強制的に削除するには、--forceフラグを使用します。このフラグが設定されていない場合に、既存のバインディングでポリシーが参照されていると、コマンドは失敗します。
次のコマンドを実行します。
Linux、macOS、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
レスポンスには、リクエストを表す長時間実行オペレーションが含まれます。長時間実行オペレーションのステータスを取得する方法については、このページの長時間実行オペレーションのステータスを確認するをご覧ください。
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
accessPolicies.delete メソッドは、UAP とそれに関連するすべてのバインディングを削除します。
リクエストのデータを使用する前に、次のように置き換えます。
-
UAP_PARENT_RESOURCE_TYPE: 削除する UAP を所有する Resource Manager リソース(プロジェクト、フォルダ、組織)のタイプ。値projects、folders、またはorganizationsを使用します。 -
UAP_PARENT_RESOURCE_ID: 削除する UAP を所有するプロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です(例:my-project)。フォルダ ID と組織 ID は数値です(例:123456789012)。 -
UAP_ID: 削除する UAP の ID(例:example-policy)。 -
FORCE_DELETE: 省略可。既存のバインディングでポリシーが参照されている場合でも、そのポリシーをリクエストによって強制的に削除するには、クエリ パラメータforce=trueを追加します。このクエリ パラメータが設定されていない場合に、既存のバインディングでポリシーが参照されていると、リクエストは失敗します。
HTTP メソッドと URL:
DELETE https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID?FORCE_DELETE
リクエストを送信するには、次のいずれかのオプションを展開します。
レスポンスには、リクエストを表す長時間実行オペレーションが含まれます。長時間実行オペレーションのステータスを取得する方法については、このページの長時間実行オペレーションのステータスを確認するをご覧ください。
{
"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
}
長時間実行オペレーションのステータスを確認する
REST API またはクライアント ライブラリを使用する場合、ポリシーまたはバインディングを変更するメソッドで長時間実行オペレーション(LRO)が返されます。長時間実行オペレーションは、リクエストのステータスを追跡し、ポリシーまたはバインディングの変更が完了したかどうかを示します。
REST
operations.get メソッドは、長時間実行オペレーションのステータスを返します。
リクエストのデータを使用する前に、次のように置き換えます。
-
OPERATION_NAME: オペレーションの完全な名前。この名前は、元のリクエストに対するレスポンスで受け取ります。オペレーション名の形式は次のとおりです。
RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
HTTP メソッドと URL:
GET https://iam.googleapis.com/v3/OPERATION_NAME
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
{
"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
}
}
オペレーションの done フィールドが存在しない場合は、オペレーションを繰り返し取得して、ステータスのモニタリングを続行します。各リクエストの間には、切り捨て型指数バックオフを使用して遅延時間を設けてください。done フィールドが true に設定されている場合、オペレーションは完了しており、オペレーションの取得を停止できます。