Pemberian tag pada sumber daya Amazon ECS Anda

Untuk membantu Anda mengelola sumber daya Amazon ECS, Anda dapat menetapkan metadata Anda sendiri ke setiap sumber daya menggunakan tanda. Setiap tag terdiri dari kunci dan nilai opsional.

Anda dapat menggunakan tanda untuk mengategorikan sumber daya Amazon ECS Anda dengan berbagai cara, misalnya, berdasarkan tujuan, pemilik, atau lingkungan. Hal ini berguna jika Anda memiliki banyak sumber daya dengan jenis yang sama. Anda dapat dengan cepat mengidentifikasi sumber daya tertentu berdasarkan tag yang Anda tetapkan. Misalnya, Anda dapat menentukan serangkaian tanda untuk instans kontainer Amazon ECS akun Anda. Ini membantu Anda melacak setiap pemilik instans dan tingkat tumpukan.

Anda dapat menggunakan tag untuk laporan Biaya dan Penggunaan. Anda dapat menggunakan laporan ini untuk menganalisis biaya dan penggunaan sumber daya Amazon ECS Anda. Untuk informasi selengkapnya, lihat Laporan penggunaan Amazon ECS.

Awas

Kunci tag dan nilai-nilainya akan ditampilkan oleh berbagai perintah API. Menolak akses ke DescribeTags tidak secara otomatis menolak akses ke tanda yang dikembalikan oleh API lain. Sebagai praktik terbaik, kami merekomendasikan agar Anda tidak menyertakan data sensitif dalam tanda Anda.

Sebaiknya Anda merancang seperangkat kunci tanda yang memenuhi kebutuhan Anda untuk setiap jenis sumber daya. Anda dapat menggunakan serangkaian kunci tanda yang konsisten untuk pengelolaan sumber daya Anda dengan lebih mudah. Anda dapat mencari dan menyaring sumber daya berdasarkan tanda yang Anda tambahkan.

Tanda tidak memiliki makna semantik bagi Amazon ECS dan diterjemahkan sebagai serangkaian karakter saja. Anda dapat mengedit kunci dan nilai tanda, dan Anda dapat membuang tanda dari sumber daya kapan saja. Anda dapat mengatur nilai tanda ke string kosong, akan tetapi Anda tidak dapat mengatur nilai tanda ke nol. Jika Anda menambahkan tanda yang memiliki kunci yang sama dengan tanda yang ada pada sumber daya tersebut, nilai baru akan menimpa nilai sebelumnya. Jika Anda menghapus sumber daya, semua tanda untuk sumber daya juga akan dihapus.

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

Bagaimana sumber daya ditandai

Ada beberapa cara agar tugas, dan klaster Amazon ECS ditandai:

• Pengguna secara manual menandai sumber daya dengan menggunakan API Amazon ECS,AWS CLI, atauAWS SDK.AWS Management Console

• Pengguna membuat layanan atau menjalankan tugas mandiri dan memilih opsi tag yang dikelola Amazon ECS.

  Amazon ECS secara otomatis menandai semua tugas yang baru diluncurkan. Untuk informasi selengkapnya, lihat Tag yang dikelola Amazon ECS.

• Seorang pengguna membuat sumber daya menggunakan konsol. Konsol secara otomatis menandai sumber daya.

  Tag ini dikembalikan dalamAWS CLI responsAWS SDK dan ditampilkan di konsol. Anda tidak dapat mengubah atau menghapus tanda tersebut.

  Untuk informasi tentang tag yang ditambahkan, lihat Tag yang secara otomatis ditambahkan oleh kolom konsol di dukungan Tagging untuk tabel sumber daya Amazon ECS.

Jika Anda menentukan tag saat membuat sumber daya dan tag tidak dapat diterapkan, Amazon ECS mengembalikan proses pembuatan. Hal ini untuk memastikan bahwa sumber daya dibuat dengan tanda atau tidak dibuat sama sekali, dan tidak ada sumber daya yang dibiarkan tanpa tanda kapan saja. Dengan menandai sumber daya saat sedang dibuat, Anda dapat menghilangkan kebutuhan untuk menjalankan skrip penandaan khusus setelah pembuatan sumber daya.

Tabel berikut menjelaskan sumber daya Amazon ECS yang mendukung penandaan.

