Menandai sumber daya Amazon ECS - Amazon Elastic Container Service

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menandai sumber daya Amazon ECS

Untuk membantu mengelola ECS sumber daya Amazon, 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 ECS sumber daya Amazon 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 ECS penampung Amazon 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 ECS sumber daya Amazon Anda. Untuk informasi selengkapnya, lihat Laporan ECS penggunaan Amazon.

Awas

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

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

Tag tidak memiliki arti semantik ke 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 ECS tugas, layanan, definisi tugas, dan cluster Amazon:

  • Pengguna secara manual menandai sumber daya dengan menggunakan AWS Management Console ECSAPI, Amazon AWS CLI, atau file AWS SDK.

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

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

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

    Tag ini dikembalikan di AWS CLI, dan AWS SDK tanggapan 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 Dukungan penandaan untuk ECS sumber daya Amazon.

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

Sumber daya Mendukung tanda Penyebaran tanda Support Tag secara otomatis ditambahkan oleh konsol

ECSTugas Amazon

Ya

Ya, dari ketentuan tugas.

Kunci: aws:ecs:clusterName

Nilai: cluster-name

ECSLayanan Amazon

Ya

Ya, baik dari ketentuan tugas ataupun layanan ke dalam tugas dalam layanan.

Kunci: ecs:service:stackId

Nilai arn:aws:cloudformation:arn

Set ECS tugas Amazon

Ya

Tidak

N/A

Definisi ECS tugas Amazon

Ya

Tidak

Kunci: ecs:taskDefinition:createdFrom

Nilai: ecs-console-v2

ECSCluster Amazon

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

Contoh ECS kontainer Amazon

Ya

Ya, dari EC2 contoh Amazon. Untuk informasi selengkapnya, lihat Menambahkan tag ke instance ECS penampung Amazon.

N/A

Contoh ECS Eksternal Amazon

Ya

Tidak

N/A
Penyedia ECS kapasitas Amazon Ya.

Anda tidak dapat menandai penyedia yang telah ditentukan FARGATE dan FARGATE_SPOT kapasitas.

Tidak N/A

Menandai sumber daya pada pembuatan

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

  • ECSTugas Amazon

  • ECSLayanan Amazon

  • Definisi ECS tugas Amazon

  • Set ECS tugas Amazon

  • ECSCluster Amazon

  • Contoh ECS kontainer Amazon

  • Penyedia ECS kapasitas Amazon

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 tanda 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 ECS dikelola Amazon

Saat Anda menggunakan tag yang ECS dikelola Amazon, Amazon ECS secara otomatis menandai semua tugas yang baru diluncurkan dan EBS volume Amazon 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. EBSVolume Amazon 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 EBS volume Amazon, 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.

      EBSVolume Amazon 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 EBS volume Amazon, 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 Nama Sumber Daya Amazon (ARNs) dan IDs.

  • Bila Anda menggunakan APIs untuk membuat layanan atau menjalankan tugas, Anda harus mengatur enableECSManagedTags true untuk run-task dancreate-service. Untuk informasi selengkapnya, lihat create-service dan run-task di Referensi.AWS Command Line Interface API

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

Gunakan tag untuk penagihan

AWS menyediakan alat pelaporan yang disebut Cost Explorer yang dapat Anda gunakan untuk menganalisis biaya dan penggunaan ECS sumber daya Amazon 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 ECS dikelola Amazon atau tag yang ditambahkan pengguna untuk Laporan Biaya dan Penggunaan Anda. Untuk informasi selengkapnya, lihat Laporan ECS penggunaan Amazon.

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 Pisahkan untuk mendapatkan data penggunaan tingkat tugas CPU dan 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.