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 Utama (PAB).

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.

    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 .

  • Baca ringkasan kebijakan Batas Akses Utama (PAB).

Peran yang diperlukan untuk membuat kebijakan Principal Access Boundary

Untuk mendapatkan izin yang Anda perlukan 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 yang telah ditetapkan ini berisi izin iam.principalaccessboundarypolicies.create, yang diperlukan untuk membuat kebijakan Batas Akses Akun Utama.

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 Batas Akses Akun Utama bergantung pada set akun utama yang ingin Anda terapkan kebijakannya.

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

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

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 Akun Utama. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk menerapkan kebijakan Batas Akses Utama:

  • iam.principalaccessboundarypolicies.bind pada organisasi
  • Terapkan kebijakan Batas Akses Akun Utama ke kumpulan Workforce Identity Federation: iam.workforcePools.createPolicyBinding di kumpulan Workforce Identity Federation target
  • Terapkan kebijakan Batas Akses Akun Utama ke pool Workforce Identity Federation: iam.workloadIdentityPools.createPolicyBinding pada project yang memiliki pool Workforce Identity Federation target
  • Dapatkan status operasi yang berjalan lama untuk menerapkan kebijakan Batas Akses Akun Utama ke workload identity pool: iam.operations.get pada project yang memiliki workload identity pool target
  • Terapkan kebijakan Batas Akses Akun Utama 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
  • Dapatkan status operasi yang berjalan lama untuk menerapkan kebijakan Batas Akses Akun Utama ke set akun utama project: iam.operations.get pada project
  • Terapkan kebijakan Batas Akses Akun Utama ke set akun utama folder: resourcemanager.folders.createPolicyBinding pada folder
  • Terapkan kebijakan Batas Akses Akun Utama ke set akun 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 Akun Utama

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

Konsol

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

    Buka kebijakan Batas Akses Utama (PAB)

  2. Pilih organisasi yang ingin Anda buatkan kebijakan Batas Akses Utama (PAB).

  3. Klik Buat kebijakan.

  4. Tambahkan aturan Principal Access Boundary ke kebijakan:

    1. Klik Add boundary rule.
    2. Di kolom Description, tambahkan deskripsi aturan kebijakan Batas Akses Akun Utama. Deskripsi dapat berisi maksimal 256 karakter.
    3. Di bagian Resource, masukkan semua resource Resource Manager (project, folder, dan organisasi) yang ingin Anda izinkan untuk diakses oleh akun utama. Setiap akun utama yang tunduk pada kebijakan ini memenuhi syarat untuk mengakses resource ini.

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

    4. Klik Done.

    5. Untuk menambahkan aturan kebijakan lainnya, ulangi langkah-langkah ini. Setiap kebijakan Principal Access Boundary dapat memiliki hingga 500 aturan.

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

  6. Dalam daftar Enforcement version, 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 menetapkan dan mengelola versi penerapan, lihat Mengelola versi penerapan.

  7. Klik Create.

