Menandai sumber daya AWS Batch Anda

Untuk membantu Anda mengelola sumber daya AWS Batch, Anda dapat menetapkan 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 merupakan label yang Anda tetapkan ke 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 Batch 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 Batch 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 Batch.

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.

Penandaan sumber daya Anda

Anda dapat menandai lingkungan AWS Batch komputasi baru atau yang sudah ada, pekerjaan, definisi pekerjaan, antrian pekerjaan, dan kebijakan penjadwalan.

Jika Anda menggunakan konsol AWS Batch, Anda dapat menerapkan tanda ke sumber daya baru ketika itu dibuat atau ke sumber daya yang sudah ada dengan menggunakan tab Tags (Tanda) di panel navigasi kapan saja.

Jika Anda menggunakan API AWS Batch, AWS CLI, atau AWS SDK, Anda dapat menerapkan tanda ke sumber daya baru dengan menggunakan parameter tags di pada tindakan API yang relevan atau ke sumber daya yang ada dengan menggunakan tindakan API TagResource. 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 Batch yang dapat ditandai, dan sumber daya yang dapat ditandai saat dibuat.

Dukungan penandaan untuk sumber daya AWS Batch
Sumber daya	Mendukung tanda	Penyebaran tanda Support	Mendukung penandaan saat pembuatan (AWS Batch API, AWS CLI, AWS SDK)
Lingkungan komputasi AWS Batch	Ya	Tidak. Tanda lingkungan komputasi tidak dipropagasi ke sumber daya lainnya. Tag untuk sumber daya ditentukan dalam anggota tag objek ComputereSources yang diteruskan dalam operasi API. CreateComputeEnvironment	Ya
Tugas AWS Batch	Ya	Ya	Ya
Ketentuan tugas AWS Batch	Ya	Tidak	Ya
Antrean tugas AWS Batch	Ya	Tidak	Ya
AWS Batchkebijakan penjadwalan	Ya	Tidak	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 memuat 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 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 tags-per-resource batas Anda.

Bekerja dengan tanda menggunakan konsol

Menggunakan perintah konsol AWS Batch, Anda dapat mengelola tanda yang terkait dengan lingkungan komputasi, tugas, ketentuan tugas, dan antrean tugas baru atau yang sudah ada.

Menambahkan tanda pada pembuatan sumber daya individu

Anda dapat menambahkan tag untuk AWS Batch menghitung lingkungan, pekerjaan, definisi pekerjaan, antrian pekerjaan, dan kebijakan penjadwalan saat Anda membuatnya.

Penambahan dan penghapusan tanda pada sumber daya individu

AWS Batch memungkinkan Anda untuk menambahkan atau menghapus tanda yang berkaitan dengan klaster Anda langsung dari halaman sumber daya.

Untuk menambahkan atau menghapus sebuah tanda pada sebuah sumber daya individu

1. Buka konsol AWS Batch di https://console.aws.amazon.com/batch/.

2. Di bilah navigasi, pilih Wilayah yang akan digunakan.

3. Di panel navigasi, pilih tipe sumber daya (misalnya, Job Queues (Antrean Tugas)).

4. Pilih sumber daya tertentu, lalu pilih Edit tags (Edit tanda).

5. Tambah atau hapus tanda Anda sesuai kebutuhan.

   • Untuk menambahkan tanda — tentukan kunci dan nilai dalam kotak teks kosong di akhir daftar.

   • Untuk menghapus tanda — pilih tombol di sebelah tanda.

6. Ulangi proses ini untuk setiap tanda yang ingin Anda tambah atau hapus, lalu pilih Edit tags (Edit tanda) untuk menyelesaikan.

Cara menggunakan tanda dengan menggunakan CLI atau API

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

Dukungan penandaan untuk sumber daya AWS Batch
Tugas	Tindakan API	AWS CLI	AWS Tools for Windows PowerShell
Tambahkan atau timpa satu atau beberapa tanda.	TagResource	tag-sumber daya	Add-bat ResourceTag
Hapus satu atau beberapa tanda.	UntagResource	untag-sumber daya	Hapus-kelelawar ResourceTag
Membuat daftar tanda untuk sumber daya	ListTagsForResource	list-tags-for-resource	Dapatkan kelelawar ResourceTag

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

Contoh 1: Menandai sumber daya yang sudah ada

Perintah berikut ini menandai sumber daya yang sudah ada.

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

Contoh 2: Menghapus tanda sumber daya yang sudah ada

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

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

Contoh 3: Cantumkan tanda untuk sumber daya

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

aws batch 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
Membuat lingkungan komputasi	CreateComputeEnvironment	create-compute-environment	Kelelawar baru ComputeEnvironment
Membuat antrean tugas	CreateJobQueue	create-job-queue	Kelelawar baru JobQueue
Buat kebijakan penjadwalan	CreateSchedulingPolicy	create-scheduling-policy	Kelelawar baru SchedulingPolicy
Mendaftarkan ketentuan tugas	RegisterJobDefinition	register-job-definition	Daftar-kelelawar JobDefinition
Mengirim tugas	SubmitJob	kirimkan pekerjaan	Kirim-Batjob