Dukungan pemberian tag pada sumber daya Amazon ECS
Resource	Mendukung tanda	Penyebaran tanda Support	Dukungan penandaan saat penciptaan (API Amazon ECSAWS CLI,AWS SDK)	Tag otomatis ditambahkan oleh konsol
Tugas Amazon ECS	Ya	Ya, dari ketentuan tugas.	Ya	Kunci:aws:ecs:clusterName Nilai:cluster-name
Layanan Amazon ECS	Ya	Ya, baik dari ketentuan tugas ataupun layanan ke dalam tugas dalam layanan.	Ya	Kunci:ecs:service:stackId Nilaiarn:aws:cloudformation:arn
Set tugas Amazon ECS	Ya	Tidak	Ya	T/A
Definisi tugas Amazon ECS	Ya	Tidak	Ya	Kunci:ecs:taskDefinition:createdFrom Nilai:ecs-console-v2
Klaster Amazon ECS	Ya	Tidak	Ya	Kunci:aws:cloudformation:logical-id Nilai:ECSCluster Kunci:aws:cloudformation:stack-id Nilai:arn:aws:cloudformation:arn Kunci:aws:cloudformation:stack-name Nilai:ECS-Console-V2-Cluster-EXAMPLE
Instans Amazon	Ya	Tidak	Tidak, Anda dapat menambahkan tanda setelah instans eksternal didaftarkan ke klaster menggunakanAWS Management Console atau dengan menggunakan API Amazon ECS,AWS CLI, atauAWS SDK. Untuk informasi selengkapnya, lihat Mengelola tag sumber daya individu menggunakan konsol.	T/A
Penyedia kapasitas Amazon ECS	Ya. Anda tidak dapat menandai penyedia yang telah ditentukanFARGATE danFARGATE_SPOT kapasitas.	Tidak	Ya	T/A

Pembatasan tanda

Batasan berikut berlaku untuk tanda:

• Maksimum 50 tanda dapat dikaitkan dengan sumber daya.

• Kunci tag tidak dapat diulang untuk satu sumber daya. Setiap kunci tanda harus unik, dan hanya dapat memiliki satu nilai.

• Kunci dapat memiliki panjang hingga 128 karakter.

• Panjang nilai dapat mencapai 256 karakter.

• Jika beberapaLayanan AWS dan sumber daya menggunakan skema penandaan Anda, batasi jenis karakter yang Anda gunakan. Beberapa layanan mungkin memiliki batasan pada karakter yang diizinkan. Umumnya, karakter yang diizinkan adalah huruf, angka, spasi, dan karakter berikut:+-=._:/@.

• Kunci dan nilai tag peka huruf besar dan kecil.

• Anda tidak dapat menggunakanaws:AWS:,, atau kombinasi huruf besar atau kecil seperti prefiks untuk kunci atau nilai. Ini disimpan hanya untuk penggunaan AWS. Anda tidak dapat mengedit atau menghapus kunci atau nilai tanda dengan prefiks ini. Tag dengan awalan ini tidak dihitung terhadap tags-per-resource batas Anda.

Tag yang dikelola Amazon ECS

Saat Anda menggunakan tag yang dikelola Amazon ECS, Amazon ECS secara otomatis menandai semua tugas yang baru diluncurkan dengan informasi klaster dan pengguna menambahkan tag definisi tugas atau tag layanan. Berikut ini menjelaskan tag yang ditambahkan:

• Standalone tasks — tag dengan Key asaws:ecs:clusterName dan Value yang ditetapkan ke nama klaster. Semua tag definisi tugas yang ditambahkan oleh pengguna.

• Tugas yang merupakan bagian dari layanan — tag dengan Key asaws:ecs:clusterName dan Value yang ditetapkan ke nama klaster. Tag dengan Key asaws:ecs:serviceName dan Value ditetapkan ke nama layanan. Tag dari salah satu sumber daya berikut:

  • Definisi tugas - Semua tag definisi tugas yang ditambahkan oleh pengguna.

  • Layanan - Semua tag layanan yang ditambahkan oleh pengguna.

Opsi-opsi berikut diperlukan untuk fitur ini:

• Anda harus ikut serta ke dalam format Amazon Resource Name (ARN) dan pengidentifikasi (ID) sumber daya baru. Untuk informasi selengkapnya, lihat Amazon Resource Name (ARN) dan ID.

• Ketika Anda menggunakan API untuk membuat layanan atau menjalankan tugas, Anda harus mengaturenableECSManagedTagstrue untukrun-task dancreate-service. Untuk informasi selengkapnya, lihat create-service dan run-task di ReferensiAWS Command Line Interface API.

Menandai sumber daya Anda untuk penagihan

Anda dapat menggunakan tag yang dikelola Amazon ECS atau tag yang ditambahkan pengguna untuk Laporan Biaya dan Penggunaan Anda. Untuk informasi selengkapnya, lihat Laporan penggunaan Amazon ECS.

Untuk melihat biaya sumber daya gabungan, Anda dapat mengatur informasi penagihan berdasarkan sumber daya yang memiliki nilai kunci tanda yang sama. Misalnya, Anda dapat memberi tanda pada beberapa sumber daya dengan nama aplikasi tertentu, lalu organisir informasi penagihan Anda untuk melihat total biaya aplikasi tersebut pada beberapa layanan. Untuk informasi selengkapnya tentang pengaturan laporan alokasi biaya dengan tanda, lihat Laporan Alokasi Biaya Bulanan dalam Panduan Pengguna AWS Billing.

