Dokumen ini menjelaskan cara menggunakan tag untuk menerapkan kebijakan Identity and Access Management (IAM) secara bersyarat pada cluster Cloud Workstations.
Tag adalah pasangan nilai kunci yang dapat Anda lampirkan langsung ke cluster Cloud Workstations. Cluster Cloud Workstations juga dapat
mewarisi tag dari resource
Google Cloud lainnya. Anda dapat menerapkan kebijakan secara bersyarat berdasarkan
apakah resource memiliki tag tertentu atau tidak. Misalnya, Anda dapat memberikan peran Cloud Workstations Creator secara bersyarat ke akun utama di cluster Cloud Workstations mana pun dengan tag environment:dev
.
Untuk mengetahui informasi selengkapnya tentang penggunaan tag di seluruh hierarki resource Google Cloud, lihat Ringkasan tag.
Sebelum memulai
Anda perlu memberikan peran IAM yang memberi pengguna izin yang diperlukan untuk melakukan setiap tugas dalam dokumen ini. Anda juga perlu membuat kunci dan nilai tag untuk dilampirkan ke resource.
Peran yang diperlukan
Peran berikut memberikan izin yang diperlukan untuk memberi tag pada resource Cloud Workstations:
Melampirkan tag ke cluster Cloud Workstations
Untuk mendapatkan izin yang diperlukan untuk melampirkan tag ke cluster Cloud Workstations, minta administrator Anda untuk memberi Anda peran IAM berikut:
-
Untuk membuat cluster Cloud Workstations:
Admin Cloud Workstations (
roles/workstations.admin
) di project Anda -
Untuk membuat tag:
Administrator Tag (
roles/resourcemanager.tagAdmin
) di project Anda -
Untuk mengelola tag:
Pengguna Tag (
roles/resourcemanager.tagUser
) pada nilai tag dan cluster Cloud Workstations
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk melampirkan tag ke cluster Cloud Workstations. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk melampirkan tag ke cluster Cloud Workstations:
-
workstations.workstationClusters.createTagBinding
di cluster -
resourcemanager.tagValueBindings.create
pada nilai tag -
workstations.workstationClusters.create
di cluster untuk melampirkan tag saat membuat cluster -
workstations.workstationClusters.update
pada cluster untuk melampirkan tag saat memperbarui cluster
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Menghapus tag dari cluster Cloud Workstations
Untuk mendapatkan izin yang Anda perlukan untuk menghapus tag dari cluster Cloud Workstations, minta administrator Anda untuk memberi Anda peran IAM berikut:
-
Untuk menghapus tag dari cluster Cloud Workstations:
Admin Cloud Workstations (
roles/workstations.admin
) di project Anda -
Untuk mengelola tag:
Pengguna Tag (
roles/resourcemanager.tagUser
) pada nilai tag dan cluster Cloud Workstations -
Untuk menghapus tag:
Administrator Tag (
roles/resourcemanager.tagAdmin
) di project Anda
Peran bawaan ini berisi izin yang diperlukan untuk menghapus tag dari cluster Cloud Workstations. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk menghapus tag dari cluster Cloud Workstations:
-
workstations.workstationClusters.deleteTagBinding
di cluster -
resourcemanager.tagValueBindings.delete
pada nilai tag -
workstations.workstationClusters.update
pada cluster untuk menghapus tag saat memperbarui cluster
Mencantumkan tag yang dilampirkan ke cluster Cloud Workstations
Untuk mendapatkan izin yang diperlukan untuk mencantumkan tag yang terlampir pada cluster Cloud Workstations, minta administrator Anda untuk memberi Anda peran IAM berikut:
-
Untuk mencantumkan tag yang dilampirkan ke cluster Cloud Workstations:
Admin Cloud Workstations (
roles/workstations.admin
) di project Anda -
Untuk mencantumkan tag:
Penampil Tag (
roles/resourcemanager.tagViewer
) pada nilai tag dan cluster Cloud Workstations
Peran bawaan ini berisi izin yang diperlukan untuk mencantumkan tag yang dilampirkan ke cluster Cloud Workstations. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk mencantumkan tag yang dilampirkan ke cluster Cloud Workstations:
-
resourcemanager.tagKeys.list
pada induk kunci tag -
resourcemanager.tagKeys.get
pada kunci tag -
resourcemanager.tagValues.list
pada induk nilai tag -
resourcemanager.tagValues.get
pada nilai tag -
workstations.workstationClusters.listTagBindings
di cluster -
workstations.workstationClusters.listEffectiveTags
di cluster
Membuat kunci dan nilai tag
Sebelum dapat mengaitkan tag, Anda harus membuat tag dan mengonfigurasi nilainya. Untuk membuat kunci tag dan nilai tag, lihat Membuat tag dan Menambahkan nilai tag.
Memberi tag pada cluster Cloud Workstations
Bagian berikut menjelaskan cara melampirkan tag ke cluster Cloud Workstations baru dan yang sudah ada, mencantumkan tag yang dilampirkan ke cluster Cloud Workstations, dan melepaskan tag dari cluster Cloud Workstations.
Melampirkan tag saat Anda membuat cluster Cloud Workstations baru
Setelah membuat tag, Anda dapat melampirkannya ke cluster Cloud Workstations baru. Untuk setiap kunci tag, Anda dapat melampirkan satu nilai tag ke cluster Cloud Workstations. Untuk setiap cluster Cloud Workstations, Anda dapat melampirkan maksimal 50 tag.
Konsol
Di konsol Google Cloud , buka halaman Cloud Workstations.
Klik bagian Cluster management.
Klik Create.
Masukkan informasi untuk cluster Cloud Workstations baru Anda. Untuk mengetahui detail selengkapnya, lihat Membuat cluster workstation.
Di bagian Tags, pilih tag yang ingin Anda tambahkan ke cluster Cloud Workstations baru.
Klik Buat.
gcloud
Gunakan perintah gcloud workstations clusters create
dengan flag --tags
:
gcloud workstations clusters create WORKSTATIONS_CLUSTER_NAME \ --region=LOCATION \ --tags=TAG \ --project=WORKSTATIONS_PROJECT_ID
Ganti kode berikut:
WORKSTATIONS_CLUSTER_NAME
: nama cluster Cloud Workstations Anda.LOCATION
: region untuk cluster Anda.TAG
: tag yang Anda lampirkan ke cluster Cloud Workstations baru. Beberapa tag dipisahkan dengan koma. Contoh,556741164180/env:prod,myProject/department:sales
. Setiap tag harus memiliki nama kunci dengan namespace dan nama pendek nilai.WORKSTATIONS_PROJECT_ID
: ID project workstation Anda.
API
Panggil
metode workstationClusters.create
.
Sertakan tag di kolom tags
dari WorkstationCluster
.
Melampirkan tag ke cluster Cloud Workstations yang ada
Setelah membuat tag, Anda dapat melampirkannya ke cluster Cloud Workstations yang ada. Untuk setiap kunci tag, Anda dapat melampirkan satu nilai tag ke cluster Cloud Workstations. Untuk setiap cluster Cloud Workstations, Anda dapat melampirkan maksimal 50 tag.
Konsol
Di konsol Google Cloud , buka halaman Cloud Workstations.
Klik bagian Cluster management.
Klik cluster Cloud Workstations yang ingin Anda beri tag.
Klik Edit.
Di bagian Tags, pilih tag yang ingin Anda tambahkan ke cluster Cloud Workstations.
Klik Simpan.
gcloud
Untuk memasang tag ke cluster Cloud Workstations menggunakan command line, buat resource binding tag menggunakan
perintah gcloud resource-manager tags bindings create
:
gcloud resource-manager tags bindings create \ --tag-value=TAGVALUE_NAME \ --parent=RESOURCE_ID \ --location=LOCATION
Ganti kode berikut:
TAGVALUE_NAME
: ID permanen atau nama dengan namespace dari nilai tag yang akan dipasang, sepertitagValues/4567890123
atau1234567/my_tag_key/my_tag_value
.RESOURCE_ID
: ID lengkap cluster Cloud Workstations, termasuk nama domain API (//workstations.googleapis.com/
) untuk mengidentifikasi jenis resource. Misalnya,//workstations.googleapis.com/projects/my_project/locations/us-central1/workstationClusters/my_cluster
LOCATION
: region cluster Cloud Workstations.
API
Panggil
metode workstationClusters.patch
.
Sertakan tag di kolom tags
dari WorkstationCluster
.
Mencantumkan tag yang dilampirkan ke cluster Cloud Workstations
Anda dapat mencantumkan tag yang dilampirkan langsung ke cluster Cloud Workstations. Proses ini tidak mencantumkan tag yang diwarisi dari resource induk.
Konsol
Di konsol Google Cloud , buka halaman Cloud Workstations.
Klik bagian Cluster management.
Klik cluster Cloud Workstations yang ingin Anda cantumkan tag-nya.
Tag dapat dilihat di bagian Tag.
gcloud
Untuk mendapatkan daftar binding tag yang dipasang ke resource, gunakan perintah gcloud resource-manager tags bindings list
:
gcloud resource-manager tags bindings list \ --parent=RESOURCE_ID \ --location=LOCATION
Ganti kode berikut:
RESOURCE_ID
: ID lengkap cluster Cloud Workstations, termasuk nama domain API (//workstations.googleapis.com/
) untuk mengidentifikasi jenis resource. Contohnya,//workstations.googleapis.com/projects/my_project/locations/us-central1/workstationClusters/my_cluster
.LOCATION
: region cluster Cloud Workstations.
API
Panggil
metode v3.tagBindings.list
.
Sertakan cluster Cloud Workstations di kolom induk. Contohnya,
//cloudresourcemanager.googleapis.com/projects/my-project/regions/us-central1/workstationClusters/my-cluster
.
Melepaskan tag dari cluster Cloud Workstations
Anda dapat menghapus asosiasi tag dari cluster Cloud Workstations dengan menghapus binding tag. Jika perlu menghapus tag, Anda harus melakukan langkah-langkah berikut untuk melepaskan tag dari cluster Cloud Workstations terlebih dahulu.
Konsol
Di konsol Google Cloud , buka halaman Cloud Workstations.
Klik bagian Cluster management.
Klik cluster Cloud Workstations yang ingin Anda lepaskan tag-nya.
Klik Edit.
Di bagian Tags, hapus tag yang ingin Anda lepaskan dari cluster Cloud Workstations.
Klik Simpan.
gcloud
Untuk menghapus asosiasi tag dari cluster Cloud Workstations menggunakan command line, hapus binding tag menggunakan
perintah gcloud resource-manager tags bindings delete
:
gcloud resource-manager tags bindings delete \ --tag-value=TAGVALUE_NAME \ --parent=RESOURCE_ID \ --location=LOCATION
Ganti kode berikut:
TAGVALUE_NAME
: ID permanen atau nama dengan namespace dari nilai tag yang akan dipasang, sepertitagValues/4567890123
atau1234567/my_tag_key/my_tag_value
.RESOURCE_ID
: ID lengkap cluster Cloud Workstations, termasuk nama domain API (//workstations.googleapis.com/
) untuk mengidentifikasi jenis resource. Misalnya,//workstations.googleapis.com/projects/my_project/locations/us-central1/workstationClusters/my_cluster
LOCATION
: region cluster Cloud Workstations.
API
Panggil
metode workstationClusters.patch
.
Hapus tag di kolom tags
dari WorkstationCluster
.
Langkah berikutnya
- Untuk ringkasan tag di Google Cloud, lihat Ringkasan tag.
- Untuk mengetahui informasi selengkapnya tentang cara menggunakan tag, lihat Membuat dan mengelola tag.
- Untuk mengetahui informasi tentang cara mengontrol akses ke resource Cloud Workstations dengan IAM Conditions, lihat Kontrol akses dengan IAM Conditions.