Melihat Unified Access Policies

Unified Access Policy (UAP) memungkinkan Anda memberikan dan menolak akses akun utama ke resourceGoogle Cloud . Dokumen ini menjelaskan cara melihat UAP dan binding.

Sebelum memulai

  1. Menyiapkan autentikasi.

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    Konsol

    Saat menggunakan konsol Google Cloud untuk mengakses layanan dan API Google Cloud , Anda tidak perlu menyiapkan autentikasi.

    gcloud

    Di konsol Google Cloud , aktifkan Cloud Shell.

    Aktifkan Cloud Shell

    Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan prompt command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

    REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

      Instal Google Cloud CLI.

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

  2. Pastikan penagihan diaktifkan untuk project Google Cloud Anda.

  3. Opsional: Baca ringkasan UAP.

Peran yang diperlukan untuk melihat Unified Access Policies

Untuk mendapatkan izin yang diperlukan untuk melihat UAP, minta administrator untuk memberi Anda peran IAM Access Policy Viewer (roles/iam.accessPolicyViewer) pada project, folder, atau organisasi yang memiliki UAP yang ingin Anda lihat . Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat UAP. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat UAP:

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

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Peran yang diperlukan untuk melihat binding Unified Access Policy

Untuk mendapatkan izin yang Anda perlukan untuk melihat binding, minta administrator untuk memberi Anda peran IAM berikut pada resource induk binding:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat binding. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat binding:

  • Melihat satu binding: iam.policybindings.get
  • Mencantumkan binding yang diinduki oleh project, folder, atau organisasi: iam.policybindings.list

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Peran yang diperlukan untuk melihat semua binding untuk Unified Access Policy

Untuk mendapatkan izin yang diperlukan untuk melihat semua binding untuk UAP, minta administrator untuk memberi Anda peran IAM Access Policy Viewer (roles/iam.accessPolicyViewer) pada resource yang memiliki UAP. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin iam.accesspolicies.searchPolicyBindings, yang diperlukan untuk melihat semua binding untuk UAP.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Peran untuk melihat semua binding untuk resource

Untuk mendapatkan izin yang diperlukan guna melihat semua binding yang menyertakan resource target tertentu, minta administrator untuk memberi Anda peran yang memungkinkan Anda mencantumkan binding untuk resource tersebut. Peran ini harus menyertakan izin SERVICE.RESOURCE.searchPolicyBindings, dengan RESOURCE adalah jenis resource target dan SERVICE adalah layanan yang memiliki resource.

Untuk menemukan peran yang menyertakan izin yang diperlukan, telusuri izin tersebut di referensi peran dan izin, klik nama izin, lalu tinjau peran yang menyertakan izin tersebut.

Anda memerlukan peran ini pada resource target atau salah satu ancestor-nya.

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Mencantumkan Unified Access Policies dalam project, folder, atau organisasi

Anda dapat mencantumkan semua UAP yang diinduki oleh project, folder, atau organisasi tertentu menggunakan konsol Google Cloud , gcloud CLI, atau IAM REST API.

Konsol

  1. Di konsol Google Cloud , buka halaman Unified Access Policies.

    Buka Unified Access Policies
  2. Pilih project, folder, atau organisasi yang memiliki UAP yang ingin Anda lihat.

Konsol Google Cloud menampilkan UAP yang diinduki oleh atau terikat ke resource yang Anda pilih.

gcloud

Perintah gcloud iam access-policies list mencantumkan semua UAP yang merupakan turunan dari resource tertentu.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • UAP_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang memiliki UAP yang ingin Anda cantumkan. Gunakan nilai project, folder, atau organization.
  • UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda cantumkan. Project ID adalah string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
  • FORMAT: Format untuk respons. Gunakan json atau yaml.

Jalankan perintah berikut:

Linux, macOS, atau 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

Responsnya berisi UAP yang merupakan turunan dari resource dalam permintaan.

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

