Membuat dan mengelola tag untuk peran khusus

Panduan ini menjelaskan cara membuat dan mengelola tag untuk peran khusus.

Tentang tag

Tag adalah pasangan nilai kunci yang dapat dilampirkan ke resource dalam Google Cloud. Anda dapat menggunakan tag untuk mengizinkan atau menolak kebijakan secara bersyarat berdasarkan apakah resource memiliki tag tertentu. Misalnya, Anda dapat memberikan peran Identity and Access Management (IAM) secara bersyarat berdasarkan apakah resource memiliki tag tertentu atau tidak. Untuk informasi selengkapnya mengenai tag, lihat Ringkasan tag.

Tag dilampirkan ke resource dengan membuat resource binding tag yang menautkan nilai ke resource Google Cloud .

Izin yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengelola tag, minta administrator untuk memberi Anda peran IAM berikut:

  • Tag Viewer (roles/resourcemanager.tagViewer) pada resource tempat tag tersebut dilampirkan
  • Melihat dan mengelola tag di tingkat organisasi: Organization Viewer (roles/resourcemanager.organizationViewer) di organisasi
  • Membuat, memperbarui, dan menghapus definisi tag: Tag Administrator (roles/resourcemanager.tagAdmin) pada resource yang tag-nya Anda buat, perbarui, atau hapus
  • Melampirkan dan menghapus tag dari resource: Tag User (roles/resourcemanager.tagUser) pada nilai tag dan resource tempat Anda melampirkan atau menghapus nilai tag-nya

Untuk informasi selengkapnya mengenai pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Untuk mendapatkan izin yang diperlukan untuk melampirkan tag ke peran kustom, minta administrator untuk memberi Anda peran IAM Role Administrator (roles/iam.roleAdmin) di project atau organisasi tempat peran berada. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat kunci dan nilai tag

Sebelum dapat melampirkan tag, Anda harus membuat tag dan mengonfigurasi nilainya. Untuk membuat kunci dan nilai tag, lihat Membuat tag dan Menambahkan nilai tag.

Menambahkan tag ke resource yang ada

Untuk menambahkan tag ke peran kustom yang ada, ikuti langkah-langkah berikut:

gcloud

Untuk melampirkan tag ke peran kustom, Anda harus membuat resource binding tag menggunakan perintah gcloud resource-manager tags bindings create:

      gcloud resource-manager tags bindings create \
          --tag-value=TAGVALUE_NAME \
          --parent=RESOURCE_ID

Ganti kode berikut:

  • TAGVALUE_NAME: ID permanen atau nama namespace dari nilai tag yang dilampirkan—misalnya, tagValues/567890123456.
  • RESOURCE_ID: nama peran lengkap, termasuk awalan projects atau organizations dan nama domain API (//iam.googleapis.com/). Misalnya, ID resource peran khusus tingkat project example-role dalam project example-project adalah //iam.googleapis.com/projects/example-project/roles/example-role.

Mencantumkan tag yang dilampirkan ke resource

Anda dapat melihat daftar binding tag yang langsung dilampirkan ke atau diwarisi oleh peran kustom.

gcloud

Untuk mendapatkan daftar binding tag yang dilampirkan ke resource, gunakan perintah gcloud resource-manager tags bindings list:

      gcloud resource-manager tags bindings list \
          --parent=RESOURCE_ID

Ganti kode berikut:

  • RESOURCE_ID: nama peran lengkap, termasuk awalan projects atau organizations dan nama domain API (//iam.googleapis.com/). Misalnya, ID resource peran khusus tingkat project example-role dalam project example-project adalah //iam.googleapis.com/projects/example-project/roles/example-role.

Anda akan mendapatkan respons seperti berikut:

name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
          tagValue: tagValues/567890123456
          resource: //iam.googleapis.com/projects/example-project/roles/example-role

Melepas tag dari resource

Anda dapat melepaskan tag yang telah dikaitkan secara langsung ke peran khusus. Tag yang diwariskan dapat diganti dengan melampirkan tag dengan kunci yang sama dan nilai yang berbeda, tetapi tag tersebut tidak dapat dilepaskan.

gcloud

Untuk menghapus binding tag, gunakan perintah gcloud resource-manager tags bindings delete:

      gcloud resource-manager tags bindings delete \
          --tag-value=TAGVALUE_NAME \
          --parent=RESOURCE_ID

Ganti kode berikut:

  • TAGVALUE_NAME: ID permanen atau nama namespace dari nilai tag yang dilampirkan—misalnya, tagValues/567890123456.
  • RESOURCE_ID: nama peran lengkap, termasuk awalan projects atau organizations dan nama domain API (//iam.googleapis.com/). Misalnya, ID resource peran khusus tingkat project example-role dalam project example-project adalah //iam.googleapis.com/projects/example-project/roles/example-role.

Menghapus kunci dan nilai tag

Saat menghapus kunci tag atau definisi nilai, pastikan tag tersebut dilepaskan dari peran kustom. Anda harus menghapus lampiran tag yang ada, yang disebut binding tag, sebelum menghapus definisi tag itu sendiri. Untuk menghapus kunci tag dan nilai tag, lihat Menghapus tag.

Kondisi dan tag Identity and Access Management

Anda dapat menggunakan tag dan kondisi IAM untuk memberikan binding peran secara bersyarat kepada pengguna dalam hierarki Anda. Mengubah atau menghapus tag yang dilampirkan ke resource dapat menghapus akses pengguna ke resource tersebut jika kebijakan IAM dengan binding peran bersyarat telah diterapkan. Untuk informasi selengkapnya, lihat kondisi dan tag Identity and Access Management.

Langkah berikutnya