Membuat dan menerapkan kebijakan Batas Akses Utama

Kebijakan Principal Access Boundary (PAB) memungkinkan Anda membatasi resource yang dapat diakses oleh sekumpulan akun utama. Halaman ini menjelaskan cara membuat dan menerapkan kebijakan Batas Akses Principal.

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 Google Cloud dan API, 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 perintah 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 .

  • Baca ringkasan kebijakan Batas Akses Utama.

Peran yang diperlukan untuk membuat kebijakan Principal Access Boundary

Untuk mendapatkan izin yang diperlukan untuk membuat kebijakan Principal Access Boundary, minta administrator untuk memberi Anda peran IAM Principal Access Boundary Admin (roles/iam.principalAccessBoundaryAdmin) di organisasi Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin iam.principalaccessboundarypolicies.create yang diperlukan untuk membuat kebijakan Batas Akses Principal.

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

Peran yang diperlukan untuk menerapkan kebijakan Batas Akses Utama

Izin yang Anda perlukan untuk menerapkan kebijakan Principal Access Boundary bergantung pada set utama yang ingin Anda terapkan kebijakan tersebut.

Untuk mendapatkan izin yang Anda perlukan untuk menerapkan kebijakan Batas Akses Principal, minta administrator untuk memberi Anda peran IAM berikut:

  • Pengguna Batas Akses Akun Utama (roles/iam.principalAccessBoundaryUser) di organisasi
  • Menerapkan kebijakan Principal Access Boundary ke workforce identity pool: IAM Workforce Pool Admin (roles/iam.workforcePoolAdmin) di workforce identity pool target
  • Menerapkan kebijakan Batas Akses Akun Utama ke workload identity pool: IAM Workload Identity Pool Admin (roles/iam.workloadIdentityPoolAdmin) di project yang memiliki workload identity pool target
  • Mendapatkan status operasi yang berjalan lama untuk menerapkan kebijakan Principal Access Boundary ke workload identity pool: IAM Operation Viewer (roles/iam.operationViewer) pada project yang memiliki target workload identity pool
  • Menerapkan kebijakan Batas Akses Principal ke domain Google Workspace: Admin IAM Pool Workspace (roles/iam.workspacePoolAdmin) di organisasi
  • Menerapkan kebijakan Batas Akses Principal ke set principal project: Admin IAM Project (roles/resourcemanager.projectIamAdmin) pada project tersebut
  • Mendapatkan status operasi yang berjalan lama untuk menerapkan kebijakan Batas Akses Akun Utama ke set akun utama project: Pelihat Operasi IAM (roles/iam.operationViewer) pada project
  • Menerapkan kebijakan Batas Akses Akun Utama ke set akun utama folder: Admin IAM Folder (roles/resourcemanager.folderIamAdmin) di folder tersebut
  • Menerapkan kebijakan Batas Akses Akun Utama ke set akun utama organisasi: Administrator Organisasi (roles/resourcemanager.organizationAdmin) pada organisasi tersebut

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

Peran bawaan ini berisi izin yang diperlukan untuk menerapkan kebijakan Batas Akses Principal. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk menerapkan kebijakan Batas Akses Principal:

  • iam.principalaccessboundarypolicies.bind di organisasi
  • Menerapkan kebijakan Batas Akses Principal ke kumpulan Workforce Identity Federation: iam.workforcePools.createPolicyBinding di kumpulan Workforce Identity Federation target
  • Menerapkan kebijakan Batas Akses Principal ke kumpulan Workload Identity Federation: iam.workloadIdentityPools.createPolicyBinding di project yang memiliki target kumpulan Workload Identity Federation
  • Dapatkan status operasi yang berjalan lama untuk menerapkan kebijakan Principal Access Boundary ke workload identity pool: iam.operations.get di project yang memiliki workload identity pool target
  • Menerapkan kebijakan Batas Akses Principal ke domain Google Workspace: iam.workspacePools.createPolicyBinding di organisasi
  • Menerapkan kebijakan Batas Akses Akun Utama ke set akun utama project: resourcemanager.projects.createPolicyBinding pada project
  • Mendapatkan status operasi yang berjalan lama untuk menerapkan kebijakan Batas Akses Akun Utama ke set akun utama project: iam.operations.get pada project
  • Menerapkan kebijakan Batas Akses Akun Utama ke set akun utama folder: resourcemanager.folders.createPolicyBinding pada folder
  • Terapkan kebijakan Batas Akses Utama ke set utama organisasi: resourcemanager.organizations.createPolicyBinding di organisasi

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