Metode accessPolicies.list mencantumkan semua UAP yang merupakan turunan dari resource tertentu.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • UAP_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang memiliki UAP yang ingin Anda cantumkan. Gunakan nilai projects, folders, atau organizations.
  • UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda cantumkan. Project ID adalah string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.

Metode HTTP dan URL:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Responsnya berisi UAP yang merupakan turunan dari resource dalam permintaan.

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

Mendapatkan satu Unified Access Policy

Anda bisa mendapatkan detail satu UAP menggunakan konsolGoogle Cloud , gcloud CLI, atau IAM REST API.

Konsol

  1. Di konsol Google Cloud , buka halaman Unified Access Policies.

    Buka Unified Access Policies
  2. Pilih project, folder, atau organisasi yang memiliki UAP yang detailnya ingin Anda lihat.
  3. Klik ID kebijakan UAP yang ingin Anda lihat detailnya.

Konsol Google Cloud menampilkan detail UAP, termasuk ID, waktu pembuatan, waktu terakhir diperbarui, dan daftar aturan.

gcloud

Perintah gcloud iam access-policies describe mendapatkan satu UAP.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • UAP_ID: ID UAP yang ingin Anda dapatkan—misalnya, example-policy.
  • UAP_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang memiliki UAP yang ingin Anda dapatkan. Gunakan nilai project, folder, atau organization
  • UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda dapatkan. Project ID adalah string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
  • FORMAT: Format untuk respons. Gunakan json atau yaml.

Jalankan perintah berikut:

Linux, macOS, atau 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

Respons berisi UAP yang ditentukan dalam permintaan.

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

Metode accessPolicies.get mendapatkan satu UAP.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • UAP_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang memiliki UAP yang ingin Anda dapatkan. Gunakan nilai projects, folders, atau organizations
  • UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda dapatkan. Project ID adalah string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
  • UAP_ID: ID UAP yang ingin Anda dapatkan—misalnya, example-policy.

Metode HTTP dan URL:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Respons berisi UAP yang ditentukan dalam permintaan.

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

Mencantumkan binding untuk Unified Access Policies

Anda dapat mencantumkan binding untuk UAP dengan beberapa cara:

Mencantumkan binding untuk Unified Access Policy

Untuk melihat semua binding yang menyertakan UAP tertentu, telusuri binding untuk UAP tersebut.

Anda dapat melihat semua binding untuk UAP menggunakan konsolGoogle Cloud , gcloud CLI, atau IAM REST API.

Konsol

  1. Di konsol Google Cloud , buka halaman Unified Access Policies.

    Buka Unified Access Policies
  2. Pilih project, folder, atau organisasi yang memiliki UAP yang binding-nya ingin Anda lihat.
  3. Klik ID kebijakan UAP yang binding-nya ingin Anda lihat.
  4. Pilih tab Bindings.

Konsol Google Cloud menampilkan daftar binding untuk UAP, beserta nama tampilan dan resource target setiap binding.

gcloud

Perintah gcloud iam access-policies search-policy-bindings mencantumkan semua binding untuk UAP yang ditentukan.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • UAP_ID: ID UAP yang ingin Anda cantumkan binding-nya, misalnya, example-policy.
  • UAP_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang memiliki UAP yang ingin Anda cantumkan binding-nya. Gunakan nilai project, folder, atau organization.
  • UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda cantumkan binding-nya. Project ID berupa string alfanumerik, seperti my-project. ID folder dan ID organisasi berupa numerik, seperti 123456789012.
  • FORMAT: Format untuk respons. Gunakan json atau yaml.

Jalankan perintah berikut:

Linux, macOS, atau 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

Respons berisi binding untuk UAP yang ditentukan.

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

Metode accessPolicies.searchPolicyBindings mencantumkan semua binding untuk UAP yang ditentukan.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • UAP_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang memiliki UAP yang ingin Anda cantumkan binding-nya. Gunakan nilai projects, folders, atau organizations.
  • UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda cantumkan binding-nya. Project ID berupa string alfanumerik, seperti my-project. ID folder dan ID organisasi berupa numerik, seperti 123456789012.
  • UAP_ID: ID UAP yang ingin Anda cantumkan binding-nya, misalnya, example-policy.

