統合アクセス ポリシーを表示する

統合アクセス ポリシー(UAP)を使用すると、プリンシパルにGoogle Cloud リソースへのアクセス権を付与したり、アクセスを拒否したりできます。このドキュメントでは、UAP とバインディングを表示する方法について説明します。

始める前に

  1. 認証を設定する。

    このページのサンプルをどのように使うかに応じて、タブを選択してください。

    コンソール

    Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。

    gcloud

    Google Cloud コンソールで Cloud Shell をアクティブにします。

    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 を使用して認証するをご覧ください。

  2. Google Cloud プロジェクトで課金が有効になっていることを確認します。

  3. 省略可: UAP の概要を確認します。

統合アクセス ポリシーの表示に必要なロール

UAP の表示に必要な権限を取得するには、表示する UAP を所有するプロジェクト、フォルダ、または組織に対するアクセス ポリシー閲覧者(roles/iam.accessPolicyViewer)IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

この事前定義ロールには、UAP の表示に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

UAP を表示するには、次の権限が必要です。

  • iam.accesspolicies.get
  • iam.accessPolicies.list

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

統合アクセス ポリシー バインディングの表示に必要なロール

バインディングの表示に必要な権限を取得するには、バインディングの親リソースに対する次の IAM ロールを付与するよう管理者に依頼します。

  • プロジェクトのバインディングを表示する: プロジェクト IAM 管理者(roles/resourcemanager.projectIamAdmin)
  • フォルダのバインディングを表示する: フォルダ IAM 管理者(roles/resourcemanager.folderIamAdmin)
  • 組織のバインディングを表示する: 組織管理者(roles/resourcemanager.organizationAdmin)

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

これらの事前定義ロールには、バインディングの表示に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

バインディングを表示するには、次の権限が必要です。

  • 単一のバインディングを表示する: iam.policybindings.get
  • プロジェクト、フォルダ、組織を親とするバインディングを一覧表示する: iam.policybindings.list

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

統合アクセス ポリシーのすべてのバインディングを表示するために必要なロール

UAP のすべてのバインディングを表示するために必要な権限を取得するには、UAP を所有するリソースに対するアクセス ポリシー閲覧者(roles/iam.accessPolicyViewer)IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

この事前定義ロールには、UAP のすべてのバインディングを表示するために必要な iam.accesspolicies.searchPolicyBindings 権限が含まれています。

カスタムロールや他の事前定義ロールを使用して、この権限を取得することもできます。

リソースのすべてのバインディングを表示するロール

特定のターゲット リソースを含むすべてのバインディングを表示するために必要な権限を取得するには、そのリソースのバインディングを一覧表示できるロールを付与するよう管理者に依頼してください。このロールには、権限 SERVICE.RESOURCE.searchPolicyBindings を含める必要があります。ここで、RESOURCE はターゲット リソースタイプ、SERVICE はリソースを所有するサービスです。

必要な権限を含むロールを見つけるには、ロールと権限のリファレンスで権限を検索し、権限名をクリックして、その権限を含むロールを確認します。

このロールは、ターゲット リソースまたはその祖先のいずれかに必要です。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

プロジェクト、フォルダ、組織の統合アクセス ポリシーを一覧表示する

特定のプロジェクト、フォルダ、組織を親とするすべての UAP を一覧表示するには、 Google Cloud コンソール、gcloud CLI、または IAM REST API を使用します。

コンソール

  1. Google Cloud コンソールで、[統合アクセス ポリシー] ページに移動します。

    [統合アクセス ポリシー] に移動
  2. 表示する UAP を所有するプロジェクト、フォルダ、または組織を選択します。

Google Cloud コンソールに、選択したリソースを親とする UAP またはバインドされている UAP が表示されます。

gcloud

gcloud iam access-policies list コマンドを実行すると、特定のリソースの子であるすべての UAP が一覧表示されます。

