Penandaan sumber daya Amazon ECS

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

Anda dapat menggunakan tag untuk mengkategorikan 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 padanya. Misalnya, Anda dapat menentukan satu set tag untuk instans penampung Amazon ECS akun Anda. Ini membantu Anda melacak setiap pemilik instans dan tingkat tumpukan.

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

Awas

Ada banyak API yang mengembalikan kunci tag dan nilainya. Menolak akses ke DescribeTags tidak secara otomatis menolak akses ke tanda yang ditampilkan oleh API lain. Sebagai praktik terbaik, sebaiknya Anda tidak menyertakan data sensitif ke dalam tanda.

Sebaiknya rancang serangkaian kunci tanda yang memenuhi kebutuhan setiap tipe sumber daya. Anda dapat menggunakan satu set kunci tag yang konsisten untuk memudahkan pengelolaan sumber daya Anda. Anda dapat mencari dan memfilter sumber daya berdasarkan tanda yang Anda tambahkan.

Tag tidak memiliki arti semantik untuk Amazon ECS dan ditafsirkan secara ketat sebagai serangkaian karakter. Anda dapat mengedit kunci dan nilai tanda, dan dapat menghapus 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. Saat Anda menghapus sumber daya, tag apa pun untuk sumber daya juga dihapus.

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

Bagaimana sumber daya ditandai

Ada beberapa cara untuk menandai tugas, layanan, definisi tugas, dan cluster Amazon ECS:

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

• 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.

• Pengguna membuat sumber daya menggunakan konsol. Konsol secara otomatis menandai sumber daya.

  Tag ini dikembalikan dalam AWS CLI, dan respons AWS SDK dan ditampilkan di konsol. Anda tidak dapat mengubah atau menghapus tag ini.

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

Jika Anda menentukan tag saat membuat sumber daya dan tag tidak dapat diterapkan, Amazon ECS akan 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.

Menandai dukungan untuk sumber daya Amazon ECS
Sumber daya	Mendukung tanda	Penyebaran tanda Support	Tag secara otomatis ditambahkan oleh konsol
Tugas-tugas Amazon ECS	Ya	Ya, dari ketentuan tugas.	Kunci: aws:ecs:clusterName Nilai: cluster-name
Layanan-layanan Amazon ECS	Ya	Ya, baik dari ketentuan tugas ataupun layanan ke dalam tugas dalam layanan.	Kunci: ecs:service:stackId Nilai arn:aws:cloudformation:arn
Set tugas Amazon ECS	Ya	Tidak	N/A
Definisi tugas Amazon ECS	Ya	Tidak	Kunci: ecs:taskDefinition:createdFrom Nilai: ecs-console-v2
Klaster-klaster Amazon ECS	Ya	Tidak	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 kontainer Amazon ECS	Ya	Ya, dari instans Amazon EC2. Untuk informasi selengkapnya, lihat Menambahkan tag ke instans penampung Amazon EC2.	N/A
Instans Eksternal Amazon ECS	Ya	Tidak	N/A
Penyedia kapasitas Amazon ECS	Ya. Anda tidak dapat menandai penyedia standar FARGATE dan FARGATE_SPOT kapasitas.	Tidak	N/A

Menandai sumber daya pada pembuatan

Sumber daya berikut mendukung penandaan pada pembuatan menggunakan Amazon ECS API, AWS CLI, atau AWS SDK:

• Tugas-tugas Amazon ECS

• Layanan-layanan Amazon ECS

• Definisi tugas Amazon ECS

• Set tugas Amazon ECS

• Klaster-klaster Amazon ECS

• Instans kontainer Amazon ECS

• Penyedia kapasitas Amazon ECS

Amazon ECS memiliki opsi untuk menggunakan otorisasi penandaan untuk pembuatan sumber daya. Ketika Akun AWS dikonfigurasi untuk menandai otorisasi, pengguna harus memiliki izin untuk tindakan yang membuat sumber daya, seperti. ecsCreateCluster Jika Anda menentukan tag dalam tindakan pembuatan sumber daya, AWS lakukan otorisasi tambahan untuk memverifikasi apakah pengguna atau peran memiliki izin untuk membuat tag. Oleh karena itu, Anda harus memberikan izin eksplisit untuk menggunakan tindakan. ecs:TagResource Untuk informasi selengkapnya, lihat Berikan izin untuk menandai sumber daya pada pembuatan. Untuk informasi tentang cara mengkonfigurasi opsi, lihatOtorisasi penandaan.

