Membuat dan mengelola tag

Anda dapat melampirkan tag ke resource Cloud Router berikut:

  • Router

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 mengetahui informasi selengkapnya tentang 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 melampirkan tag ke resource Cloud Router, Anda memerlukan peran Admin Jaringan Compute (roles/compute.networkAdmin).

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 selama pembuatan resource

Anda dapat menambahkan tag pada saat membuat secret regional. Dengan menambahkan tag, Anda dapat langsung memberikan metadata penting untuk secret regional dan juga membantu organisasi yang lebih baik, pelacakan biaya, dan penerapan kebijakan otomatis.

gcloud

Untuk melampirkan tag ke resource selama pembuatan resource, tambahkan flag --resource-manager-tags dengan perintah create yang sesuai—misalnya, untuk melampirkan tag ke router, gunakan perintah berikut:

gcloud compute routers create ROUTER_NAME \
    --resource-manager-tags=tagKeys/TAGKEY_ID=tagValues/TAGVALUE_ID

Ganti kode berikut:

  • ROUTER_NAME: nama router Anda
  • TAGKEY_ID: ID numerik nomor kunci tag
  • TAGVALUE_ID: ID numerik permanen dari nilai tag yang dilampirkan—misalnya: 4567890123

Tentukan beberapa tag dengan memisahkan tag dengan koma, misalnya, TAGKEY1=TAGVALUE1,TAGKEY2=TAGVALUE2

API

Kirim permintaan POST ke URL berikut:

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/{region}/routers

Berikan JSON berikut dalam isi permintaan:

      
    {
      "name": "ROUTER_NAME",
      "params": {
        "resourceManagerTags": {
          "tagKeys/TAGKEY_ID": "tagValues/TAGVALUE_ID",
        },
      }
      // Other fields omitted
    }

Ganti kode berikut:

  • ROUTER_NAME: nama router Anda
  • TAGKEY_ID: ID numerik nomor kunci tag
  • TAGVALUE_ID: ID numerik permanen dari nilai tag yang dilampirkan—misalnya: 4567890123

Menambahkan tag ke resource yang ada

Untuk menambahkan tag ke resource Cloud Router yang ada, ikuti langkah-langkah berikut:

Konsol

  1. Buka halaman Cloud Router di Google Cloud konsol.

    2. Buka Cloud Router

  2. Pilih resource Cloud Router yang ingin Anda lampirkan tag.
  3. Klik Tag.
  4. Jika organisasi Anda tidak muncul di panel Tag, klik Pilih cakupan. Pilih organisasi Anda dan klik Buka.
  5. Klik Tambahkan tag.
  6. Pilih kunci untuk tag yang ingin Anda lampirkan dari daftar. Anda dapat filter daftar dengan mengetikkan kata kunci.
  7. Pilih nilai untuk tag yang ingin dilampirkan dari daftar. Anda dapat memfilter daftar dengan mengetikkan kata kunci.
  8. Klik Simpan.
  9. Dalam dialog Konfirmasi, klik Konfirmasi untuk melampirkan tag.

    10. Notifikasi mengonfirmasi bahwa tag Anda telah diperbarui.

gcloud

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

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

Ganti kode berikut:

  • TAGVALUE_NAME: ID permanen atau nama namespace dari nilai tag yang Anda lampirkan ke resource—misalnya, tagValues/567890123456.
  • RESOURCE_ID: ID lengkap resource, termasuk nama domain API untuk mengidentifikasi jenis resource (//compute.googleapis.com/). Anda harus menggunakan ID numerik untuk resource, bukan namanya. Misalnya, ID resource router di projects/7890123456, adalah sebagai berikut: //compute.googleapis.com/projects/7890123456/regions/REGION/routers/{resource-id}
  • LOCATION: lokasi resource Anda. Jika Anda melampirkan tag ke resource global, seperti folder atau project, hilangkan flag ini. Jika melampirkan tag ke resource regional atau zona, Anda harus menentukan lokasinya—misalnya: us-central1 (region) atau us-central1-a (zona).

Mencantumkan tag yang dilampirkan ke resource

Anda dapat melihat daftar binding tag yang langsung dilampirkan ke atau diwarisi oleh resource Cloud Router.

Konsol

  1. Buka halaman Cloud Router di Google Cloud konsol.

    2. Buka Cloud Router

  2. Pilih resource untuk melihat detailnya. Tag ditampilkan di baris Tag.

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 \
          --location=LOCATION

Ganti kode berikut:

  • RESOURCE_ID: ID lengkap resource, termasuk nama domain API untuk mengidentifikasi jenis resource (//compute.googleapis.com/). Anda harus menggunakan ID numerik untuk resource, bukan namanya. Misalnya, ID resource router di projects/7890123456, adalah sebagai berikut: //compute.googleapis.com/projects/7890123456/regions/REGION/routers/{resource-id}
  • LOCATION: lokasi resource Anda. Jika Anda melihat tag yang dilampirkan ke resource global, seperti folder atau project, hilangkan flag ini. Jika melihat tag yang dilampirkan ke resource regional atau zona, Anda harus menentukan lokasinya—misalnya: us-central1 (region) atau us-central1-a (zona).

Anda akan mendapatkan respons seperti berikut:

name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
          tagValue: tagValues/567890123456
          resource: 
//compute.googleapis.com/projects/7890123456/regions/REGION/routers/{resource-id}

Melepas tag dari resource

Anda dapat melepas tag yang telah langsung dilampirkan ke resource Cloud Router. Tag yang diwariskan dapat diganti dengan melampirkan tag dengan kunci yang sama dan nilai yang berbeda, tetapi tag tersebut tidak dapat dilepaskan.

Konsol

  1. Buka halaman Cloud Router di Google Cloud konsol.

    2. Buka Cloud Router

  2. Pilih resource Cloud Router tempat Anda ingin menghapus a tag.
  3. Klik Tag.
  4. Di panel Tag, di samping tag yang ingin dilepas, klik Hapus item.
  5. Klik Simpan.
  6. Dalam dialog Konfirmasi, klik Konfirmasi untuk melepas tag.

Notifikasi mengonfirmasi bahwa tag Anda telah diperbarui.

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 \
          --location=LOCATION

Ganti kode berikut:

  • TAGVALUE_NAME: ID permanen atau nama namespace dari nilai tag yang dilampirkan—misalnya, tagValues/567890123456.
  • RESOURCE_ID: ID lengkap resource, termasuk nama domain API untuk mengidentifikasi jenis resource (//compute.googleapis.com/). Anda harus menggunakan ID numerik untuk resource, bukan namanya. Misalnya, ID resource router di projects/7890123456, adalah sebagai berikut: //compute.googleapis.com/projects/7890123456/regions/REGION/routers/{resource-id}
  • LOCATION: lokasi resource Anda. Jika Anda melampirkan tag ke resource global, seperti folder atau project, hilangkan flag ini. Jika melampirkan tag ke resource regional atau zona, Anda harus menentukan lokasinya—misalnya: us-central1 (region) atau us-central1-a (zona).

Menghapus kunci dan nilai tag

Saat menghapus kunci tag atau definisi nilai, pastikan tag tersebut dilepaskan dari resource Cloud Router. 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