Metode HTTP dan URL:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Respons berisi binding untuk UAP yang ditentukan.

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

Mencantumkan semua binding untuk resource

Untuk melihat semua binding yang menyertakan resource target tertentu, telusuri binding untuk resource tersebut.

Setiap binding berisi ID UAP yang terikat ke resource. Untuk melihat detail kebijakan, gunakan ID kebijakan untuk mendapatkan detail kebijakan.

Anda dapat melihat semua binding untuk resource menggunakan konsolGoogle Cloud , gcloud CLI, atau IAM REST API.

Konsol

  1. Di konsol Google Cloud , buka halaman Unified Access Policies.

    Buka Unified Access Policies
  2. Pilih project, folder, atau organisasi yang binding-nya ingin Anda lihat.
  3. Di kolom Filter, masukkan filter Enforcement: Enforced.

Tabel ini menampilkan semua UAP yang terikat ke resource.

gcloud

Perintah gcloud iam policy-bindings search-target-policy-bindings mendapatkan semua binding UAP yang menyertakan resource.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • BINDING_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang menjadi induk binding untuk resource target. Gunakan nilai project, folder, atau organization.

    Untuk mempelajari resource mana yang menjadi induk binding mana, lihat Resource yang didukung.

  • BINDING_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang menjadi induk binding untuk resource target. Project ID adalah string alfanumerik, seperti my-project. ID folder dan ID organisasi berupa numerik, seperti 123456789012.
  • TARGET_RESOURCE: Resource yang binding-nya ingin Anda cantumkan. Untuk mengetahui daftar resource yang valid, lihat Resource yang didukung.
  • FORMAT: Format untuk respons. Gunakan json atau yaml.

Jalankan perintah berikut:

Linux, macOS, atau 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

Respons berisi semua binding UAP yang menyertakan resource target.

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

Metode SearchTargetPolicyBindings.search mendapatkan semua binding UAP yang menyertakan resource.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • BINDING_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang menjadi induk binding untuk resource target. Gunakan nilai projects, folders, atau organizations.

    Untuk mempelajari resource mana yang menjadi induk binding mana, lihat Resource yang didukung.

  • BINDING_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang menjadi induk binding untuk resource target. Project ID adalah string alfanumerik, seperti my-project. ID folder dan ID organisasi berupa numerik, seperti 123456789012.
  • TARGET_RESOURCE: Resource yang binding-nya ingin Anda cantumkan. Untuk mengetahui daftar resource yang valid, lihat Resource yang didukung.

Metode HTTP dan URL:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Respons berisi semua binding UAP yang menyertakan resource target.

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

Mencantumkan semua binding dalam project, folder, atau organisasi

Jika Anda menggunakan gcloud CLI atau IAM REST API untuk melihat binding, Anda juga dapat mencantumkan semua binding yang merupakan turunan dari project, folder, atau organisasi tertentu.

Mencantumkan binding untuk project, folder, atau organisasi mirip dengan menelusuri binding untuk resource tersebut. Namun, tidak seperti penelusuran binding, mencantumkan binding untuk resource juga mencakup semua binding yang merupakan turunan langsung dari resource tersebut.

Misalnya, bayangkan Anda memiliki binding yang melampirkan kebijakan ke gateway agen Network Services API. Resource induk binding ini adalah project induk Agent Gateway. Dengan kata lain, binding adalah turunan langsung dari project. Oleh karena itu, jika Anda mencantumkan binding untuk project tersebut, responsnya akan menyertakan binding untuk gateway agen. Namun, jika Anda mencantumkan binding untuk organisasi induk project, respons tidak akan menyertakan binding tersebut. Hal ini karena, meskipun binding adalah turunan dari organisasi, binding tersebut bukan turunan langsung dari organisasi.

Resource induk binding bergantung pada resource target dalam binding. Untuk mempelajari lebih lanjut, lihat Resource yang didukung.