後述のコマンドデータを使用する前に、次のように置き換えます。

  • UAP_PARENT_RESOURCE_TYPE: 一覧表示する UAP を所有する Resource Manager リソース(プロジェクト、フォルダ、組織)のタイプ。値 project、folder、または organization を使用します。
  • UAP_PARENT_RESOURCE_ID: 一覧表示する UAP を所有するプロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です(例: my-project)。フォルダ ID と組織 ID は数値です(例: 123456789012)。
  • FORMAT: レスポンスの形式。json または yaml を使用します。

次のコマンドを実行します。

Linux、macOS、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

レスポンスには、リクエスト内のリソースの子である UAP が含まれます。

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

accessPolicies.list メソッドは、特定のリソースの子であるすべての UAP を一覧表示します。

リクエストのデータを使用する前に、次のように置き換えます。

  • UAP_PARENT_RESOURCE_TYPE: 一覧表示する UAP を所有する Resource Manager リソース(プロジェクト、フォルダ、組織)のタイプ。値 projects、folders、または organizations を使用します。
  • UAP_PARENT_RESOURCE_ID: 一覧表示する UAP を所有するプロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です(例: my-project)。フォルダ ID と組織 ID は数値です(例: 123456789012)。

HTTP メソッドと URL:

GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies

リクエストを送信するには、次のいずれかのオプションを展開します。

レスポンスには、リクエスト内のリソースの子である UAP が含まれます。

{
  "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"
          }
        ]
      }
    }
  ]
}

単一の統合アクセス ポリシーを取得する

単一の UAP の詳細を取得するには、Google Cloud コンソール、gcloud CLI、または IAM REST API を使用します。

コンソール

  1. Google Cloud コンソールで、[統合アクセス ポリシー] ページに移動します。

    [統合アクセス ポリシー] に移動
  2. 詳細を表示する UAP を所有するプロジェクト、フォルダ、または組織を選択します。
  3. 詳細を表示する UAP のポリシー ID をクリックします。

Google Cloud コンソールに、ID、作成日時、最終更新日時、ルールのリストなど、UAP の詳細が表示されます。

gcloud

gcloud iam access-policies describe コマンドは、単一の 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)。
  • FORMAT: レスポンスの形式。json または yaml を使用します。

次のコマンドを実行します。

Linux、macOS、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

レスポンスには、リクエストで指定された UAP が含まれます。

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

accessPolicies.get メソッドは、単一の 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)。

HTTP メソッドと URL:

GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID

リクエストを送信するには、次のいずれかのオプションを展開します。

レスポンスには、リクエストで指定された UAP が含まれます。

{
  "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"
      }
    ]
  }
}

統合アクセス ポリシーのバインディングを一覧表示する

UAP のバインディングを一覧表示するには、いくつかの方法があります。

統合アクセス ポリシーのバインディングを一覧表示する

特定の UAP を含むすべてのバインディングを表示するには、UAP のバインディングを検索します。

UAP のすべてのバインディングを表示するには、Google Cloud コンソール、gcloud CLI、または IAM REST API を使用します。

コンソール

  1. Google Cloud コンソールで、[統合アクセス ポリシー] ページに移動します。

    [統合アクセス ポリシー] に移動
  2. バインディングを表示する UAP を所有するプロジェクト、フォルダ、または組織を選択します。
  3. バインディングを表示する UAP のポリシー ID をクリックします。
  4. [バインディング] タブを選択します。

Google Cloud コンソールに、UAP のバインディングのリストと、各バインディングの表示名とターゲット リソースが表示されます。

gcloud

gcloud iam access-policies search-policy-bindings コマンドは、指定された 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)。
  • FORMAT: レスポンスの形式。json または yaml を使用します。

次のコマンドを実行します。

Linux、macOS、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

レスポンスには、指定された UAP のバインディングが含まれます。

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

accessPolicies.searchPolicyBindings メソッドは、指定された 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)。

HTTP メソッドと URL:

GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID:searchPolicyBindings

リクエストを送信するには、次のいずれかのオプションを展開します。

レスポンスには、指定された UAP のバインディングが含まれます。

