Menandai sumber daya AWS Cloud Map Anda

Untuk membantu Anda mengelola sumber daya AWS Cloud Map, Anda dapat menugaskan metadata Anda sendiri ke setiap sumber daya dalam bentuk tanda. Topik ini menjelaskan tentang tanda dan menunjukkan kepada Anda cara membuatnya.

Dasar-dasar tanda

Tanda adalah sebuah label yang Anda tetapkan ke sebuah sumber daya AWS. Setiap tanda terdiri atas sebuah kunci dan sebuah nilai opsional, yang keduanya Anda tentukan.

Tanda memungkinkan Anda untuk mengategorikan sumber daya AWS Anda dengan, misalnya, berdasarkan tujuan, pemilik, atau lingkungan. Saat Anda memiliki banyak sumber daya dengan jenis yang sama, Anda dapat dengan segera mengidentifikasi sumber daya yang spesifik berdasarkan tanda yang telah Anda tetapkan pada sumber daya. Misalnya, Anda dapat menentukan satu set tanda untuk layanan AWS Cloud Map untuk membantu Anda melacak setiap pemilik dan tingkat tumpukan layanan. Kami menyarankan agar Anda merancang serangkaian kunci tanda yang konsisten untuk setiap jenis sumber daya.

Selain itu, tanda tidak dapat menetapkan secara otomatis ke sumber daya Anda. Setelah Anda menambahkan sebuah tanda, Anda dapat mengedit kunci serta nilai tanda atau menghilangkan tanda dari sumber daya kapanpun yang Anda mau. Jika Anda menghapus sebuah sumber daya, tanda apapun untuk sumber daya tersebut juga dihapus.

Tanda tidak memiliki makna semantik pada AWS Cloud Map dan diterjemahkan sebagai serangkaian karakter saja. Anda dapat mengatur nilai tanda menjadi sebuah string kosong, tetapi Anda tidak dapat mengatur nilai tanda menjadi nol. Jika Anda menambahkan tanda yang memiliki kunci yang sama dengan tanda yang ada pada sumber daya tersebut, nilai yang baru akan menimpa nilai yang lama.

Anda dapat bekerja dengan tanda menggunakan AWS Management Console, AWS CLI, dan API AWS Cloud Map.

Jika Anda menggunakan AWS Identity and Access Management (IAM), Anda dapat mengendalikan pengguna yang mana di akun AWS Anda yang memiliki izin untuk membuat, mengedit, atau menghapus tanda.

Menandai sumber daya Anda

Anda dapat menandai namespace AWS Cloud Map dan layanan yang baru atau yang sudah ada.

Jika Anda menggunakan konsol AWS Cloud Map, Anda dapat menerapkan tanda ke sumber daya baru ketika dibuat atau sumber daya yang ada dengan menggunakan tab Tanda pada halaman sumber daya yang relevan kapan saja.

Jika Anda menggunakan API AWS Cloud Map, AWS CLI, atau AWS SDK, Anda dapat menerapkan tanda ke sumber daya baru menggunakan tags parameter pada tindakan API yang relevan atau pada sumber daya yang ada menggunakan TagResource sebagai tindakan API. Untuk informasi lebih lanjut, lihat TagResource.

Selain itu, beberapa tindakan pembuatan sumber daya memungkinkan Anda menentukan tanda untuk sumber daya saat sumber daya diciptakan. Jika tanda tidak dapat diterapkan selama pembuatan sumber daya, proses pembuatan sumber daya akan gagal. Hal ini memastikan bahwa sumber daya yang ingin Anda tandai pada saat pembuatan dapat dibuat dengan tanda yang ditentukan atau justru tidak dibuat sama sekali. Jika Anda menandai sumber daya pada saat pembuatan, Anda tidak perlu menjalankan skrip penandaan khusus setelah pembuatan sumber daya.

Tabel berikut menjelaskan sumber daya AWS Cloud Map yang dapat ditandai, dan sumber daya yang dapat ditandai saat dibuat.