Membuat kebijakan Batas Akses Utama

Anda dapat membuat kebijakan Batas Akses Principal menggunakan konsol Google Cloud , gcloud CLI, atau IAM REST API.

Konsol

  1. Di konsol Google Cloud , buka halaman Principal Access Boundary policies.

    Buka kebijakan Principal Access Boundary

  2. Pilih organisasi yang ingin Anda buat kebijakan Batas Akses Principal-nya.

  3. Klik Buat kebijakan.

  4. Tambahkan aturan Batas Akses Utama ke kebijakan:

    1. Klik Tambahkan aturan batas.
    2. Di kolom Deskripsi, tambahkan deskripsi aturan kebijakan Principal Access Boundary. Deskripsi dapat berisi maksimal 256 karakter.

    3. Di bagian Resources, masukkan semua resource Resource Manager (project, folder, dan organisasi) yang Anda inginkan agar prinsipal memenuhi syarat untuk mengaksesnya. Setiap akun utama yang tunduk pada kebijakan ini berhak mengakses resource ini.

      Setiap kebijakan Batas Akses Akun Utama dapat mereferensikan maksimum 500 resource di semua aturan dalam kebijakan.

    4. Klik Done.

    5. Untuk menambahkan aturan kebijakan tambahan, ulangi langkah-langkah ini. Setiap kebijakan Batas Akses Akun Utama dapat memiliki hingga 500 aturan.

  5. Di bagian Policy name, masukkan nama untuk kebijakan. Nama dapat berisi maksimal 63 karakter.

  6. Dalam daftar Versi penegakan, pilih versi penegakan untuk kebijakan. Versi kebijakan Principal Access Boundary menentukan izin mana yang diterapkan IAM untuk kebijakan Principal Access Boundary.

    Untuk mengetahui informasi selengkapnya tentang cara menyetel dan mengelola versi penerapan, lihat Mengelola versi penerapan.

  7. Klik Create.

gcloud

Perintah gcloud iam principal-access-boundary-policies create membuat kebijakan Batas Akses Utama.

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

  • ORG_ID: ID organisasi tempat Anda ingin membuat kebijakan Principal Access Boundary. ID organisasi berupa angka, seperti 123456789012.
  • PAB_POLICY_ID: ID unik untuk kebijakan Principal Access Boundary—misalnya, example-policy. :
  • DISPLAY_NAME: Opsional. Deskripsi kebijakan Principal Access Boundary yang mudah dibaca, misalnya, Example policy. Nama tampilan dapat terdiri dari maksimal 63 karakter.

  • FILE_PATH: Jalur ke file JSON yang berisi detail aturan kebijakan Batas Akses Principal. Setiap aturan harus memiliki format berikut: 

    {
  "description": "DESCRIPTION",
  "resources": [
    RESOURCES
  ],
  "effect": "ALLOW"
}

    Ganti nilai berikut:

    • DESCRIPTION: Opsional. Deskripsi aturan kebijakan Batas Akses Utama. Deskripsi dapat berisi maksimal 256 karakter.

    • RESOURCES: Daftar resource Resource Manager (project, folder, dan organisasi) yang Anda inginkan agar pokok dapat mengaksesnya. Setiap akun utama yang tunduk pada kebijakan ini memenuhi syarat untuk mengakses resource ini.

      Setiap kebijakan Batas Akses Akun Utama dapat mereferensikan maksimum 500 resource di semua aturan dalam kebijakan.

  • ENFORCEMENT_VERSION: Versi kebijakan Principal Access Boundary yang digunakan IAM saat menerapkan kebijakan. Versi penerapan menentukan izin yang diterapkan IAM kebijakan Batas Akses Akun Utama.

    Nilai yang diterima adalah 1, 2, 3, 4, dan latest .

    Untuk mengetahui informasi selengkapnya tentang cara menyetel dan mengelola versi penerapan, lihat Pengelolaan versi penerapan.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam principal-access-boundary-policies create PAB_POLICY_ID \
    --organization=ORG_ID --location=global \
    --display-name=DISPLAY_NAME --details-rules=FILE_PATH.json \
    --details-enforcement-version=ENFORCEMENT_VERSION

