Mengedit Unified Access Policies

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

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

  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 edit.
  3. Klik ID kebijakan UAP yang ingin Anda edit.
  4. 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.

  5. Untuk mengedit kolom lain dari UAP, klik Edit policy.
  6. Edit salah satu kolom berikut:

    • Policy name: Masukkan nama tampilan baru untuk UAP.
    • Aturan: Memperbarui, menambahkan, atau menghapus aturan di UAP.
  7. 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 nilai project, folder, atau organization.
  • UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda perbarui. Project ID adalah string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
  • 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 adalah ALLOW dan DENY:

        • 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 bernilai true, aturan akan berlaku untuk upaya akses. Jika bernilai false, 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. Gunakan json atau yaml.

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 nilai projects, folders, atau organizations.
  • UAP_PARENT_RESOURCE_ID: ID project, folder, atau organisasi yang memiliki UAP yang ingin Anda perbarui. Project ID adalah string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
  • 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 adalah ALLOW dan DENY:

      • 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 bernilai true, aturan akan berlaku untuk upaya akses. Jika bernilai false, 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.

Langkah berikutnya