Menandai Sumber Daya Amazon EMR di EKS Anda

Untuk membantu Anda mengelola Amazon EMR di EKS, Anda dapat menetapkan metadata Anda sendiri ke setiap sumber daya menggunakan tanda. Topik ini memberikan gambaran umum dari fungsi tanda dan menunjukkan kepada Anda cara membuat tanda.

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 dengan atribut seperti tujuan, pemilik, atau lingkungan. Saat Anda memiliki banyak sumber daya dengan jenis yang sama, Anda dapat dengan cepat mengidentifikasi sumber daya tertentu berdasarkan tanda yang telah Anda tetapkan. Misalnya, Anda dapat menentukan serangkaian tanda untuk Amazon EMR Anda pada klaster EKS untuk membantu Anda melacak setiap pemilik dan tingkat tumpukan klaster. Kami menyarankan agar Anda merancang serangkaian konsisten kunci tanda untuk setiap jenis sumber daya. Kemudian Anda dapat mencari dan memfilter sumber daya berdasarkan tanda yang Anda tambahkan.

Tanda tidak secara otomatis ditetapkan 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, tag apa pun untuk sumber daya tersebut juga dihapus.

Tanda tidak memiliki makna semantik pada Amazon EMR di EKS dan diterjemahkan sebagai serangkaian karakter saja.

Nilai tanda bisa berupa string kosong, tapi tidak null. Kunci tanda tidak bisa berupa string kosong. Jika Anda menambahkan tanda yang memiliki kunci yang sama dengan tanda yang ada pada sumber daya tersebut, nilai yang baru akan menimpa nilai sebelumnya.

Jika Anda menggunakan AWS Identity and Access Management (IAM), Anda dapat mengontrol pengguna mana dalam akun AWS Anda yang memiliki izin untuk mengelola tanda.

Untuk contoh kebijakan kontrol akses berbasis tanda, lihat Kebijakan untuk kendali akses berbasis tanda.

Beri tanda pada sumber daya Anda

Anda dapat menandai klaster virtual dan tugas berjalan baru atau yang sudah ada yang berada dalam status aktif. Status aktif untuk tugas berjalan meliputi: PENDING, SUBMITTED, RUNNING, dan CANCEL_PENDING. Status aktif untuk klaster virtual meliputi: RUNNING, TERMINATING dan ARRESTED. Untuk informasi lebih lanjut, lihat Status tugas berjalan dan Status klaster virtual.

Ketika klaster virtual dihentikan, tanda dibersihkan dan tidak lagi dapat diakses.

Jika Anda menggunakan API Amazon EMR di EKS, AWS CLI, atau SDK AWS, Anda dapat memasang tanda ke sumber daya baru menggunakan parameter tanda pada tindakan API yang relevan. Anda dapat memasang tanda ke sumber daya yang ada menggunakan tindakan API TagResource.

Anda dapat menggunakan beberapa tindakan penciptaan sumber daya untuk menentukan tanda untuk sumber daya saat sumber daya diciptakan. Dalam kasus ini, jika tanda tidak dapat diterapkan saat sumber daya sedang dibuat, sumber daya gagal untuk dibuat. Mekanisme ini memastikan bahwa sumber daya yang Anda inginkan untuk ditandai pada penciptaan dibuat dengan tanda tertentu atau tidak dibuat sama sekali. Jika Anda menandai sumber daya pada saat penciptaan, Anda tidak perlu untuk menjalankan skrip penandaan khusus setelah penciptaan sumber daya.

Tabel berikut menjelaskan sumber daya Amazon EMR di EKS yang dapat ditandai.

Sumber Daya	Mendukung tanda	Propagasi dukungan tanda	Dukungan penandaan pada penciptaan (API Amazon EMR di EKS, AWS CLI, dan SDK AWS)	API untuk pembuatan (tanda dapat ditambahkan selama pembuatan)
Klaster virtual	Ya	Tidak. Tanda yang terkait dengan klaster virtual tidak menyebarkan ke tugas berjalan yang dikirimkan ke cluster virtual tersebut.	Ya	CreateVirtualCluster
Tugas berjalan	Ya	Tidak	Ya	StartJobRun

Batasan tag

Batasan dasar berikut berlaku untuk tag:

• Jumlah maksimum tanda per sumber daya – 50

• Untuk setiap sumber daya, setiap kunci tag harus unik, dan setiap kunci tag 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 dan sumber daya AWS, ingatlah bahwa layanan lain mungkin memiliki pembatasan pada karakter yang diizinkan. Karakter yang secara umum diperbolehkan adalah huruf, angka, spasi yang dapat diwakili dalam UTF-8, serta karakter berikut: + - = . _ : / @.

• Kunci dan nilai tag peka huruf besar dan kecil.

• Nilai tanda bisa berupa string kosong, tapi tidak null. Kunci tanda tidak bisa berupa string kosong.

• Jangan gunakan aws:, AWS:, atau kombinasi huruf besar atau kecil seperti prefiks baik untuk kunci atau nilai. Ini hanya diperuntukkan bagi penggunaan AWS.

Bkerja dengan tanda menggunakan AWS CLI dan API Amazon EMR di EKS

Gunakan perintah AWS CLI berikut atau operasi API Amazon EMR di EKS untuk menambahkan, memperbarui, membuat daftar, dan menghapus tanda untuk sumber daya Anda.

Tugas	AWS CLI	Tindakan API
Penambahan atau penimpaan satu tag atau lebih	tag-resource	TagResource
Daftar tanda untuk sumber daya	list-tags-for-resource	ListTagsForResource
Penghapusan satu tag atau lebih	untag-resource	UntagResource

Contoh berikut menunjukkan cara menandai atau menghapus tanda pada sumber daya menggunakan AWS CLI.

Contoh 1: Menandai klaster virtual yang ada

Perintah berikut memberi tanda klaster virtual yang ada.

aws emr-containers tag-resource --resource-arn resource_ARN --tags team=devs

Contoh 2: Untag klaster virtual yang ada

Perintah berikut menghapus tanda dari klaster virtual yang ada.

aws emr-containers untag-resource --resource-arn resource_ARN --tag-keys tag_key

Contoh 3: Daftar tanda untuk sumber daya

Perintah berikut membuat daftar tanda yang terkait dengan sumber daya yang ada.

aws emr-containers list-tags-for-resource --resource-arn resource_ARN