Setiap binding berisi ID UAP yang terikat ke resource. Untuk melihat detail kebijakan, gunakan ID kebijakan untuk mendapatkan detail kebijakan.

Anda dapat melihat semua binding yang merupakan turunan dari project, folder, atau organisasi menggunakan gcloud CLI atau IAM REST API.

gcloud

Perintah gcloud iam policy-bindings list mencantumkan semua binding UAP yang merupakan turunan dari resource tertentu.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • BINDING_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang memiliki binding sebagai turunannya. Gunakan nilai project, folder, atau organization.

    Resource induk binding bergantung pada resource target dalam binding. Untuk mengetahui informasi selengkapnya, lihat Referensi yang didukung.

  • BINDING_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang merupakan induk dari binding kebijakan. Project ID adalah string alfanumerik, seperti my-project. ID folder dan ID organisasi berupa numerik, seperti 123456789012.
  • FORMAT: Format untuk respons. Gunakan json atau yaml.

Jalankan perintah berikut:

Linux, macOS, atau 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

Responsnya berisi binding UAP yang merupakan turunan dari resource dalam perintah.

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

Metode policyBindings.list mencantumkan semua binding UAP yang merupakan turunan dari resource tertentu.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • BINDING_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang memiliki binding sebagai turunannya. Gunakan nilai projects, folders, atau organizations.

    Resource induk binding bergantung pada resource target dalam binding. Untuk mengetahui informasi selengkapnya, lihat Referensi yang didukung.

  • BINDING_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang merupakan induk dari binding kebijakan. Project ID adalah string alfanumerik, seperti my-project. ID folder dan ID organisasi berupa numerik, seperti 123456789012.

Metode HTTP dan URL:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Respons berisi binding UAP yang merupakan turunan dari resource dalam permintaan.

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

Mendapatkan binding untuk Unified Access Policy

Anda bisa mendapatkan detail binding menggunakan konsol Google Cloud , gcloud CLI, atau IAM REST API.

Konsol

  1. Di konsol Google Cloud , buka halaman Unified Access Policies.

    Buka Unified Access Policies
  2. Pilih project, folder, atau organisasi yang memiliki UAP yang binding-nya ingin Anda lihat.
  3. Klik ID kebijakan UAP yang binding-nya ingin Anda lihat.
  4. Pilih tab Bindings.
  5. Temukan binding menggunakan ID binding atau nama binding.

Tabel ini menampilkan detail binding, termasuk ID binding, nama binding, dan resource target dalam binding.

gcloud

Perintah gcloud iam policy-bindings describe mendapatkan binding.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • BINDING_ID: ID binding yang ingin Anda dapatkan—misalnya, example-binding.
  • BINDING_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang memiliki binding sebagai turunannya. Gunakan nilai project, folder, atau organization.

    Resource induk binding bergantung pada resource target dalam binding. Untuk mengetahui informasi selengkapnya, lihat Referensi yang didukung.

  • BINDING_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang merupakan induk dari binding kebijakan. Project ID adalah string alfanumerik, seperti my-project. ID folder dan ID organisasi berupa numerik, seperti 123456789012.
  • FORMAT: Format untuk respons. Gunakan json atau yaml.

Jalankan perintah berikut:

Linux, macOS, atau 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

Respons berisi binding.

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

Metode policyBindings.get mendapatkan binding.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • BINDING_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang memiliki binding sebagai turunannya. Gunakan nilai projects, folders, atau organizations.

    Resource induk binding bergantung pada resource target dalam binding. Untuk mengetahui informasi selengkapnya, lihat Referensi yang didukung.

  • BINDING_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang merupakan induk dari binding kebijakan. Project ID adalah string alfanumerik, seperti my-project. ID folder dan ID organisasi berupa numerik, seperti 123456789012.
  • BINDING_ID: ID binding yang ingin Anda dapatkan—misalnya, example-binding.

Metode HTTP dan URL:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Respons berisi binding.

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

Langkah berikutnya