Windows (PowerShell)

gcloud iam principal-access-boundary-policies create PAB_POLICY_ID `
    --organization=ORG_ID --location=global `
    --display-name=DISPLAY_NAME --details-rules=FILE_PATH.json `
    --details-enforcement-version=ENFORCEMENT_VERSION

Windows (cmd.exe)

gcloud iam principal-access-boundary-policies create PAB_POLICY_ID ^
    --organization=ORG_ID --location=global ^
    --display-name=DISPLAY_NAME --details-rules=FILE_PATH.json ^
    --details-enforcement-version=ENFORCEMENT_VERSION

Respons berisi operasi yang berjalan lama yang merepresentasikan permintaan Anda. Untuk mempelajari cara mendapatkan status operasi yang berjalan lama, lihat Memeriksa status operasi yang berjalan lama di halaman ini. 

Create request issued for: [example-policy]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715373988044-6181fa136df85-3b06a30a-4816d25b] to complete...done.
Created principalAccessBoundaryPolicy [example-policy].

REST

Metode principalAccessBoundaryPolicies.create membuat kebijakan Batas Akses Utama.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • ORG_ID: ID organisasi tempat Anda ingin membuat kebijakan Principal Access Boundary. ID organisasi berupa angka, seperti 123456789012.
  • PAB_POLICY_ID: ID unik untuk kebijakan Principal Access Boundary—misalnya, example-policy.
  • DISPLAY_NAME: Opsional. Deskripsi kebijakan Principal Access Boundary yang mudah dibaca, misalnya, Example policy. Nama tampilan dapat terdiri dari maksimal 63 karakter.

  • PAB_RULES: Daftar aturan principal access boundary, yang menentukan resource yang dapat diakses oleh entitas yang terpengaruh. Kebijakan Principal Access Boundary dapat memiliki hingga 500 aturan. Setiap aturan memiliki format berikut: 

    {
  "description": "DESCRIPTION",
  "resources": [
    RESOURCES
  ],
  "effect": "ALLOW"
}

    Ganti nilai berikut:

    • DESCRIPTION: Opsional. Deskripsi aturan kebijakan Batas Akses Utama. Deskripsi dapat berisi maksimal 256 karakter.

    • RESOURCES: Daftar resource Resource Manager (project, folder, dan organisasi) yang Anda inginkan agar pokok dapat mengaksesnya. Setiap akun utama yang tunduk pada kebijakan ini memenuhi syarat untuk mengakses resource ini.

      Setiap kebijakan Batas Akses Akun Utama dapat mereferensikan maksimum 500 resource di semua aturan dalam kebijakan.

  • ENFORCEMENT_VERSION: Versi kebijakan Principal Access Boundary yang digunakan IAM saat menerapkan kebijakan. Versi penerapan menentukan izin yang diterapkan IAM kebijakan Batas Akses Akun Utama.

    Nilai yang diterima adalah 1, 2, 3, 4, dan latest .

    Untuk mengetahui informasi selengkapnya tentang cara menyetel dan mengelola versi penerapan, lihat Pengelolaan versi penerapan.

Metode HTTP dan URL: 

POST https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global?principalAccessBoundaryPolicyId=PAB_POLICY_ID

Meminta isi JSON: 

{
  "displayName": "DISPLAY_NAME",
  "details": {
    "rules": [
      PAB_RULES
    ],
    "enforcementVersion": "ENFORCEMENT_VERSION"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Respons berisi operasi yang berjalan lama yang merepresentasikan permintaan Anda. Untuk mempelajari cara mendapatkan status operasi yang berjalan lama, lihat Memeriksa status operasi yang berjalan lama di halaman ini. 

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715373120647-6181f6d8371d2-83309b71-2b8a7532",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-05-10T20:32:00.898809495Z",
    "target": "organizations/123456789012/locations/global/policyBindings/example-policy",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

Menerapkan kebijakan Batas Akses Akun Utama ke set akun utama

Untuk menerapkan kebijakan Batas Akses Akun Utama ke set akun utama, buat resource pengikatan kebijakan yang mengikat kebijakan ke set akun utama. Setelah Anda membuat pengikatan kebijakan, kebijakan Batas Akses Utama dalam pengikatan tersebut akan diterapkan untuk akun utama dalam pengikatan tersebut.

Anda dapat membuat binding kebijakan menggunakan konsol Google Cloud , gcloud CLI, atau IAM REST API.

Konsol

  1. Di konsol Google Cloud , buka halaman Principal Access Boundary policies.

    Buka kebijakan Principal Access Boundary

  2. Pilih organisasi yang memiliki kebijakan Batas Akses Principal yang ingin Anda buat binding-nya.

  3. Klik ID kebijakan Principal Access Boundary yang ingin Anda buat binding-nya.

  4. Klik tab Bindings, lalu klik Add binding.

  5. Masukkan detail binding:

    1. Opsional: Di kolom Nama tampilan, masukkan nama tampilan untuk binding. Nama tampilan dapat terdiri dari maksimal 63 karakter.
    2. Di kolom Binding ID, masukkan nama unik untuk binding—misalnya, example-binding.

    3. Di bagian Target principal set, masukkan jenis dan ID principal set yang ingin Anda ikat dengan kebijakan. Anda tidak dapat mengubah nilai ini setelah membuat pengikatan kebijakan.

      Untuk mempelajari lebih lanjut prinsipal yang disertakan dalam setiap set prinsipal, lihat Set prinsipal yang didukung.

  6. Opsional: Untuk menentukan akun utama mana dalam set akun utama yang diberlakukan kebijakan Principal Access Boundary, tambahkan kondisi ke binding:

    1. Klik Tambahkan kondisi.
    2. Di kolom Title, masukkan ringkasan singkat tentang tujuan kondisi.
    3. Opsional: Di kolom Description, masukkan deskripsi kondisi yang lebih panjang.
    4. Di kolom Expression, masukkan ekspresi kondisi yang menggunakan sintaksis Common Expression Language (CEL). Ekspresi harus merujuk pada atribut principal.type atau principal.subject. Atribut lainnya tidak didukung.
    5. Klik Simpan.

  7. Opsional: Untuk menguji perubahan pada kebijakan Batas Akses Akun Utama dengan Policy Simulator, klik Uji perubahan. Tinjau hasil simulasi dan perbarui kebijakan jika perlu.

    Untuk mempelajari lebih lanjut cara menguji kebijakan Principal Access Boundary dengan Policy Simulator, lihat Policy Simulator untuk kebijakan Principal Access Boundary.

  8. Untuk membuat binding, klik Tambahkan.

gcloud

Perintah gcloud iam policy-bindings create membuat binding kebijakan.

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

  • BINDING_ID: Nama unik untuk pengikatan kebijakan—misalnya, example-binding.

  • RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang merupakan induk dari binding kebijakan. Gunakan nilai project, folder, atau organization

    Jenis resource bergantung pada prinsipal yang ditetapkan dalam binding kebijakan. Untuk melihat jenis resource yang akan digunakan, lihat Jenis utama yang didukung.

  • RESOURCE_ID: ID project, folder, atau organisasi yang menjadi induk binding kebijakan. Project ID adalah string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
  • ORG_ID: ID organisasi yang memiliki kebijakan Principal Access Boundary yang ingin Anda ikat ke set akun utama. ID organisasi berupa angka, seperti 123456789012.
  • PAB_POLICY_ID: ID kebijakan Principal Access Boundary yang ingin Anda ikat ke set utama—misalnya, example-pab-policy. Anda tidak dapat mengubah nilai ini setelah membuat pengikatan kebijakan.
  • PRINCIPAL_SET: Set akun utama yang ingin Anda ikat dengan kebijakan. Untuk mengetahui daftar jenis akun utama yang valid, lihat Set akun utama yang didukung. Anda tidak dapat mengubah nilai ini setelah membuat pengikatan kebijakan.
  • DISPLAY_NAME: Opsional. Deskripsi binding yang dapat dibaca manusia—misalnya, Example binding. Nama tampilan dapat terdiri dari maksimal 63 karakter.

  • CONDITION_DETAILS: Opsional. Ekspresi kondisi yang menentukan akun utama mana dalam set akun utama yang kebijakan Batas Akses Akun Utama diterapkan. Berisi kolom berikut:

    • expression: Ekspresi kondisi yang menggunakan sintaksis Common Expression Language (CEL). Ekspresi harus mereferensikan atribut principal.type atau principal.subject. Atribut lainnya tidak didukung.

      Ekspresi dapat berisi hingga 10 operator logis (&&, ||, !), dan panjangnya bisa mencapai 250 karakter.

    • title: Opsional. Rangkuman singkat dari tujuan terhadap kondisi.
    • description: Opsional. Deskripsi panjang dari kondisi.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam policy-bindings create BINDING_ID \
    --RESOURCE_TYPE=RESOURCE_ID --location=global \
    --policy="organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID" \
    --target-principal-set=PRINCIPAL_SET_ID \
    --display-name=DISPLAY_NAME \
    CONDITION_DETAILS

Windows (PowerShell)

gcloud iam policy-bindings create BINDING_ID `
    --RESOURCE_TYPE=RESOURCE_ID --location=global `
    --policy="organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID" `
    --target-principal-set=PRINCIPAL_SET_ID `
    --display-name=DISPLAY_NAME `
    CONDITION_DETAILS

