Kebijakan Principal Access Boundary (PAB) memungkinkan Anda membatasi resource yang dapat diakses oleh sekumpulan akun utama. Halaman ini menjelaskan cara melihat kebijakan Batas Akses Utama (PAB) dan binding kebijakan untuk kebijakan Batas Akses Utama (PAB).
Sebelum memulai
Menyiapkan autentikasi.
Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:
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 .
Peran yang diperlukan untuk melihat kebijakan Principal Access Boundary
Untuk mendapatkan izin yang
diperlukan untuk melihat kebijakan Principal Access Boundary,
minta administrator untuk memberi Anda
peran IAM Principal Access Boundary Viewer (roles/iam.principalAccessBoundaryViewer) di organisasi.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk melihat kebijakan Batas Akses Akun Utama. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk melihat kebijakan Batas Akses Utama (PAB):
-
Melihat satu kebijakan Principal Access Boundary:
iam.principalaccessboundarypolicies.get -
Mencantumkan kebijakan Batas Akses Utama (PAB) dalam organisasi:
iam.principalaccessboundarypolicies.list
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Peran yang diperlukan untuk melihat binding kebijakan
Untuk mendapatkan izin yang diperlukan untuk melihat binding kebijakan, minta administrator untuk memberi Anda peran IAM berikut pada resource induk binding kebijakan:
-
Melihat binding kebijakan dalam project:
Project IAM Admin (
roles/resourcemanager.projectIamAdmin) -
Melihat binding kebijakan dalam folder:
Folder IAM Admin (
roles/resourcemanager.folderIamAdmin) -
Melihat binding kebijakan dalam organisasi:
Administrator Organisasi (
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 kebijakan. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk melihat binding kebijakan:
-
Melihat satu binding kebijakan:
iam.policybindings.get -
Mencantumkan binding kebijakan dalam 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 kebijakan untuk kebijakan Principal Access Boundary
Untuk mendapatkan izin yang
Anda perlukan guna melihat semua binding kebijakan untuk kebijakan Principal Access Boundary,
minta administrator untuk memberi Anda
peran IAM Principal Access Boundary Viewer (roles/iam.principalAccessBoundaryViewer) di organisasi.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin
iam.principalaccessboundarypolicies.searchIamPolicyBindings,
yang diperlukan untuk
melihat semua binding kebijakan untuk kebijakan Batas Akses Akun Utama.
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Peran yang diperlukan untuk melihat binding kebijakan untuk set akun utama
Izin yang Anda perlukan untuk melihat semua binding kebijakan untuk set akun utama bergantung pada set akun utama yang kebijakannya ingin Anda lihat.
Untuk mendapatkan izin yang Anda perlukan untuk melihat binding kebijakan, minta administrator untuk memberi Anda peran IAM berikut:
-
Melihat binding kebijakan untuk kumpulan Workforce Identity Federation:
IAM Workforce Pool Admin (
roles/iam.workforcePoolAdmin) pada kumpulan Workforce Identity Federation target -
Melihat binding kebijakan untuk pool Workload Identity Federation:
IAM Workload Identity Pool Admin (
roles/iam.workloadIdentityPoolAdmin) pada project yang memiliki pool Workload Identity Federation target -
Melihat binding kebijakan untuk domain Google Workspace:
Workspace Pool IAM Admin (
roles/iam.workspacePoolAdmin) pada organisasi -
Melihat binding kebijakan untuk set akun utama project:
Project IAM Admin (
roles/resourcemanager.projectIamAdmin) pada project -
Melihat binding kebijakan untuk set akun utama folder:
Folder IAM Admin (
roles/resourcemanager.folderIamAdmin) pada folder -
Melihat binding kebijakan untuk set akun utama organisasi:
Organization Administrator (
roles/resourcemanager.organizationAdmin) di organisasi
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 kebijakan. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk melihat binding kebijakan:
-
Melihat binding kebijakan untuk kumpulan Workforce Identity Federation:
iam.workforcePools.searchPolicyBindingspada kumpulan Workforce Identity Federation target -
Melihat binding kebijakan untuk kumpulan Workload Identity Federation:
iam.workloadIdentityPools.searchPolicyBindingspada project yang memiliki kumpulan Workload Identity Federation target -
Melihat binding kebijakan untuk domain Google Workspace:
iam.workspacePools.searchPolicyBindingspada organisasi tersebut -
Melihat binding kebijakan untuk set akun utama project:
resourcemanager.projects.searchPolicyBindingspada project -
Melihat binding kebijakan untuk set akun utama folder:
resourcemanager.folders.searchPolicyBindingsdi folder tersebut -
Melihat binding kebijakan untuk set akun utama organisasi:
resourcemanager.organizations.searchPolicyBindingsdi organisasi
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Mencantumkan kebijakan Batas Akses Utama untuk organisasi
Untuk melihat semua kebijakan Batas Akses Utama (PAB) yang dibuat dalam organisasi, cantumkan kebijakan Batas Akses Utama (PAB) dalam organisasi.
Anda dapat mencantumkan kebijakan Batas Akses Akun Utama dalam organisasi menggunakan konsolGoogle Cloud , gcloud CLI, atau IAM REST API.
Konsol
Di konsol Google Cloud , buka halaman Principal Access Boundary policies.
Pilih organisasi yang ingin Anda lihat kebijakan Batas Akses Utama-nya.
Konsol Google Cloud mencantumkan semua kebijakan dalam organisasi yang Anda pilih.
gcloud
Perintah
gcloud iam principal-access-boundary-policies list
mencantumkan semua kebijakan Batas Akses Akun Utama dalam sebuah organisasi.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
-
ORG_ID: ID organisasi Google Cloud yang ingin Anda cantumkan kebijakan Batas Akses Utama (PAB). ID organisasi berupa angka, seperti123456789012. FORMAT: Format untuk respons. Gunakanjsonatauyaml.
Jalankan perintah berikut:
Linux, macOS, atau Cloud Shell
gcloud iam principal-access-boundary-policies list --organization=ORG_ID \ --location=global --format=FORMAT
Windows (PowerShell)
gcloud iam principal-access-boundary-policies list --organization=ORG_ID ` --location=global --format=FORMAT
Windows (cmd.exe)
gcloud iam principal-access-boundary-policies list --organization=ORG_ID ^ --location=global --format=FORMAT
Respons berisi kebijakan Batas Akses Utama (PAB) di organisasi yang ditentukan.
{
"principalAccessBoundaryPolicies": [
{
"createTime": "2026-07-07T00:05:48.295209Z",
"details": {
"enforcementVersion": "4",
"rules": [
{
"description": "Make principals eligible to manage but not delete Compute resources in example.com",
"effect": "ALLOW",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/123456789012"
]
}
]
},
"displayName": "Example policy 1",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy-1",
"uid": "puid_13364150419245236225",
"updateTime": "2026-07-07T00:05:48.295209Z"
},
{
"createTime": "2026-05-29T23:25:01.606730Z",
"details": {
"enforcementVersion": "4",
"rules": [
{
"description": "Make principals eligible to access resources in example-project",
"effect": "ALLOW",
"resources": [
"//cloudresourcemanager.googleapis.com/projects/example-project"
]
}
]
},
"displayName": "Example policy 2",
"etag": "d6BJBTsk2+oDCygmr5ANxA==",
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy-2",
"uid": "puid_13064942519001808897",
"updateTime": "2026-05-29T23:25:01.606730Z"
}
]
}
REST
Metode
principalAccessBoundaryPolicies.list
mencantumkan semua kebijakan Batas Akses Utama (PAB) dalam organisasi.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
-
ORG_ID: ID organisasi Google Cloud yang ingin Anda cantumkan kebijakan Batas Akses Utama (PAB). ID organisasi berupa angka, seperti123456789012.
Metode HTTP dan URL:
GET https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Respons berisi kebijakan Batas Akses Utama (PAB) di organisasi yang ditentukan.
{
"principalAccessBoundaryPolicies": [
{
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy-1",
"uid": "puid_13364150419245236225",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"displayName": "Example policy 1",
"createTime": "2026-07-07T00:05:48.295209Z",
"updateTime": "2026-07-07T00:05:48.295209Z",
"details": {
"rules": [
{
"description": "Make principals eligible to access resources in example.com",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/123456789012"
],
"effect": "ALLOW"
}
],
"enforcementVersion": "4"
}
},
{
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/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": "Make principals eligible to access resources in example-project",
"resources": [
"//cloudresourcemanager.googleapis.com/projects/example-project"
],
"effect": "ALLOW"
}
],
"enforcementVersion": "4"
}
}
]
}
Mendapatkan satu kebijakan Principal Access Boundary
Untuk melihat detail satu kebijakan Batas Akses Akun Utama, gunakan ID kebijakan untuk mendapatkan kebijakan tersebut.
Anda bisa mendapatkan kebijakan Principal Access Boundary menggunakan konsol Google Cloud , gcloud CLI, atau IAM REST API.
Konsol
Di konsol Google Cloud , buka halaman Principal Access Boundary policies.
Pilih organisasi yang ingin Anda lihat kebijakan Batas Akses Utama-nya.
Klik ID kebijakan Principal Access Boundary yang ingin Anda lihat.
Konsol Google Cloud menampilkan detail kebijakan Batas Akses Utama (PAB) yang Anda pilih.
gcloud
Perintah
gcloud iam principal-access-boundary-policies describe
mendapatkan satu kebijakan Principal Access Boundary.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
-
PAB_POLICY_ID: ID kebijakan Batasan Akses Akun Utama yang ingin Anda dapatkan—misalnya,example-policy. ORG_ID: ID organisasi yang memiliki kebijakan Batas Akses Akun Utama. ID organisasi berupa angka, seperti123456789012.FORMAT: Format untuk respons. Gunakanjsonatauyaml.
Jalankan perintah berikut:
Linux, macOS, atau Cloud Shell
gcloud iam principal-access-boundary-policies describe PAB_POLICY_ID \ --organization=ORG_ID --location=global \ --format=FORMAT
Windows (PowerShell)
gcloud iam principal-access-boundary-policies describe PAB_POLICY_ID ` --organization=ORG_ID --location=global ` --format=FORMAT
Windows (cmd.exe)
gcloud iam principal-access-boundary-policies describe PAB_POLICY_ID ^ --organization=ORG_ID --location=global ^ --format=FORMAT
Respons berisi kebijakan Batas Akses Akun Utama yang ditentukan dalam permintaan.
{
"createTime": "2026-07-07T00:05:48.295209Z",
"details": {
"enforcementVersion": "4",
"rules": [
{
"description": "Make principals eligible to access resources in example.com",
"effect": "ALLOW",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/123456789012"
]
}
]
},
"displayName": "Example policy",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
"uid": "puid_13364150419245236225",
"updateTime": "2026-07-07T00:05:48.295209Z"
}
REST
Metode
principalAccessBoundaryPolicies.get
mendapatkan satu kebijakan Principal Access Boundary.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
ORG_ID: ID organisasi yang memiliki kebijakan Batas Akses Akun Utama. ID organisasi berupa angka, seperti123456789012.-
PAB_POLICY_ID: ID kebijakan Batasan Akses Akun Utama yang ingin Anda dapatkan—misalnya,example-policy.
Metode HTTP dan URL:
GET https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Respons berisi kebijakan Batas Akses Akun Utama yang ditentukan dalam permintaan.
{
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
"uid": "puid_13364150419245236225",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"displayName": "Example policy",
"createTime": "2026-07-07T00:05:48.295209Z",
"updateTime": "2026-07-07T00:05:48.295209Z",
"details": {
"rules": [
{
"description": "Make principals eligible to access resources in example.com",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/123456789012"
],
"effect": "ALLOW"
}
],
"enforcementVersion": "4"
}
}
Mencantumkan binding kebijakan untuk kebijakan Batas Akses Utama (PAB)
Ada beberapa cara untuk mencantumkan binding kebijakan untuk kebijakan Batas Akses Utama:
- Mencantumkan binding kebijakan untuk kebijakan Principal Access Boundary
- Mencantumkan binding kebijakan untuk set akun utama
- Mencantumkan binding kebijakan untuk project, folder, atau organisasi
Mencantumkan binding kebijakan untuk kebijakan Batas Akses Utama (PAB)
Untuk melihat semua binding kebijakan yang menyertakan kebijakan Principal Access Boundary tertentu, telusuri binding untuk kebijakan Principal Access Boundary.
Anda dapat melihat semua binding kebijakan untuk kebijakan Batas Akses Akun Utama menggunakan konsolGoogle Cloud , gcloud CLI, atau IAM REST API.
Konsol
Di konsol Google Cloud , buka halaman Principal Access Boundary policies.
Pilih organisasi yang memiliki kebijakan Batas Akses Akun Utama yang ingin Anda lihat binding-nya.
Klik ID kebijakan dari kebijakan Batas Akses Utama yang ingin Anda lihat binding-nya.
Klik tab Bindings.
Tab Bindings mencantumkan semua binding kebijakan Batas Akses Akun Utama yang menyertakan kebijakan Batas Akses Akun Utama.
gcloud
Perintah
gcloud iam principal-access-boundary-policies search-policy-bindings
mencantumkan semua binding kebijakan untuk kebijakan Principal Access Boundary yang ditentukan.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
-
PAB_POLICY_ID: ID kebijakan Batas Akses Akun Utama yang ingin Anda cantumkan binding kebijakannya—misalnya,example-policy. ORG_ID: ID organisasi yang memiliki kebijakan Batas Akses Akun Utama. ID organisasi berupa angka, seperti123456789012.FORMAT: Format untuk respons. Gunakanjsonatauyaml.
Jalankan perintah berikut:
Linux, macOS, atau Cloud Shell
gcloud iam principal-access-boundary-policies search-policy-bindings PAB_POLICY_ID \ --organization=ORG_ID --location=global \ --format=FORMAT
Windows (PowerShell)
gcloud iam principal-access-boundary-policies search-policy-bindings PAB_POLICY_ID ` --organization=ORG_ID --location=global ` --format=FORMAT
Windows (cmd.exe)
gcloud iam principal-access-boundary-policies search-policy-bindings PAB_POLICY_ID ^ --organization=ORG_ID --location=global ^ --format=FORMAT
Respons berisi binding kebijakan untuk kebijakan Batas Akses Utama yang ditentukan.
{
"policyBindings": [
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2024-05-06T18:08:24.729843Z"
},
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/projects/example-project"
},
"uid": "buid_4331055466646863873",
"updateTime": "2024-05-07T07:05:06.203861Z"
}
]
}
REST
Metode
principalAccessBoundaryPolicies.searchPolicyBindings
mencantumkan semua binding kebijakan untuk kebijakan Principal Access Boundary yang ditentukan.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
ORG_ID: ID organisasi yang memiliki kebijakan Batas Akses Akun Utama. ID organisasi berupa angka, seperti123456789012.-
PAB_POLICY_ID: ID kebijakan Batas Akses Akun Utama yang ingin Anda cantumkan binding kebijakannya—misalnya,example-policy.
Metode HTTP dan URL:
GET https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID:searchPolicyBindings
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Respons berisi binding kebijakan untuk kebijakan Batas Akses Utama yang ditentukan.
{
"policyBindings": [
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 1",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
"policyUid": "puid_9519202237377675265",
"createTime": "2024-05-06T18:08:24.729843Z",
"updateTime": "2024-05-06T18:08:24.729843Z"
},
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
"uid": "buid_4331055466646863873",
"etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
"displayName": "Example binding 2",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/projects/example-project"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
"policyUid": "puid_9519202237377675265",
"createTime": "2024-05-07T07:05:06.203861Z",
"updateTime": "2024-05-07T07:05:06.203861Z"
}
]
}
Mencantumkan binding kebijakan untuk set akun utama
Untuk melihat semua binding kebijakan yang menyertakan set akun utama tertentu, telusuri binding untuk set akun utama tersebut.
Binding ini berisi ID kebijakan Batas Akses Utama (PAB) yang terikat ke set entitas. Untuk melihat detail kebijakan ini, gunakan ID kebijakan untuk mendapatkan kebijakan Batas Akses Akun Utama.
Anda dapat melihat semua binding kebijakan untuk set akun utama menggunakan gcloud CLI atau IAM REST API.
gcloud
Perintah
gcloud iam policy-bindings search-target-policy-bindings
mendapatkan semua binding kebijakan Batas Akses Akun Utama untuk set akun utama.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
-
RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang merupakan induk dari set akun utama target. Gunakan nilaiproject,folder, atauorganization.Jenis resource bergantung pada jenis set akun utama yang ingin Anda cantumkan binding kebijakan-nya. Untuk melihat jenis resource yang akan digunakan, lihat Set akun utama yang didukung.
RESOURCE_ID: ID project, folder, atau organisasi yang merupakan induk dari set akun utama target. Project ID adalah string alfanumerik, sepertimy-project. ID folder dan ID organisasi berupa numerik, seperti123456789012.-
PRINCIPAL_SET: Set akun utama yang binding kebijakan Principal Access Boundary-nya ingin Anda lihat. Untuk mengetahui daftar jenis akun utama yang valid, lihat Set akun utama yang didukung. FORMAT: Format untuk respons. Gunakanjsonatauyaml.
Jalankan perintah berikut:
Linux, macOS, atau Cloud Shell
gcloud iam policy-bindings search-target-policy-bindings \ --RESOURCE_TYPE=RESOURCE_ID \ --target=PRINCIPAL_SET \ --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings search-target-policy-bindings ` --RESOURCE_TYPE=RESOURCE_ID ` --target=PRINCIPAL_SET ` --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings search-target-policy-bindings ^ --RESOURCE_TYPE=RESOURCE_ID ^ --target=PRINCIPAL_SET ^ --format=FORMAT
Respons berisi semua binding kebijakan yang menyertakan set akun utama target.
{
"policyBindings": [
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy1",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2024-05-06T18:11:16.798841Z"
},
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy2",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_10358560617928851457",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_4331055466646863873",
"updateTime": "2024-05-06T18:11:16.798841Z"
}
]
}
REST
Metode
SearchTargetPolicyBindings.search
mendapatkan semua binding kebijakan Principal Access Boundary untuk set akun utama.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
-
RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang merupakan induk dari set akun utama target. Gunakan nilaiprojects,folders, atauorganizations.Jenis resource bergantung pada jenis set akun utama yang ingin Anda cantumkan binding kebijakan-nya. Untuk melihat jenis resource yang akan digunakan, lihat Set akun utama yang didukung.
RESOURCE_ID: ID project, folder, atau organisasi yang merupakan induk dari set akun utama target. Project ID adalah string alfanumerik, sepertimy-project. ID folder dan ID organisasi berupa numerik, seperti123456789012.-
PRINCIPAL_SET: Set akun utama yang binding kebijakan Batas Akses Utama-nya ingin Anda lihat. Untuk mengetahui daftar jenis akun utama yang valid, lihat Set akun utama yang didukung.
Metode HTTP dan URL:
GET https://iam.googleapis.com/v3/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings:searchTargetPolicyBindings?target=PRINCIPAL_SET
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Respons berisi semua binding kebijakan yang menyertakan set akun utama target.
{
"policyBindings": [
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 1",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy1",
"createTime": "2024-05-06T18:08:24.729843Z",
"updateTime": "2024-05-06T18:11:16.798841Z",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265"
},
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
"uid": "buid_4331055466646863873",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 2",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy2",
"createTime": "2024-05-06T18:08:24.729843Z",
"updateTime": "2024-05-06T18:11:16.798841Z",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_10358560617928851457"
}
]
}
Mencantumkan binding kebijakan untuk project, folder, atau organisasi
Untuk melihat semua binding kebijakan yang merupakan turunan dari project, folder, atau organisasi tertentu, cantumkan binding kebijakan untuk project, folder, atau organisasi tersebut.
Resource induk binding kebijakan bergantung pada akun utama yang ditetapkan dalam binding kebijakan. Untuk mempelajari lebih lanjut, lihat Jenis akun utama yang didukung.
Anda dapat melihat semua binding kebijakan untuk project, folder, atau organisasi menggunakan gcloud CLI atau IAM REST API.
gcloud
Perintah
gcloud iam policy-bindings list
mencantumkan semua binding kebijakan yang merupakan turunan dari resource tertentu.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
-
RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang merupakan induk dari binding kebijakan. Gunakan nilaiproject,folder, atauorganization.Jenis resource bergantung pada akun utama yang ditetapkan dalam binding kebijakan. Untuk melihat jenis resource yang akan digunakan, lihat Jenis akun utama yang didukung.
-
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 --RESOURCE_TYPE=RESOURCE_ID \ --location=global \ --filter=policyKind:PRINCIPAL_ACCESS_BOUNDARY \ --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings list --RESOURCE_TYPE=RESOURCE_ID ` --location=global ` --filter=policyKind:PRINCIPAL_ACCESS_BOUNDARY ` --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings list --RESOURCE_TYPE=RESOURCE_ID ^ --location=global ^ --filter=policyKind:PRINCIPAL_ACCESS_BOUNDARY ^ --format=FORMAT
Respons berisi binding kebijakan yang merupakan turunan dari resource dalam perintah.
{
"policyBindings": [
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy-1",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2024-05-06T18:08:24.729843Z"
},
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy-2",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_1566408245394800641",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_4331055466646863873",
"updateTime": "2024-05-07T07:05:06.203861Z"
}
]
}
REST
Metode
policyBindings.list
mencantumkan semua binding kebijakan yang merupakan turunan dari resource tertentu.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
-
RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang merupakan induk dari binding kebijakan. Gunakan nilaiprojects,folders, atauorganizations.Jenis resource bergantung pada akun utama yang ditetapkan dalam binding kebijakan. Untuk melihat jenis resource yang akan digunakan, lihat Jenis akun utama yang didukung.
-
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/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings?filter=policyKind:PRINCIPAL_ACCESS_BOUNDARY
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Respons berisi binding kebijakan 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": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy-1",
"policyUid": "puid_9519202237377675265",
"createTime": "2024-05-06T18:08:24.729843Z",
"updateTime": "2024-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": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy-2",
"policyUid": "puid_1566408245394800641",
"createTime": "2024-05-07T07:05:06.203861Z",
"updateTime": "2024-05-07T07:05:06.203861Z"
}
]
}
Mendapatkan binding kebijakan untuk kebijakan Batas Akses Akun Utama
Untuk melihat detail binding kebijakan tunggal, gunakan ID binding kebijakan untuk mendapatkan binding kebijakan.
Anda bisa mendapatkan binding kebijakan menggunakan gcloud CLI atau IAM REST API.
gcloud
Perintah
gcloud iam policy-bindings describe
mendapatkan binding kebijakan.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
-
BINDING_ID: ID binding kebijakan yang ingin Anda dapatkan—misalnya,example-binding. -
RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang merupakan induk dari binding kebijakan. Gunakan nilaiproject,folder, atauorganization.Jenis resource bergantung pada akun utama yang ditetapkan dalam binding kebijakan. Untuk melihat jenis resource yang akan digunakan, lihat Jenis akun utama yang didukung.
-
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 \ --RESOURCE_TYPE=RESOURCE_ID --location=global \ --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings describe BINDING_ID ` --RESOURCE_TYPE=RESOURCE_ID --location=global ` --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings describe BINDING_ID ^ --RESOURCE_TYPE=RESOURCE_ID --location=global ^ --format=FORMAT
Respons berisi binding kebijakan.
{
"createTime": "2024-05-06T18:08:24.729843Z",
"displayName": "Example binding",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2024-05-06T18:08:24.729843Z"
}
REST
Metode
policyBindings.get
mendapatkan binding kebijakan.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
-
RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang merupakan induk dari binding kebijakan. Gunakan nilaiprojects,folders, atauorganizations.Jenis resource bergantung pada akun utama yang ditetapkan dalam binding kebijakan. Untuk melihat jenis resource yang akan digunakan, lihat Jenis akun utama yang didukung.
-
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 kebijakan yang ingin Anda dapatkan—misalnya,example-binding.
Metode HTTP dan URL:
GET https://iam.googleapis.com/v3/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings/BINDING_ID
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Respons berisi binding kebijakan.
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
"policyUid": "puid_9519202237377675265",
"createTime": "2024-05-06T18:08:24.729843Z",
"updateTime": "2024-05-06T18:08:24.729843Z"
}
Langkah berikutnya
- Membuat dan menerapkan kebijakan Batas Akses Utama (PAB)
- Mengedit kebijakan Batas Akses Utama (PAB)
- Menghapus kebijakan Batas Akses Utama (PAB)