catatan

Jika Anda telah mengaktifkan pelaporan, data untuk bulan ini tersedia untuk dilihat setelah 24 jam.

Bekerja dengan tanda menggunakan konsol

Dengan menggunakan konsol Amazon ECS, Anda dapat mengelola tanda yang terkait dengan tugas, layanan, definisi tugas, klaster, atau instans kontainer yang baru atau yang sudah ada.

Saat Anda memilih halaman khusus sumber daya dalam konsol Amazon ECS, halaman tersebut akan menampilkan daftar sumber daya tersebut. Misalnya, jika Anda memilih Klaster dari panel navigasi, konsol akan menampilkan daftar klaster Amazon ECS. Saat Anda memilih sumber daya dari salah satu daftar (misalnya, klaster tertentu) yang mendukung tanda ini, Anda dapat melihat dan mengelola tandanya di tab Tanda.

Awas

Sebagai praktik terbaik, kami merekomendasikan agar Anda tidak menyertakan data sensitif dalam tanda Anda.

Penambahan tanda pada sumber daya individu selama peluncuran

Anda dapat menggunakan sumber daya berikut untuk menentukan tanda saat membuat sumber daya.

Tugas	Konsol
Jalankan satu tugas atau lebih.	Menjalankan tugas mandiri menggunakan konsol Amazon ECS
Buat sebuah layanan.	Membuat layanan menggunakan konsol
Buat satu set tugas.	Deployment eksternal
Daftarkan ketentuan tugas.	Membuat definisi tugas menggunakan konsol
Buat sebuah klaster.	Membuat cluster untuk jenis peluncuran Fargate menggunakan konsol

Mengelola tag sumber daya individu menggunakan konsol

Amazon ECS memungkinkan Anda untuk menambahkan atau menghapus tanda yang terkait dengan klaster, layanan, tugas, dan ketentuan tugas secara langsung dari halaman sumber daya.

Awas

Jangan menambahkan informasi pengenal pribadi (PII) atau informasi rahasia atau sensitif lainnya dalam tag. Tag dapat diakses oleh banyak layanan AWS, termasuk penagihan. Tag tidak dimaksudkan untuk digunakan dalam data sensitif atau privat.

Untuk memodifikasi tag untuk sumber daya individu

1. Buka konsol di https://console.aws.amazon.com/ecs/v2.

2. Pada bilah navigasi, pilihWilayah AWS untuk digunakan.

3. Di panel navigasi, pilih tipe sumber daya (misalnya, Klaster).

4. Pilih sumber daya dari daftar sumber daya, pilih tab Tag, lalu pilih Kelola tag.

5. Konfigurasikan tanda Anda.

   [Menambahkan tanda] Pilih Tambah tanda dan lakukan hal berikut:

   • Untuk Kunci, masukkan nama kunci.

   • Untuk Nilai, masukkan nilai kunci.

   [Hapus tag] Pilih Hapus di sebelah kanan Kunci dan Nilai tag.

6. Pilih Save (Simpan).

Bekerja dengan tanda menggunakan CLI atau API

Gunakan hal-hal berikut untuk menambahkan, memperbarui, mencantumkan, dan menghapus tanda untuk sumber daya Anda. Dokumentasi yang sesuai menyediakan contoh.

Awas

Jangan menambahkan informasi pengenal pribadi (PII) atau informasi rahasia atau sensitif lainnya dalam tag. Tag dapat diakses oleh banyak orangLayanan AWS, termasuk penagihan. Tag tidak dimaksudkan untuk digunakan untuk data privat atau sensitif.

Dukungan pemberian tag pada sumber daya Amazon ECS
Tugas	AWS CLI	Tindakan API
Tambahkan atau timpa satu atau beberapa tanda.	tag-sumber daya	TagResource
Hapus satu atau beberapa tanda.	untag-sumber daya	UntagResource

Anda dapat menggunakan beberapa tindakan penciptaan sumber daya untuk menentukan tanda saat membuat sumber daya. Tindakan berikut mendukung penandaan saat pembuatan.

Tugas	AWS CLI	AWS Tools for Windows PowerShell	Tindakan API
Jalankan satu atau beberapa tugas.	run-tugas	Start-ecstask	RunTask
Buat sebuah layanan.	buat-layanan	Baru-ECSService	CreateService
Buat satu set tugas.	create-task-set	ECS baruTaskSet	CreateTaskSet
Mendaftarkan ketentuan tugas.	register-task-definition	Daftar-ECSTaskDefinition	RegisterTaskDefinition
Buat sebuah klaster.	buat-cluster	Baru-ecscluster	CreateCluster