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
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.
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 .
-
Pastikan penagihan diaktifkan untuk project Google Cloud Anda.
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:
-
Melihat binding dalam project:
Project IAM Admin (
roles/resourcemanager.projectIamAdmin) -
Melihat binding dalam folder:
Folder IAM Admin (
roles/resourcemanager.folderIamAdmin) -
Melihat binding dalam organisasi:
Organization Administrator (
roles/resourcemanager.organizationAdmin)
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
-
Di konsol Google Cloud , buka halaman Unified Access Policies.
Buka Unified Access Policies - 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 nilaiproject,folder, atauorganization. -
UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda cantumkan. Project ID adalah string alfanumerik, sepertimy-project. Folder dan ID organisasi berupa numerik, seperti123456789012. FORMAT: Format untuk respons. Gunakanjsonatauyaml.
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 nilaiprojects,folders, atauorganizations. -
UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda cantumkan. Project ID adalah string alfanumerik, sepertimy-project. Folder dan ID organisasi berupa numerik, seperti123456789012.
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
-
Di konsol Google Cloud , buka halaman Unified Access Policies.
Buka Unified Access Policies - Pilih project, folder, atau organisasi yang memiliki UAP yang detailnya ingin Anda lihat.
- 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 nilaiproject,folder, atauorganization -
UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda dapatkan. Project ID adalah string alfanumerik, sepertimy-project. Folder dan ID organisasi berupa numerik, seperti123456789012. FORMAT: Format untuk respons. Gunakanjsonatauyaml.
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 nilaiprojects,folders, atauorganizations -
UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda dapatkan. Project ID adalah string alfanumerik, sepertimy-project. Folder dan ID organisasi berupa numerik, seperti123456789012. -
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 UAP: Melihat semua binding yang menyertakan UAP tertentu.
- Mencantumkan binding untuk resource: Melihat semua binding yang menyertakan resource target tertentu.
- Mencantumkan semua binding dalam project, folder, atau organisasi: Melihat semua binding yang diinduki oleh project, folder, atau organisasi tertentu.
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
-
Di konsol Google Cloud , buka halaman Unified Access Policies.
Buka Unified Access Policies - Pilih project, folder, atau organisasi yang memiliki UAP yang binding-nya ingin Anda lihat.
- Klik ID kebijakan UAP yang binding-nya ingin Anda lihat.
- 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 nilaiproject,folder, atauorganization. -
UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda cantumkan binding-nya. Project ID berupa string alfanumerik, sepertimy-project. ID folder dan ID organisasi berupa numerik, seperti123456789012. FORMAT: Format untuk respons. Gunakanjsonatauyaml.
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 nilaiprojects,folders, atauorganizations. -
UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda cantumkan binding-nya. Project ID berupa string alfanumerik, sepertimy-project. ID folder dan ID organisasi berupa numerik, seperti123456789012. -
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
-
Di konsol Google Cloud , buka halaman Unified Access Policies.
Buka Unified Access Policies - Pilih project, folder, atau organisasi yang binding-nya ingin Anda lihat.
- 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 nilaiproject,folder, atauorganization.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, sepertimy-project. ID folder dan ID organisasi berupa numerik, seperti123456789012. -
TARGET_RESOURCE: Resource yang binding-nya ingin Anda cantumkan. Untuk mengetahui daftar resource yang valid, lihat Resource yang didukung. FORMAT: Format untuk respons. Gunakanjsonatauyaml.
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 nilaiprojects,folders, atauorganizations.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, sepertimy-project. ID folder dan ID organisasi berupa numerik, seperti123456789012. -
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 nilaiproject,folder, atauorganization.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, sepertimy-project. ID folder dan ID organisasi berupa numerik, seperti123456789012. FORMAT: Format untuk respons. Gunakanjsonatauyaml.
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 nilaiprojects,folders, atauorganizations.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, sepertimy-project. ID folder dan ID organisasi berupa numerik, seperti123456789012.
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
-
Di konsol Google Cloud , buka halaman Unified Access Policies.
Buka Unified Access Policies - Pilih project, folder, atau organisasi yang memiliki UAP yang binding-nya ingin Anda lihat.
- Klik ID kebijakan UAP yang binding-nya ingin Anda lihat.
- Pilih tab Bindings.
- 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 nilaiproject,folder, atauorganization.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, sepertimy-project. ID folder dan ID organisasi berupa numerik, seperti123456789012. FORMAT: Format untuk respons. Gunakanjsonatauyaml.
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 nilaiprojects,folders, atauorganizations.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, sepertimy-project. ID folder dan ID organisasi berupa numerik, seperti123456789012. -
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"
}