Windows (cmd.exe)

gcloud iam policy-bindings create BINDING_ID ^
    --RESOURCE_TYPE=RESOURCE_ID --location=global ^
    --policy="organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID" ^
    --target-principal-set=PRINCIPAL_SET_ID ^
    --display-name=DISPLAY_NAME ^
    CONDITION_DETAILS

Respons berisi operasi yang berjalan lama yang merepresentasikan permintaan Anda. Untuk mempelajari cara mendapatkan status operasi yang berjalan lama, lihat Memeriksa status operasi yang berjalan lama di halaman ini. 

Create request issued for: [example-binding]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374545618-6181fc272c6f9-55ff07f4-97d0ac76] to complete...done.
Created policyBinding [example-binding].

REST

Metode policyBindings.create membuat 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 nilai projects, folders, atau organizations

    Jenis resource bergantung pada prinsipal yang ditetapkan dalam binding kebijakan. Untuk melihat jenis resource yang akan digunakan, lihat Jenis utama yang didukung.

  • RESOURCE_ID: ID project, folder, atau organisasi yang menjadi induk binding kebijakan. Project ID adalah string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
  • BINDING_ID: Nama unik untuk pengikatan kebijakan—misalnya, example-binding.
  • DISPLAY_NAME: Opsional. Deskripsi binding yang dapat dibaca manusia—misalnya, Example binding. Nama tampilan dapat terdiri dari maksimal 63 karakter.
  • PRINCIPAL_SET: Set akun utama yang ingin Anda ikat dengan kebijakan. Untuk mengetahui daftar jenis akun utama yang valid, lihat Set akun utama yang didukung. Anda tidak dapat mengubah nilai ini setelah membuat pengikatan kebijakan.
  • ORG_ID: ID organisasi yang memiliki kebijakan Principal Access Boundary yang ingin Anda ikat ke set akun utama. ID organisasi berupa angka, seperti 123456789012.
  • PAB_POLICY_ID: ID kebijakan Principal Access Boundary yang ingin Anda ikat ke set utama—misalnya, example-pab-policy. Anda tidak dapat mengubah nilai ini setelah membuat pengikatan kebijakan.

  • CONDITION_DETAILS: Opsional. Ekspresi kondisi yang menentukan akun utama mana dalam set akun utama yang kebijakan Batas Akses Akun Utama diterapkan. Berisi kolom berikut:

    • expression: Ekspresi kondisi yang menggunakan sintaksis Common Expression Language (CEL). Ekspresi harus mereferensikan atribut principal.type atau principal.subject. Atribut lainnya tidak didukung.

      Ekspresi dapat berisi hingga 10 operator logis (&&, ||, !), dan panjangnya bisa mencapai 250 karakter.

    • title: Opsional. Rangkuman singkat dari tujuan terhadap kondisi.
    • description: Opsional. Deskripsi panjang dari kondisi.

