Unified Access Policy (UAP) memungkinkan Anda memberikan dan menolak akses akun utama ke resourceGoogle Cloud . Dokumen ini menjelaskan cara mengedit UAP yang ada dan mengubah resource yang diterapkan 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 mendapatkan izin yang
diperlukan untuk mengedit UAP,
minta administrator untuk memberi Anda
peran IAM Access Policy Admin (roles/iam.accessPolicyAdmin) pada
project, folder, atau organisasi yang memiliki UAP
yang ingin Anda edit
.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk mengedit UAP. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk mengedit UAP:
-
iam.accesspolicies.update -
Edit UAP di konsol Google Cloud :
-
iam.accesspolicies.get -
iam.accessPolicies.list
-
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Mengedit Unified Access Policy yang ada
Anda dapat mengedit UAP untuk memperbarui nama tampilan atau aturannya.
Anda dapat mengedit 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 yang memiliki UAP yang ingin Anda edit.
- Klik ID kebijakan UAP yang ingin Anda edit.
-
Untuk menambahkan aturan, klik Tambahkan aturan, lalu tambahkan detail aturan. Untuk menyimpan aturan, klik Tambahkan aturan.
Untuk mempelajari lebih lanjut kolom aturan, lihat Membuat UAP.
- Untuk mengedit kolom lain dari UAP, klik Edit policy.
-
Edit salah satu kolom berikut:
- Policy name: Masukkan nama tampilan baru untuk UAP.
- Aturan: Memperbarui, menambahkan, atau menghapus aturan di UAP.
- Setelah selesai mengedit UAP, klik Update policy.
gcloud
Perintah
gcloud iam access-policies update
memperbarui UAP yang ada.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
-
UAP_ID: ID UAP yang ingin Anda perbarui—misalnya,example-policy. -
UAP_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang memiliki UAP yang ingin Anda update. Gunakan nilaiproject,folder, atauorganization. -
UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda perbarui. Project ID adalah string alfanumerik, sepertimy-project. Folder dan ID organisasi berupa numerik, seperti123456789012. -
FIELD_TO_UPDATE=UPDATED_VALUE: Kolom yang ingin Anda perbarui dan nilai yang diperbarui yang sesuai.Berikut adalah contoh flag yang dapat Anda gunakan untuk memperbarui kolom dalam kebijakan:
-
--display-name=DISPLAY_NAME: Ganti nama tampilan UAP dengan nama yang ditentukan. -
--details-rules=RULES_FILE: Mengganti aturan UAP dengan aturan dalam file yang ditentukan. Setiap aturan dalam file 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.
-
-
-
--add-details-rules=RULES_FILE: Menambahkan aturan dalam file yang ditentukan ke aturan yang ada di UAP. -
--remove-details-rules=RULES_FILE: Menghapus aturan dalam file yang ditentukan dari aturan yang ada di UAP. Hanya aturan yang sama persis dengan salah satu aturan dalam file yang ditentukan yang akan dihapus. -
--clear-details-rules: Menghapus semua aturan dari UAP.
Untuk mengetahui daftar lengkap flag yang dapat Anda gunakan untuk memperbarui UAP, lihat referensi perintah
gcloud iam access-policies update. Beberapa flag bersifat eksklusif. -
FORMAT: Format untuk respons. Gunakanjsonatauyaml.
Jalankan perintah berikut:
Linux, macOS, atau Cloud Shell
gcloud iam access-policies update UAP_ID \ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \ --location=global --FIELD_TO_UPDATE=UPDATED_VALUE \ --format=FORMAT
Windows (PowerShell)
gcloud iam access-policies update UAP_ID ` --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ` --location=global --FIELD_TO_UPDATE=UPDATED_VALUE ` --format=FORMAT
Windows (cmd.exe)
gcloud iam access-policies update UAP_ID ^ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^ --location=global --FIELD_TO_UPDATE=UPDATED_VALUE ^ --format=FORMAT
Respons berisi operasi yang berjalan lama yang mewakili permintaan Anda. Setelah operasi selesai, respons akan mencetak UAP yang diperbarui.
Request issued for: [example-policy]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374208720-6181fae5e2034-2d8a712b-5c92e5b9] to complete...done.
Updated accessPolicy [example-policy].
{
"createTime": "2026-08-31T21:43:39.822441Z",
"details": {
"rules": [
{
"conditions": {
"iam.googleapis.com": {
"expression": "resource.matchTag('environment', 'prod')"
}
},
"description": "Grant non-delete compute permissions to compute admins in prod",
"effect": "ALLOW",
"excludedPrincipals": [
"principal://goog/subject/access-restricted@example.com"
],
"operation": {
"excludedPermissions": [
"*/*.delete"
],
"permissions": [
"role:roles/compute.admin"
]
},
"principals": [
"principalSet://goog/group/compute-admins@example.com"
]
}
]
},
"displayName": "Updated display name",
"etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
"name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
"uid": "puid_0123456789012345678",
"updateTime": "2026-08-31T21:43:39.822441Z"
}
REST
Metode
accessPolicies.patch
memperbarui UAP yang ada.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
-
UAP_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang memiliki UAP yang ingin Anda update. Gunakan nilaiprojects,folders, atauorganizations. -
UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda perbarui. Project ID adalah string alfanumerik, sepertimy-project. Folder dan ID organisasi berupa numerik, seperti123456789012. -
UAP_ID: ID UAP yang ingin Anda perbarui—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:
PATCH https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/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-1715626721931-6185a7953ef76-76f80ee4-19cd1bf7",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-13T18:58:43.721277235Z",
"target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"verb": "update",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
Mengubah resource yang menerapkan kebijakan
Setelah membuat binding untuk UAP, Anda tidak dapat mengubah ID kebijakan atau resource dalam binding. Akibatnya, jika Anda ingin mengubah resource yang diterapkan UAP, Anda harus melakukan salah satu hal berikut:
- Untuk menerapkan UAP ke resource lain, buat binding baru yang mengikat UAP ke resource tersebut.
- Untuk menghapus UAP dari resource, hapus binding yang mengikat UAP ke resource.
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.