{
  "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"
    }
  ]
}

リソースのすべてのバインディングを一覧表示する

特定のターゲット リソースを含むすべてのバインディングを表示するには、そのリソースのバインディングを検索します。

各バインディングには、リソースにバインドされている UAP の ID が含まれます。ポリシーの詳細を確認するには、ポリシー ID を使用してポリシーの詳細を取得します。

リソースのすべてのバインディングを表示するには、Google Cloud コンソール、gcloud CLI、または IAM REST API を使用します。

コンソール

  1. Google Cloud コンソールで、[統合アクセス ポリシー] ページに移動します。

    [統合アクセス ポリシー] に移動
  2. バインディングを表示するプロジェクト、フォルダ、または組織を選択します。
  3. [フィルタ] フィールドに、フィルタ「適用: 適用済み」を入力します。

このテーブルには、リソースにバインドされているすべての UAP が表示されます。

gcloud

gcloud iam policy-bindings search-target-policy-bindings コマンドは、リソースを含むすべての UAP バインディングを取得します。

後述のコマンドデータを使用する前に、次のように置き換えます。

  • BINDING_PARENT_RESOURCE_TYPE: ターゲット リソースのバインディングを親とする Resource Manager リソースのタイプ(プロジェクト、フォルダ、組織)。値 project、folder、または organization を使用します。

    どのリソースがどのバインディングの親であるかについては、サポートされているリソースをご覧ください。

  • BINDING_PARENT_RESOURCE_ID: ターゲット リソースのバインディングを親とするプロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です(例: my-project)。フォルダ ID と組織 ID は数値です(例: 123456789012)。
  • TARGET_RESOURCE: バインディングを一覧表示するリソース。有効なリソースの一覧については、サポートされているリソースをご覧ください。
  • FORMAT: レスポンスの形式。json または yaml を使用します。

次のコマンドを実行します。

Linux、macOS、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

レスポンスには、ターゲット リソースを含むすべての UAP バインディングが含まれます。

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

SearchTargetPolicyBindings.search メソッドは、リソースを含むすべての UAP バインディングを取得します。

リクエストのデータを使用する前に、次のように置き換えます。

  • BINDING_PARENT_RESOURCE_TYPE: ターゲット リソースのバインディングを親とする Resource Manager リソースのタイプ(プロジェクト、フォルダ、組織)。値 projects、folders、または organizations を使用します。

    どのリソースがどのバインディングの親であるかについては、サポートされているリソースをご覧ください。

  • BINDING_PARENT_RESOURCE_ID: ターゲット リソースのバインディングを親とするプロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です(例: my-project)。フォルダ ID と組織 ID は数値です(例: 123456789012)。
  • TARGET_RESOURCE: バインディングを一覧表示するリソース。有効なリソースの一覧については、サポートされているリソースをご覧ください。

HTTP メソッドと URL:

GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings:searchTargetPolicyBindings?target=TARGET_RESOURCE

リクエストを送信するには、次のいずれかのオプションを展開します。

レスポンスには、ターゲット リソースを含むすべての UAP バインディングが含まれます。

{
  "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"
    }
  ]
}

プロジェクト、フォルダ、組織内のすべてのバインディングを一覧表示する

gcloud CLI または IAM REST API を使用してバインディングを表示する場合は、特定のプロジェクト、フォルダ、組織の子であるすべてのバインディングを一覧表示することもできます。

プロジェクト、フォルダ、組織のバインディングを一覧表示することは、そのリソースのバインディングを検索することと似ています。ただし、バインディングの検索とは異なり、リソースのバインディングを一覧表示すると、そのリソースの直接の子であるすべてのバインディングも含まれます。

たとえば、Network Services API Agent Gateway にポリシーを接続するバインディングがあるとします。このバインディングの親リソースは、Agent Gateway の親プロジェクトです。つまり、バインディングはプロジェクトの直接の子です。そのため、そのプロジェクトのバインディングを一覧表示すると、レスポンスに Agent Gateway のバインディングが含まれます。ただし、プロジェクトの親組織のバインディングを一覧表示すると、レスポンスにバインディングは含まれません。これは、バインディングが組織の子孫であっても、組織の直接の子ではないためです。