Metode HTTP dan URL: 

POST https://iam.googleapis.com/v3/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings?policyBindingId=BINDING_ID

Meminta isi JSON: 

{
  "displayName": DISPLAY_NAME,
  "target": {
    "principalSet": PRINCIPAL_SET
  },
  "policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
  "policy": "organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID",
  "condition": {
    CONDITION_DETAILS
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Respons berisi operasi yang berjalan lama yang merepresentasikan permintaan Anda. Untuk mempelajari cara mendapatkan status operasi yang berjalan lama, lihat Memeriksa status operasi yang berjalan lama di halaman ini. 

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715373120647-6181f6d8371d2-83309b71-2b8a7532",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-05-10T20:32:00.898809495Z",
    "target": "organizations/123456789012/locations/global/policyBindings/example-binding",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

Memeriksa status operasi yang berjalan lama

Saat Anda menggunakan REST API atau library klien, metode apa pun yang mengubah kebijakan atau binding Principal Access Boundary akan menampilkan operasi yang berjalan lama (LRO). Operasi yang berjalan lama akan melacak status permintaan dan menunjukkan apakah perubahan pada kebijakan atau binding sudah selesai.

REST

Metode operations.get menampilkan status operasi yang berjalan lama.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • OPERATION_NAME: Nama lengkap operasi. Anda menerima nama ini sebagai respons atas permintaan asli Anda.

    Nama operasi memiliki format berikut: 

          RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID

Metode HTTP dan URL: 

GET https://iam.googleapis.com/v3/OPERATION_NAME

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "name": "organizations/314340013352/locations/global/operations/operation-1732752311821-627edd607a3df-9a62cdea-2a7d9f07",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-11-28T00:05:12.006289686Z",
    "endTime": "2024-11-28T00:05:12.192141801Z",
    "target": "organizations/314340013352/locations/global/principalAccessBoundaryPolicies/example-policy",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": true,
  "response": {
    PAB_POLICY
  }
}

Jika kolom done operasi tidak ada, terus pantau statusnya dengan mendapatkan operasi tersebut berulang kali. Gunakan backoff eksponensial terpotong untuk menambahkan penundaan di antara setiap permintaan. Saat kolom done ditetapkan ke true, operasi akan selesai, dan Anda dapat berhenti mendapatkan operasi tersebut.

Langkah berikutnya