Menghapus Unified Access Policies

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

  1. 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 .

  2. Pastikan penagihan diaktifkan untuk project Google Cloud Anda.

  3. 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 izin iam.accesspolicies.unbind, yang diperlukan untuk menghapus binding.
  • Peran yang mencakup izin SERVICE.RESOURCE.deletePolicyBinding, dengan RESOURCE adalah jenis resource yang terikat dengan UAP dan SERVICE adalah 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

  1. Di konsol Google Cloud , buka halaman Unified Access Policies.

    Buka Unified Access Policies
  2. Pilih project, folder, atau organisasi yang memiliki UAP yang ingin Anda hapus.
  3. Klik ID kebijakan UAP yang ingin Anda hapus.
  4. Pilih tab Bindings.
  5. Di tabel Binding, temukan baris yang berisi binding yang ingin Anda hapus.
  6. Di baris tersebut, klik menu Actions, lalu klik Delete binding.
  7. 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 nilai project, folder, atau organization.

    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, seperti my-project. ID folder dan ID organisasi berupa numerik, seperti 123456789012.

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 nilai projects, folders, atau organizations.

    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, seperti my-project. ID folder dan ID organisasi berupa numerik, seperti 123456789012.
  • 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

  1. Di konsol Google Cloud , buka halaman Unified Access Policies.

    Buka Unified Access Policies
  2. Pilih project, folder, atau organisasi yang memiliki UAP yang ingin Anda hapus.
  3. Klik ID kebijakan UAP yang ingin Anda hapus.
  4. Klik Delete policy.
  5. 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.
  6. 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 nilai project, folder, atau organization.
  • UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda hapus. Project ID adalah string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
  • 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 nilai projects, folders, atau organizations.
  • UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda hapus. Project ID adalah string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
  • 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 kueri force=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.

Langkah berikutnya