Unified Access Policy (UAP) memungkinkan Anda memberikan dan menolak akses akun utama ke resourceGoogle Cloud . Dokumen ini menjelaskan cara membuat dan menerapkan UAP.
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 membuat Unified Access Policies
Untuk mendapatkan izin yang
diperlukan untuk membuat UAP,
minta administrator untuk memberi Anda
peran IAM Access Policy Admin (roles/iam.accessPolicyAdmin) di
project, folder, atau organisasi tempat Anda ingin membuat kebijakan
.
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 membuat UAP. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk membuat UAP:
-
iam.accesspolicies.create -
Buat UAP di konsol Google Cloud :
iam.accesspolicies.list
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Peran yang diperlukan untuk menerapkan Unified Access Policies
Untuk mendapatkan izin yang Anda perlukan untuk mengikat UAP ke resource, minta administrator untuk memberi Anda peran IAM berikut:
- Access Policy Admin (
roles/iam.accessPolicyAdmin) pada resource yang memiliki UAP. Peran ini berisi iziniam.accesspolicies.bind, yang diperlukan untuk membuat binding. Peran yang mencakup izin
SERVICE.RESOURCE.createPolicyBinding, denganRESOURCEadalah jenis resource yang ingin Anda ikat dengan kebijakan danSERVICEadalah layanan yang memiliki resource tersebut.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 atau salah satu ancestor-nya.
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Membuat Unified Access Policy
Anda dapat membuat UAP 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 tempat Anda ingin membuat UAP. Untuk panduan tentang tempat membuat UAP, lihat Tempat membuat UAP.
- Klik Create policy.
-
Di kolom Policy name, masukkan nama untuk
UAP—misalnya,
Example policy. Nama dapat berisi maksimal 63 karakter. - Opsional: Di kolom Policy ID, sesuaikan ID untuk UAP.
-
Tambahkan aturan ke kebijakan. Untuk setiap aturan, lakukan hal berikut:
- Opsional: Di kolom Description, masukkan deskripsi untuk aturan.
- Di kolom Principals, masukkan akun utama yang ingin Anda sertakan dalam aturan.
- Opsional: Di kolom Excluded principals, masukkan akun utama yang tidak ingin Anda sertakan dalam aturan. Akun utama ini tidak akan disertakan, meskipun merupakan bagian dari grup di kolom Principals.
-
Pilih efek yang Anda inginkan untuk aturan tersebut:
- Untuk memberikan izin yang ditentukan kepada akun utama yang ditentukan, pilih efek Allow.
- Untuk mencegah akun utama yang ditentukan menggunakan izin yang ditentukan, pilih efek Deny.
-
Pilih izin yang akan disertakan dalam aturan:
- Untuk aturan dengan efek Allow, Anda dapat menentukan peran dan izin yang akan disertakan atau dikecualikan dari aturan. Untuk mengetahui informasi selengkapnya tentang peran dan izin yang dapat Anda sertakan, lihat Peran dan izin dalam aturan UAP.
- Untuk aturan dengan efek Deny, tentukan izin yang ingin Anda sertakan atau kecualikan dari aturan. Untuk mengetahui informasi selengkapnya tentang izin yang dapat Anda sertakan, lihat Peran dan izin dalam aturan UAP.
-
Opsional: Tambahkan kondisi yang akan menerapkan aturan. Untuk mempelajari lebih lanjut atribut kondisi yang didukung, lihat Kondisi di UAP.
- Setelah selesai mengedit aturan, klik Selesai.
- Untuk menambahkan aturan lain, klik Tambahkan aturan, lalu tambahkan detail aturan.
- Setelah selesai menambahkan aturan, klik Buat kebijakan.
gcloud
Perintah
gcloud iam access-policies create
membuat UAP.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
-
UAP_ID: ID unik untuk UAP—misalnya,example-policy. -
UAP_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) tempat Anda ingin membuat UAP. Gunakan nilaiproject,folder, atauorganization. -
UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi tempat Anda ingin membuat UAP. Project ID adalah string alfanumerik, sepertimy-project. ID folder dan ID organisasi berupa numerik, seperti123456789012. DISPLAY_NAME: Opsional. Deskripsi UAP yang dapat dibaca manusia—misalnya,Example policy. Nama tampilan dapat berisi maksimal 63 karakter.-
FILE_PATH: Jalur ke file JSON yang berisi detail aturan UAP. Setiap aturan harus memiliki format berikut:{ "description": "DESCRIPTION", "effect": "EFFECT", "principals": [ INCLUDED_PRINCIPALS ], "excludedPrincipals": [ EXCLUDED_PRINCIPALS ], "operation": { "permissions": [ INCLUDED_PERMISSIONS ], "excludedPermissions": [ EXCLUDED_PERMISSIONS ] }, CONDITIONS }
Ganti nilai berikut:
-
DESCRIPTION: Deskripsi yang dapat dibaca manusia untuk aturan. -
EFFECT: Cara aturan memengaruhi akses. Nilai yang didukung adalahALLOWdanDENY:-
ALLOW: Memberikan izin yang ditentukan kepada akun utama yang ditentukan. -
DENY: Mencegah akun utama yang ditentukan menggunakan izin yang ditentukan.
-
-
Ganti nilai berikut untuk menentukan akun utama yang disertakan dalam aturan:
-
INCLUDED_PRINCIPALS: Akun utama yang akan disertakan dalam aturan. -
EXCLUDED_PRINCIPALS: Opsional. Akun utama yang akan dikecualikan dari aturan, meskipun akun utama tersebut ada dalam daftar akun utama yang disertakan. Misalnya, Anda dapat menambahkan grup Google ke daftar akun utama yang disertakan, lalu mengecualikan pengguna tertentu yang termasuk dalam grup tersebut.
Untuk mengetahui daftar ID akun utama yang didukung, lihat Jenis akun utama untuk UAP.
-
-
Ganti nilai berikut untuk menentukan izin yang akan disertakan dalam aturan:
-
INCLUDED_PERMISSIONS: Izin yang akan disertakan dalam aturan. -
EXCLUDED_PERMISSIONS: Opsional. Izin yang akan dikecualikan dari aturan, meskipun izin tersebut ada dalam daftar izin yang disertakan. Misalnya, Anda dapat menambahkan peran ke daftar izin yang disertakan, lalu mengecualikan izin tertentu dalam peran tersebut.
Saat membuat daftar izin ini, Anda dapat mereferensikan nama izin, nama peran, dan grup izin. Untuk mempelajari lebih lanjut, lihat Peran dan izin dalam aturan UAP.
-
-
CONDITIONS: Opsional. Kondisi yang berlaku untuk aturan. Gunakan format berikut:"conditions": { "SERVICE": { "title": "CONDITION_TITLE", "description": "CONDITION_DESCRIPTION", "expression": "CONDITION_EXPRESSION" } }
Ganti nilai berikut:
-
SERVICE: Layanan yang menyediakan atribut yang digunakan dalam ekspresi kondisi. -
CONDITION_TITLE: Opsional. Ringkasan singkat tujuan kondisi. -
CONDITION_DESCRIPTION: Opsional. Deskripsi panjang dari kondisi. -
CONDITION_EXPRESSION: Ekspresi boolean yang mereferensikan atribut upaya akses, seperti tag yang dilampirkan ke resource dalam upaya akses. Jika ekspresi bernilaitrue, aturan akan berlaku untuk upaya akses. Jika bernilaifalse, aturan tidak akan berlaku untuk upaya akses.
Untuk daftar atribut yang didukung dan layanannya, lihat Atribut kondisi yang didukung.
-
-
Jalankan perintah berikut:
Linux, macOS, atau Cloud Shell
gcloud iam access-policies create UAP_ID \ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \ --location=global --display-name=DISPLAY_NAME \ --details-rules=FILE_PATH
Windows (PowerShell)
gcloud iam access-policies create UAP_ID ` --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ` --location=global --display-name=DISPLAY_NAME ` --details-rules=FILE_PATH
Windows (cmd.exe)
gcloud iam access-policies create UAP_ID ^ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^ --location=global --display-name=DISPLAY_NAME ^ --details-rules=FILE_PATH
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 accessPolicy [example-policy].
REST
Metode
accessPolicies.create
membuat UAP.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
-
UAP_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) tempat Anda ingin membuat UAP. Gunakan nilaiprojects,folders, atauorganizations. -
UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi tempat Anda ingin membuat UAP. Project ID adalah string alfanumerik, sepertimy-project. ID folder dan ID organisasi berupa numerik, seperti123456789012. -
UAP_ID: ID unik untuk UAP—misalnya,example-policy. DISPLAY_NAME: Opsional. Deskripsi UAP yang dapat dibaca manusia—misalnya,Example policy. Nama tampilan dapat berisi maksimal 63 karakter.-
UAP_RULES: Daftar aturan UAP, yang menentukan akses yang akan diberikan atau ditolak dan akun utama yang akan diberikan atau ditolak aksesnya. UAP dapat memiliki hingga 100 aturan. Setiap aturan memiliki format berikut:{ "description": "DESCRIPTION", "effect": "EFFECT", "principals": [ INCLUDED_PRINCIPALS ], "excludedPrincipals": [ EXCLUDED_PRINCIPALS ], "operation": { "permissions": [ INCLUDED_PERMISSIONS ], "excludedPermissions": [ EXCLUDED_PERMISSIONS ] }, CONDITIONS }
Ganti nilai berikut:
-
DESCRIPTION: Deskripsi yang dapat dibaca manusia untuk aturan. -
EFFECT: Cara aturan memengaruhi akses. Nilai yang didukung adalahALLOWdanDENY:-
ALLOW: Memberikan izin yang ditentukan kepada akun utama yang ditentukan. -
DENY: Mencegah akun utama yang ditentukan menggunakan izin yang ditentukan.
-
-
Ganti nilai berikut untuk menentukan akun utama yang disertakan dalam aturan:
-
INCLUDED_PRINCIPALS: Akun utama yang akan disertakan dalam aturan. -
EXCLUDED_PRINCIPALS: Opsional. Akun utama yang akan dikecualikan dari aturan, meskipun akun utama tersebut ada dalam daftar akun utama yang disertakan. Misalnya, Anda dapat menambahkan grup Google ke daftar akun utama yang disertakan, lalu mengecualikan pengguna tertentu yang termasuk dalam grup tersebut.
Untuk mengetahui daftar ID akun utama yang didukung, lihat Jenis akun utama untuk UAP.
-
-
Ganti nilai berikut untuk menentukan izin yang akan disertakan dalam aturan:
-
INCLUDED_PERMISSIONS: Izin yang akan disertakan dalam aturan. -
EXCLUDED_PERMISSIONS: Opsional. Izin yang akan dikecualikan dari aturan, meskipun izin tersebut ada dalam daftar izin yang disertakan. Misalnya, Anda dapat menambahkan peran ke daftar izin yang disertakan, lalu mengecualikan izin tertentu dalam peran tersebut.
Saat membuat daftar izin ini, Anda dapat mereferensikan nama izin, nama peran, dan grup izin. Untuk mempelajari lebih lanjut, lihat Peran dan izin dalam aturan UAP.
-
-
CONDITIONS: Opsional. Kondisi yang berlaku untuk aturan. Gunakan format berikut:"conditions": { "SERVICE": { "title": "CONDITION_TITLE", "description": "CONDITION_DESCRIPTION", "expression": "CONDITION_EXPRESSION" } }
Ganti nilai berikut:
-
SERVICE: Layanan yang menyediakan atribut yang digunakan dalam ekspresi kondisi. -
CONDITION_TITLE: Opsional. Ringkasan singkat tujuan kondisi. -
CONDITION_DESCRIPTION: Opsional. Deskripsi panjang dari kondisi. -
CONDITION_EXPRESSION: Ekspresi boolean yang mereferensikan atribut upaya akses, seperti tag yang dilampirkan ke resource dalam upaya akses. Jika ekspresi bernilaitrue, aturan akan berlaku untuk upaya akses. Jika bernilaifalse, aturan tidak akan berlaku untuk upaya akses.
Untuk daftar atribut yang didukung dan layanannya, lihat Atribut kondisi yang didukung.
-
-
Metode HTTP dan URL:
POST https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies?accessPolicyId=UAP_ID
Meminta isi JSON:
{
"displayName": "DISPLAY_NAME",
"details": {
"rules": [
UAP_RULES
]
}
}
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": "2026-05-10T20:32:00.898809495Z",
"target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
Menerapkan Unified Access Policy ke resource
Untuk menerapkan UAP ke resource, Anda harus membuat binding. Setelah Anda membuat binding untuk kebijakan, aturan dalam kebijakan tersebut akan berlaku untuk resource yang ditentukan, serta turunan resource tersebut.
Sebelum membuat binding, pastikan
batasan kebijakan organisasi
iam.managed.disableAccessPolicyBinding dinonaktifkan. Untuk mempelajari cara
mengaktifkan atau menonaktifkan batasan ini, lihat Menggunakan batasan terkelola dalam
kebijakan organisasi.
Anda dapat menerapkan UAP ke project, folder, dan organisasi menggunakan konsol Google Cloud , gcloud CLI, atau IAM REST API. Untuk menerapkan UAP ke resource lain, Anda harus menggunakan 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 terapkan.
- Klik ID UAP yang ingin Anda terapkan.
- Pilih tab Bindings, lalu klik Add binding.
-
Di panel Add binding, edit detail binding:
- Di menu Binding location, pilih resource yang ingin Anda terapkan UAP.
-
Opsional: Di kolom Nama tampilan binding, masukkan deskripsi binding yang dapat dibaca manusia—misalnya,
Example binding. Nama tampilan dapat berisi maksimal 63 karakter. -
Di kolom Binding ID, masukkan nama unik untuk binding—misalnya,
example-binding.
- Klik Add binding.
gcloud
Perintah
gcloud iam policy-bindings create
membuat binding.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
-
BINDING_ID: Nama unik untuk binding—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. -
POLICY_PARENT_RESOURCE: Resource tempat UAP dibuat, dalam bentukRESOURCE_TYPE/RESOURCE_ID. Contohnya,organizations/0123456789012. UAP dapat dibuat di project, folder, atau organisasi. ID folder dan ID organisasi harus berupa angka. Project ID dapat berupa numerik atau alfanumerik. -
UAP_ID: ID UAP yang ingin Anda ikat ke resource—misalnya,example-uap. Anda tidak dapat mengubah nilai ini setelah membuat binding. -
TARGET_RESOURCE: Resource yang ingin Anda ikat dengan UAP. Untuk mengetahui daftar resource yang valid, lihat Resource yang didukung. Anda tidak dapat mengubah nilai ini setelah membuat binding. DISPLAY_NAME: Opsional. Deskripsi binding yang dapat dibaca manusia—misalnya,Example binding. Nama tampilan dapat berisi maksimal 63 karakter.
Jalankan perintah berikut:
Linux, macOS, atau Cloud Shell
gcloud iam policy-bindings create BINDING_ID \ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global \ --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" \ --target-resource=TARGET_RESOURCE \ --display-name=DISPLAY_NAME
Windows (PowerShell)
gcloud iam policy-bindings create BINDING_ID ` --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global ` --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" ` --target-resource=TARGET_RESOURCE ` --display-name=DISPLAY_NAME
Windows (cmd.exe)
gcloud iam policy-bindings create BINDING_ID ^ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global ^ --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" ^ --target-resource=TARGET_RESOURCE ^ --display-name=DISPLAY_NAME
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.
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: Nama unik untuk binding—misalnya,example-binding. DISPLAY_NAME: Opsional. Deskripsi binding yang dapat dibaca manusia—misalnya,Example binding. Nama tampilan dapat berisi maksimal 63 karakter.-
TARGET_RESOURCE: Resource yang ingin Anda ikat dengan UAP. Untuk mengetahui daftar resource yang valid, lihat Resource yang didukung. Anda tidak dapat mengubah nilai ini setelah membuat binding. -
POLICY_PARENT_RESOURCE: Resource tempat UAP dibuat, dalam bentukRESOURCE_TYPE/RESOURCE_ID. Contohnya,organizations/0123456789012. UAP dapat dibuat di project, folder, atau organisasi. ID folder dan ID organisasi harus berupa angka. Project ID dapat berupa numerik atau alfanumerik. -
UAP_ID: ID UAP yang ingin Anda ikat ke resource—misalnya,example-uap. Anda tidak dapat mengubah nilai ini setelah membuat binding.
Metode HTTP dan URL:
POST https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings?policyBindingId=BINDING_ID
Meminta isi JSON:
{
"displayName": "DISPLAY_NAME",
"target": {
"resource": "TARGET_RESOURCE"
},
"policyKind": "ACCESS",
"policy": "POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID"
}
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": "2026-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.