Dukungan penandaan untuk sumber daya AWS Cloud Map
Sumber daya	Mendukung tanda	Penyebaran tanda Support	Support pemberian tanda saat penciptaan (API AWS Cloud Map, AWS CLI, SDK AWS)
namespace AWS Cloud Map	Ya	Tidak. Tag namespace tidak menyebarkan ke sumber daya lain yang terkait dengan namespace.	Ya
Layanan AWS Cloud Map	Ya	Tidak. Tag layanan tidak menyebar ke sumber daya lain yang terkait dengan layanan.	Ya

Batasan tanda

Batasan dasar berikut berlaku untuk tanda:

• Jumlah maksimum tanda per sumber daya – 50

• Untuk setiap sumber daya, setiap kunci tanda harus unik, dan setiap kunci tanda hanya dapat memiliki satu nilai.

• Panjang kunci maksimum – 128 karakter Unicode dalam UTF-8

• Panjang nilai maksimum – 256 karakter Unicode dalam UTF-8

• Jika skema penandaan Anda digunakan di beberapa layanan AWS dan sumber daya, harap perhatikan bahwa layanan lain mungkin memiliki pembatasan pada karakter yang diizinkan. Karakter yang diperbolehkan adalah: huruf, spasi, dan angka yang dapat mewakili dalam UTF-8, serta karakter berikut: + - = . _ : / @.

• Kunci dan nilai tanda sensitif huruf besar dan kecil.

• Jangan gunakan aws:, AWS:, atau kombinasi huruf besar atau huruf kecil dari itu semua sebagai prefiks untuk kunci atau nilai karena itu semua disimpan untuk penggunaan AWS. Anda tidak dapat menyunting atau menghapus kunci atau nilai tanda dengan prefiks ini. Tag dengan awalan ini tidak dihitung terhadap tag Anda per batas sumber daya.

Cara menggunakan tanda dengan menggunakan CLI atau API

Gunakan perintah AWS CLI atau operasi API AWS Cloud Map berikut untuk menambahkan, memperbarui, membuat daftar, dan menghapus tanda sumber daya Anda.

Dukungan penandaan untuk sumber daya AWS Cloud Map
Tugas	Tindakan API	AWS CLI	AWS Tools for Windows PowerShell
Penambahan atau penimpaan satu tanda atau lebih.	TagResource	tag-resource	Add-SDRourceTag
Penghapusan satu tanda atau lebih.	UntagResource	untag-resource	Menghapuskan-SDRourceTag
Daftar tanda untuk sumber daya	ListTagsForResource	list-tags-for-resource	Dapatkan-SDRourceTag

Contoh-contoh berikut menunjukkan cara menambahkan atau menghilangkan tanda sumber daya menggunakan AWS CLI.

Contoh 1: Menandai sumber daya yang ada

Perintah berikut ini menandai sumber daya yang sudah ada.

aws servicediscovery tag-resource --resource-arn resource_ARN --tags team=devs

Contoh 2: Untag sumber daya yang ada

Perintah berikut ini menghapus tanda dari sumber daya yang sudah ada.

aws servicediscovery untag-resource --resource-arn resource_ARN --tag-keys tag_key

Contoh 3: Membuat daftar tanda untuk sumber daya

Perintah berikut akan mencantumkan tanda terkait dengan sumber daya yang sudah ada.

aws servicediscovery list-tags-for-resource --resource-arn resource_ARN

Beberapa tindakan pembuatan sumber daya memungkinkan Anda untuk menentukan tanda saat membuat sumber daya. Tindakan berikut mendukung penandaan saat pembuatan.

Tugas	Tindakan API	AWS CLI	AWS Tools for Windows PowerShell
Buat namespace HTTP	CreateHttpNamespace	membuat-http-namespace	SDHttpNamespace-Baru
Membuat namespace pribadi berdasarkan DNS	CreatePrivateDnsNamespace	buat-pribadi-dns-namespace	Barw-SDPrivatedNsNamespace
Membuat namespace publik berdasarkan DNS	CreatePublicDnsNamespace	buat-publik-dns-namespace	SDPublikDnsNamespace-Baru
Membuat layanan	CreateService	buat-layanan	SDService-Baru