バインディングの親リソースは、バインディングのターゲット リソースによって異なります。詳細については、サポート対象のリソースをご覧ください。

各バインディングには、リソースにバインドされている UAP の ID が含まれます。ポリシーの詳細を確認するには、ポリシー ID を使用してポリシーの詳細を取得します。

プロジェクト、フォルダ、組織の子であるすべてのバインディングを表示するには、gcloud CLI または IAM REST API を使用します。

gcloud

gcloud iam policy-bindings list コマンドを実行すると、特定のリソースの子であるすべての UAP バインディングが一覧表示されます。

後述のコマンドデータを使用する前に、次のように置き換えます。

  • BINDING_PARENT_RESOURCE_TYPE: バインディングが子である Resource Manager リソースのタイプ(プロジェクト、フォルダ、組織)。値 project、folder、または organization を使用します。

    バインディングの親リソースは、バインディングのターゲット リソースによって異なります。詳細については、サポート対象のリソースをご覧ください。

  • BINDING_PARENT_RESOURCE_ID: ポリシー バインディングが子であるプロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です(例: my-project)。フォルダ ID と組織 ID は数値です(例: 123456789012)。
  • FORMAT: レスポンスの形式。json または yaml を使用します。

次のコマンドを実行します。

Linux、macOS、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

レスポンスには、コマンドのリソースの子である UAP バインディングが含まれます。

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

policyBindings.list メソッドは、特定のリソースの子であるすべての UAP バインディングを一覧表示します。

リクエストのデータを使用する前に、次のように置き換えます。

  • BINDING_PARENT_RESOURCE_TYPE: バインディングが子である Resource Manager リソースのタイプ(プロジェクト、フォルダ、組織)。値 projects、folders、または organizations を使用します。

    バインディングの親リソースは、バインディングのターゲット リソースによって異なります。詳細については、サポート対象のリソースをご覧ください。

  • BINDING_PARENT_RESOURCE_ID: ポリシー バインディングが子であるプロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です(例: my-project)。フォルダ ID と組織 ID は数値です(例: 123456789012)。

HTTP メソッドと URL:

GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings?filter=policyKind:ACCESS

リクエストを送信するには、次のいずれかのオプションを展開します。

レスポンスには、リクエスト内のリソースの子である UAP バインディングが含まれます。

{
  "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"
    }
  ]
}

統合アクセス ポリシーのバインディングを取得する

バインディングの詳細は、 Google Cloud コンソール、gcloud CLI、または IAM REST API を使用して取得できます。

コンソール

  1. Google Cloud コンソールで、[統合アクセス ポリシー] ページに移動します。

    [統合アクセス ポリシー] に移動
  2. バインディングを表示する UAP を所有するプロジェクト、フォルダ、または組織を選択します。
  3. バインディングを表示する UAP のポリシー ID をクリックします。
  4. [バインディング] タブを選択します。
  5. バインディング ID またはバインディング名を使用してバインディングを検索します。

テーブルには、バインディング ID、バインディング名、バインディング内のターゲット リソースなど、バインディングの詳細が表示されます。

gcloud

gcloud iam policy-bindings describe コマンドは、バインディングを取得します。

後述のコマンドデータを使用する前に、次のように置き換えます。

  • 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)。
  • FORMAT: レスポンスの形式。json または yaml を使用します。

次のコマンドを実行します。

Linux、macOS、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

レスポンスにはバインディングが含まれます。

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

policyBindings.get メソッドはバインディングを取得します。

リクエストのデータを使用する前に、次のように置き換えます。

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

GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings/BINDING_ID

リクエストを送信するには、次のいずれかのオプションを展開します。

レスポンスにはバインディングが含まれます。

{
  "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"
}

次のステップ