gcloud

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

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

  • PAB_POLICY_ID: ID unik untuk kebijakan Batas Akses Akun Utama—misalnya, example-policy.
  • ORG_ID: ID organisasi tempat Anda ingin membuat kebijakan Batas Akses Akun Utama. ID organisasi berupa angka, seperti 123456789012.
  • DISPLAY_NAME: Opsional. Deskripsi yang dapat dibaca manusia tentang kebijakan Principal Access Boundary—misalnya, Example policy. Nama tampilan dapat berisi maksimal 63 karakter.
  • FILE_PATH: Jalur ke file JSON yang berisi detail aturan kebijakan Batas Akses Akun Utama. Setiap aturan harus memiliki format berikut:

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

    Ganti nilai berikut:

    • DESCRIPTION: Opsional. Deskripsi aturan kebijakan Principal Access Boundary. Deskripsi dapat berisi maksimal 256 karakter.
    • RESOURCES: Daftar resource Resource Manager (project, folder, dan organisasi) yang aksesnya dapat diberikan kepada akun utama. Setiap akun utama yang tunduk pada kebijakan ini memenuhi syarat untuk mengakses resource ini.

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

  • ENFORCEMENT_VERSION: Versi kebijakan Batas Akses Utama (PAB) yang digunakan IAM saat menerapkan kebijakan. Versi penerapan menentukan izin mana yang diterapkan IAM untuk kebijakan Principal Access Boundary.

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

    Untuk mengetahui informasi selengkapnya tentang cara menetapkan 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 mewakili 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 Akun Utama.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • ORG_ID: ID organisasi tempat Anda ingin membuat kebijakan Batas Akses Akun Utama. ID organisasi berupa angka, seperti 123456789012.
  • PAB_POLICY_ID: ID unik untuk kebijakan Batas Akses Akun Utama—misalnya, example-policy.
  • DISPLAY_NAME: Opsional. Deskripsi yang dapat dibaca manusia tentang kebijakan Principal Access Boundary—misalnya, Example policy. Nama tampilan dapat berisi maksimal 63 karakter.
  • PAB_RULES: Daftar aturan Principal Access Boundary, yang menentukan resource yang dapat diakses oleh akun utama 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 Principal Access Boundary. Deskripsi dapat berisi maksimal 256 karakter.
    • RESOURCES: Daftar resource Resource Manager (project, folder, dan organisasi) yang aksesnya dapat diberikan kepada akun utama. Setiap akun utama yang tunduk pada kebijakan ini memenuhi syarat untuk mengakses resource ini.

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

  • ENFORCEMENT_VERSION: Versi kebijakan Batas Akses Utama (PAB) yang digunakan IAM saat menerapkan kebijakan. Versi penerapan menentukan izin mana yang diterapkan IAM untuk kebijakan Principal Access Boundary.

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

    Untuk mengetahui informasi selengkapnya tentang cara menetapkan 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 mewakili 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 binding kebijakan yang mengikat kebijakan ke set akun utama. Setelah Anda membuat binding kebijakan, kebijakan Batas Akses Akun Utama dalam binding tersebut akan diterapkan untuk akun utama dalam binding 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 Batas Akses Utama (PAB)

  2. Pilih organisasi yang memiliki kebijakan Batasan Akses Akun Utama yang ingin Anda buatkan binding-nya.

  3. Klik ID kebijakan dari kebijakan Principal Access Boundary yang ingin Anda buatkan binding.

  4. Klik tab Bindings, lalu klik Add binding.

  5. Masukkan detail binding:

    1. Opsional: Di kolom Display name, masukkan nama tampilan untuk binding. Nama tampilan dapat berisi 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 set akun utama yang ingin Anda ikat dengan kebijakan. Anda tidak dapat mengubah nilai ini setelah membuat binding kebijakan.

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

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

    1. Klik Add condition.
    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 ke atribut principal.type atau principal.subject. Atribut lainnya tidak didukung.
    5. Klik Simpan.
  7. Opsional: Untuk menguji perubahan Anda pada binding kebijakan Batas Akses Akun Utama dengan Policy Simulator, klik Test changes. Tinjau hasil simulasi dan perbarui binding kebijakan jika perlu.

    Untuk mempelajari lebih lanjut cara menguji kebijakan Batas Akses Utama dengan Policy Simulator, lihat Policy Simulator untuk kebijakan Batas Akses Utama.

  8. Untuk membuat binding, klik Add.

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 binding 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 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, seperti my-project. ID folder dan ID organisasi berupa numerik, seperti 123456789012.
  • ORG_ID: ID organisasi yang memiliki kebijakan Batasan Akses Akun Utama yang ingin Anda ikat ke set akun utama. ID organisasi berupa angka, seperti 123456789012.
  • PAB_POLICY_ID: ID kebijakan Batas Akses Akun Utama yang ingin Anda ikat ke set akun utama—misalnya, example-pab-policy. Anda tidak dapat mengubah nilai ini setelah membuat binding 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 binding kebijakan.
  • DISPLAY_NAME: Opsional. Deskripsi binding yang dapat dibaca manusia—misalnya, Example binding. Nama tampilan dapat berisi maksimal 63 karakter.
  • CONDITION_DETAILS: Opsional. Ekspresi kondisi yang menentukan akun utama mana dalam set akun utama yang akan menerapkan kebijakan Batas Akses Akun Utama. Berisi kolom berikut:

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 \
    --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 `
    --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 ^
    --display-name=DISPLAY_NAME ^
    CONDITION_DETAILS

Respons berisi operasi yang berjalan lama yang mewakili 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 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, seperti my-project. ID folder dan ID organisasi berupa numerik, seperti 123456789012.
  • BINDING_ID: Nama unik untuk binding kebijakan—misalnya, example-binding.
  • DISPLAY_NAME: Opsional. Deskripsi binding yang dapat dibaca manusia—misalnya, Example binding. Nama tampilan dapat berisi 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 binding kebijakan.
  • ORG_ID: ID organisasi yang memiliki kebijakan Batasan Akses Akun Utama yang ingin Anda ikat ke set akun utama. ID organisasi berupa angka, seperti 123456789012.
  • PAB_POLICY_ID: ID kebijakan Batas Akses Akun Utama yang ingin Anda ikat ke set akun utama—misalnya, example-pab-policy. Anda tidak dapat mengubah nilai ini setelah membuat binding kebijakan.
  • CONDITION_DETAILS: Opsional. Ekspresi kondisi yang menentukan akun utama mana dalam set akun utama yang akan menerapkan kebijakan Batas Akses Akun Utama. Berisi kolom berikut:

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 mewakili 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 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/POLICY_TYPE/POLICY_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": true,
  "response": {
    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