Unified Access Policy (UAP) memungkinkan Anda memberikan dan menolak akses akun utama ke resourceGoogle Cloud . Jika Anda tidak ingin lagi UAP diterapkan ke resource, Anda dapat menghapus binding kebijakan yang mengikat kebijakan ke resource. Jika ingin menghapus kebijakan dari semua resource yang terikat, Anda dapat menghapus kebijakan tersebut.
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 menghapus binding Unified Access Policy
Untuk mendapatkan izin yang Anda perlukan untuk menghapus binding untuk UAP, minta administrator untuk memberi Anda peran IAM berikut:
- Access Policy User (
roles/iam.accessPolicyUser) pada resource yang memiliki UAP. Peran ini mencakup iziniam.accesspolicies.unbind, yang diperlukan untuk menghapus binding. Peran yang mencakup izin
SERVICE.RESOURCE.deletePolicyBinding, denganRESOURCEadalah jenis resource yang terikat dengan UAP 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.
Peran yang diperlukan untuk menghapus Unified Access Policies
Untuk mendapatkan izin yang
diperlukan untuk menghapus UAP,
minta administrator untuk memberi Anda
peran IAM Access Policy Admin (roles/iam.accessPolicyAdmin) di project, folder, atau organisasi yang memiliki
UAP yang ingin Anda hapus.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk menghapus UAP. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk menghapus UAP:
-
iam.accesspolicies.delete -
Hapus 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.
Menghapus Unified Access Policy dari resource
Untuk menghapus UAP dari resource, hapus binding yang mengikat UAP ke resource. Setelah Anda menghapus binding, UAP tidak lagi berlaku untuk resource atau turunan resource. Namun, UAP tidak dihapus dan tidak ada binding lainnya yang terpengaruh.
Anda dapat menghapus binding untuk project, folder, dan organisasi menggunakan konsolGoogle Cloud , gcloud CLI, atau IAM REST API. Untuk menghapus binding 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 hapus.
- Klik ID kebijakan UAP yang ingin Anda hapus.
- Pilih tab Bindings.
- Di tabel Binding, temukan baris yang berisi binding yang ingin Anda hapus.
- Di baris tersebut, klik menu Actions, lalu klik Delete binding.
- Pada dialog Delete binding, klik Delete.
gcloud
Perintah
gcloud iam policy-bindings delete
menghapus binding.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
-
BINDING_ID: ID binding yang ingin Anda hapus—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.
Jalankan perintah berikut:
Linux, macOS, atau Cloud Shell
gcloud iam policy-bindings delete BINDING_ID \ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
Windows (PowerShell)
gcloud iam policy-bindings delete BINDING_ID ` --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
Windows (cmd.exe)
gcloud iam policy-bindings delete BINDING_ID ^ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
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.
Delete request issued for: [example-binding] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374724030-6181fcd1520c5-d21b0a12-b704e1ce] to complete...done. Deleted policyBinding [example-binding].
REST
Metode
policyBindings.delete
menghapus 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: ID binding yang ingin Anda hapus—misalnya,example-binding.
Metode HTTP dan URL:
DELETE https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings/BINDING_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-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-binding",
"verb": "delete",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
Menghapus Unified Access Policy
Sebelum menghapus UAP, identifikasi dan hapus semua binding yang ada yang merujuk ke UAP. Upaya untuk menghapus UAP tanpa menghapus binding yang ada akan menghasilkan error.
Jika ingin menghapus UAP tanpa menghapus binding yang ada, Anda dapat menghapus paksa UAP. Menghapus paksa UAP akan menghapusnya dari semua resource yang terikat dengannya. Setiap binding yang merujuk ke UAP pada akhirnya akan dihapus. Namun, hingga dihapus, binding tersebut masih diperhitungkan dalam batas jumlah binding yang dapat merujuk ke satu resource.
Anda dapat menghapus 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 hapus.
- Klik ID kebijakan UAP yang ingin Anda hapus.
- Klik Delete policy.
- Jika UAP memiliki binding yang ada, pilih Delete this policy and all of its bindings. Jika Anda mencoba menghapus UAP dengan binding yang ada tanpa memilih opsi ini, permintaan akan gagal.
- Pada dialog Delete policy, klik Delete.
gcloud
Perintah
gcloud iam access-policies delete
menghapus UAP dan semua binding terkait.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
-
UAP_ID: ID UAP yang ingin Anda hapus, misalnya,example-policy. -
UAP_PARENT_RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang memiliki UAP yang ingin Anda hapus. Gunakan nilaiproject,folder, atauorganization. -
UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda hapus. Project ID adalah string alfanumerik, sepertimy-project. Folder dan ID organisasi berupa numerik, seperti123456789012. -
FORCE_FLAG: Opsional. Untuk memaksa perintah menghapus kebijakan, meskipun kebijakan tersebut direferensikan dalam binding yang ada, gunakan flag--force. Jika flag ini tidak ditetapkan dan kebijakan direferensikan dalam binding yang ada, perintah akan gagal.
Jalankan perintah berikut:
Linux, macOS, atau Cloud Shell
gcloud iam access-policies delete UAP_ID \ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global \ FORCE_FLAG
Windows (PowerShell)
gcloud iam access-policies delete UAP_ID ` --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global ` FORCE_FLAG
Windows (cmd.exe)
gcloud iam access-policies delete UAP_ID ^ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global ^ FORCE_FLAG
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.
Delete request issued for: [example-policy] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete...done. Deleted accessPolicy [example-policy].
REST
Metode
accessPolicies.delete
menghapus UAP dan semua binding terkait.
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 hapus. Gunakan nilaiprojects,folders, atauorganizations. -
UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda hapus. Project ID adalah string alfanumerik, sepertimy-project. Folder dan ID organisasi berupa numerik, seperti123456789012. -
UAP_ID: ID UAP yang ingin Anda hapus, misalnya,example-policy. -
FORCE_DELETE: Opsional. Untuk memaksa permintaan menghapus kebijakan, meskipun kebijakan tersebut direferensikan dalam binding yang ada, tambahkan parameter kueriforce=true. Jika parameter kueri ini tidak ditetapkan dan kebijakan direferensikan dalam binding yang ada, permintaan akan gagal.
Metode HTTP dan URL:
DELETE https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID?FORCE_DELETE
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-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"verb": "delete",
"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.