Pembatasan

Pembatasan berikut berlaku untuk tag:

• Maksimal 50 tag dapat dikaitkan dengan sumber daya.

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

• Panjang tombol dapat mencapai 128 karakter di UTF-8.

• Nilai dapat mencapai 256 karakter di UTF-8.

• Jika beberapa Layanan 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-kecil.

• Anda tidak dapat menggunakan aws:AWS:,, atau kombinasi huruf besar atau kecil seperti awalan untuk kunci atau nilai. Ini hanya disediakan untuk AWS digunakan. Anda tidak dapat menyunting atau menghapus kunci atau nilai tag dengan awalan 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 dan volume Amazon EBS apa pun yang dilampirkan ke tugas dengan informasi klaster dan tag definisi tugas yang ditambahkan pengguna atau tag layanan. Berikut ini menjelaskan tag yang ditambahkan:

• Tugas mandiri — tag dengan Key as aws:ecs:clusterName dan Value yang disetel ke nama cluster. Semua tag definisi tugas yang ditambahkan oleh pengguna. Volume Amazon EBS yang dilampirkan ke tugas mandiri akan menerima tag dengan Kunci sebagai aws:ecs:clusterName dan Nilai yang disetel ke nama cluster. Untuk informasi selengkapnya tentang penandaan volume Amazon EBS, lihat Menandai volume Amazon EBS.

• Tugas yang merupakan bagian dari layanan — tag dengan Kunci sebagai aws:ecs:clusterName dan Nilai yang disetel ke nama cluster. Tag dengan Key as aws:ecs:serviceName dan Value diatur ke nama layanan. Tag dari salah satu sumber berikut:

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

  • Layanan — Semua tag layanan yang ditambahkan oleh pengguna.

    Volume Amazon EBS yang dilampirkan ke tugas yang merupakan bagian dari layanan akan menerima tag dengan Kunci sebagai aws:ecs:clusterName dan Nilai yang disetel ke nama cluster, dan tag dengan Kunci sebagai aws:ecs:serviceName dan Nilai yang disetel ke nama layanan. Untuk informasi selengkapnya tentang penandaan volume Amazon EBS, lihat Menandai volume Amazon EBS.

Opsi berikut diperlukan untuk fitur ini:

• Anda harus ikut serta dalam format Amazon Resource Name (ARN) dan resource identifier (ID) yang baru. Untuk informasi selengkapnya, lihat Amazon Resource Name (ARN) dan ID.

• Saat Anda menggunakan API untuk membuat layanan atau menjalankan tugas, Anda harus menyetel enableECSManagedTags ke true for run-task andcreate-service. Untuk informasi selengkapnya, lihat create-service dan run-task di Referensi API.AWS Command Line Interface

• Amazon ECS menggunakan tag terkelola untuk menentukan kapan beberapa fitur diaktifkan, misalnya Auto Scaling cluster. Kami menyarankan Anda untuk tidak memodifikasi tag secara manual sehingga Amazon ECS dapat mengelola fitur secara efektif.

Menandai sumber daya Anda untuk penagihan

AWS menyediakan alat pelaporan yang disebut Cost Explorer yang dapat Anda gunakan untuk menganalisis biaya dan penggunaan sumber daya Amazon ECS Anda.

Anda dapat menggunakan Cost Explorer untuk melihat bagan penggunaan dan biaya Anda. Anda dapat melihat data dari 13 bulan terakhir, dan memperkirakan berapa banyak kemungkinan Anda akan menghabiskan untuk tiga bulan ke depan. Anda dapat menggunakan Cost Explorer untuk melihat pola terkait berapa banyak sumber daya AWS yang Anda belanjakan dari waktu ke waktu. Misalnya, Anda dapat menggunakannya untuk mengidentifikasi area yang memerlukan penyelidikan lebih lanjut dan melihat tren yang dapat Anda gunakan untuk memahami biaya Anda. Anda juga dapat menentukan rentang waktu untuk data, dan melihat data waktu menurut hari atau bulan.

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 .

Selain itu, Anda dapat mengaktifkan Data Alokasi Biaya Split untuk mendapatkan CPU tingkat tugas dan data penggunaan memori di Laporan Biaya dan Penggunaan Anda. Untuk informasi selengkapnya, lihat Laporan Biaya dan Penggunaan Tingkat Tugas.

catatan

Jika Anda mengaktifkan pelaporan, diperlukan waktu hingga 24 jam sebelum data untuk bulan berjalan tersedia untuk dilihat.