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 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](usage-reports.md).
**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 lain APIs. 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 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 Konsol Manajemen AWS, 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](#managed-tags).
+ 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.
| Sumber daya | Mendukung tag | Mendukung penyebaran tag | 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 untuk Amazon ECS](instance-details-tags.md). | N/A |
| Instans Eksternal Amazon ECS | Ya | Tidak | N/A |
| Penyedia kapasitas Amazon ECS | Ya. Anda tidak dapat menandai penyedia yang telah ditentukan `FARGATE` dan `FARGATE_SPOT` kapasitas. | Ya, hanya dari penyedia kapasitas untuk Instans Terkelola Amazon ECS. Anda dapat menyebarkan tag dari penyedia kapasitas untuk Instans Terkelola Amazon ECS ke semua sumber daya yang dikelola oleh penyedia seperti instans Amazon EC2, templat peluncuran, Antarmuka Jaringan Elastis, dan volume. | 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 memberikan tag pada sumber daya saat dibuat](supported-iam-actions-tagging.md). Untuk informasi tentang cara mengkonfigurasi opsi, lihat[Otorisasi pemberian tag](ecs-account-settings.md#tag-resources-setting).
## Pembatasan
Batasan berikut ini 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 sensitif huruf besar dan 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 mengedit atau menghapus kunci atau nilai tag 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 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](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specify-ebs-config.html#ebs-volume-tagging) 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](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specify-ebs-config.html#ebs-volume-tagging) 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](ecs-account-settings.md#ecs-resource-ids).
+ Bila Anda menggunakan APIs untuk membuat layanan atau menjalankan tugas, Anda harus mengatur `enableECSManagedTags` `true` untuk `run-task` dan`create-service`. *Untuk informasi selengkapnya, lihat [create-service](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html) dan [run-task](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html) 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.
## Gunakan tag 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](usage-reports.md).
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](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html) 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](usage-reports.md#task-cur).
**catatan**
Jika Anda mengaktifkan pelaporan, diperlukan waktu hingga 24 jam sebelum data untuk bulan berjalan tersedia untuk dilihat.
# Menambahkan tag ke sumber daya Amazon ECS
Anda dapat menandai tugas, layanan, definisi tugas, atau cluster baru atau yang sudah ada. Untuk informasi selengkapnya tentang menandai instans Anda, lihat [Menambahkan tag ke instans penampung Amazon EC2 untuk Amazon ECS](instance-details-tags.md).
**Awas**
Jangan menambahkan informasi pengenal pribadi (PII) atau informasi rahasia atau sensitif lainnya dalam tag. Tag dapat diakses oleh banyak AWS layanan, termasuk penagihan. Tag tidak dimaksudkan untuk digunakan dalam data sensitif atau privat.
Anda dapat menggunakan sumber daya berikut untuk menentukan tag saat Anda membuat sumber daya.
| Tugas | Konsol | AWS CLI | Tindakan API |
| --- | --- | --- | --- |
| Jalankan satu atau beberapa tugas. | [Menjalankan aplikasi sebagai tugas Amazon ECS](standalone-task-create.md) | [jalankan-tugas](https://docs.aws.amazon.com/cli/latest/reference/ecs/run-task.html) | [RunTask](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html) |
| Buat sebuah layanan. | [Membuat penyebaran pembaruan bergulir Amazon ECS](create-service-console-v2.md) | [membuat-layanan](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-service.html) | [CreateService](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html) |
| Buat satu set tugas. | [Menyebarkan layanan Amazon ECS menggunakan pengontrol pihak ketiga](deployment-type-external.md) | [create-task-set](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-task-set.html) | [CreateTaskSet](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateTaskSet.html) |
| Daftarkan ketentuan tugas. | [Membuat definisi tugas Amazon ECS menggunakan konsol](create-task-definition.md) | [register-task-definition](https://docs.aws.amazon.com/cli/latest/reference/ecs/register-task-definition.html) | [RegisterTaskDefinition](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RegisterTaskDefinition.html) |
| Buat sebuah klaster. | [Membuat cluster Amazon ECS untuk beban kerja Fargate](create-cluster-console-v2.md) | [buat-cluster](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-cluster.html) | [CreateCluster](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCluster.html) |
| Jalankan satu atau beberapa instans kontainer. | [Meluncurkan instans penampung Amazon ECS Linux](launch_container_instance.md) | [run-instance](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) | [RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html) |
| Buat penyedia kapasitas untuk Instans Terkelola Amazon ECS. | [Membuat penyedia kapasitas untuk Instans Terkelola Amazon ECS](create-capacity-provider-managed-instances.md) | [create-capacity-provider](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-capacity-provider.html) | [CreateCapacityProvider](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCapacityProvider.html) |
## Menambahkan tag ke sumber daya yang ada (konsol Amazon ECS)
Anda dapat menambahkan atau menghapus tag yang terkait dengan cluster, layanan, tugas, dan definisi tugas langsung dari halaman sumber daya.
**Untuk memodifikasi tag untuk sumber daya individu**
1. Buka konsol di [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).
1. Dari bilah navigasi, pilih yang Wilayah AWS akan digunakan.
1. Di panel navigasi, pilih tipe sumber daya (misalnya, **Klaster**).
1. Pilih sumber daya dari daftar sumber daya, pilih tab **Tag**, lalu pilih **Kelola tag**.
1. Konfigurasikan tag Anda.
[Tambahkan tag] Pilih **Tambah tag**, lalu lakukan hal berikut:
+ Untuk **Kunci**, masukkan nama kunci.
+ Untuk **Nilai**, masukkan nilai kunci.
1. Pilih **Simpan**.
## Menambahkan tag ke sumber daya yang ada (AWS CLI)
Anda dapat menambahkan atau menimpa satu atau beberapa tag dengan menggunakan AWS CLI atau API.
**catatan**
Anda dapat menggunakan titik akhir layanan dual-stack untuk berinteraksi dengan Amazon ECS dari AWS CLI, SDKs dan Amazon ECS API melalui keduanya dan. IPv4 IPv6 Untuk informasi selengkapnya, lihat [Menggunakan titik akhir tumpukan ganda Amazon ECS](dual-stack-endpoint.md).
+ AWS CLI - [tag-sumber daya](https://docs.aws.amazon.com/cli/latest/reference/ecs/tag-resource.html)
+ Tindakan API - [TagResource](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TagResource.html)
# Tag untuk Instans Terkelola Amazon ECS
Instans Terkelola Amazon ECS mendukung kombinasi tag dan tag khusus yang ditambahkan AWS yang dapat digunakan untuk pengoptimalan biaya. Untuk informasi selengkapnya tentang penggunaan tag untuk penagihan, lihat[Gunakan tag untuk penagihan](ecs-using-tags.md#tag-resources-for-billing).
## Tag ditambahkan oleh AWS
AWS menambahkan tag berikut ke setiap Instans Terkelola Amazon ECS yang dibuat oleh penyedia kapasitas:
+ Amazon ECS secara otomatis menambahkan tag yang dicadangkan `AmazonECSCreated` dan `AmazonECSManaged` ke Instans Terkelola Amazon ECS.
+ Amazon ECS menambahkan tag sistem berikut ke setiap instance:
+ Tag dengan *Key* as `aws:ecs:clusterName` dan *Value* diatur ke nama cluster.
+ Tag dengan *Key* as `aws:ecs:capacityProviderName` dan *Value* diatur ke nama penyedia kapasitas.
+ Tag dengan *Key* as `aws:ecs:containerInstanceId` dan *Value* sebagai ID instance container untuk Instans Terkelola Amazon ECS.
+ Amazon EC2 menambahkan tag sistem `aws:ec2:managed-launch` dengan nilainya. `ecs-managed-instances` Selain itu, Amazon EC2 menambahkan tag sistem yang menunjukkan template peluncuran yang digunakan untuk membuat instans terkelola, dan armada Amazon EC2 yang menjadi bagian dari instans terkelola.
## Tag kustom
Anda dapat menambahkan tag kustom tambahan ke Instans Terkelola Amazon ECS dengan menambahkan tag ke penyedia kapasitas dan mengaktifkan propagasi tag menggunakan properti. `propagateTags` Tag pada penyedia kapasitas menyebar ke instance terkelola yang diluncurkan penyedia kapasitas
Contoh definisi penyedia kapasitas berikut menunjukkan bagaimana tag dapat ditentukan dan disebarkan dari penyedia kapasitas saat membuat penyedia kapasitas menggunakan `CAPACITY_PROVIDER` nilai untuk`propagateTags`.
```
{
"name": "my-cluster-managed-instances-cp",
"cluster": "my-cluster",
"tags": [
{
"key":"tag_key",
"value":"tag_value"
}
],
"managedInstancesProvider": {
"infrastructureRoleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole",
"propagateTags": "CAPACITY_PROVIDER",
"instanceLaunchTemplate": {
"ec2InstanceProfileArn": "arn:aws:iam::123456789012:instance-profile/ecsInstanceProfile",
"networkConfiguration": {
"subnets": [
"subnet-abcdef01234567",
"subnet-bcdefa98765432"
],
"securityGroups": [
"sg-0123456789abcdef"
]
}
}
}
}
```
**catatan**
Saat Anda menambahkan tag baru ke penyedia kapasitas, tag yang baru ditambahkan tidak akan disebarkan ke instance yang ada tetapi akan disebarkan ke instance yang baru dibuat.
Pelanggan diizinkan untuk menambahkan tag langsung ke instans EC2, tetapi tag tersebut tidak menyebar kembali ke penyedia kapasitas
Anda juga dapat menandai atau menghapus tag penyedia kapasitas menggunakan [Menambahkan tag ke sumber daya yang ada (AWS CLI)](tag-resources-console.md#tag-resources-api-sdk) atau [Menambahkan tag ke sumber daya yang ada (konsol Amazon ECS)](tag-resources-console.md#adding-or-deleting-tags)
Untuk informasi selengkapnya tentang penyedia kapasitas Instans Terkelola Amazon ECS, lihat. [Penyedia kapasitas Instans Terkelola Amazon ECS](managed-instances-capacity-providers-concept.md)
# Menambahkan tag ke instans penampung Amazon EC2 untuk Amazon ECS
Anda dapat mengaitkan tag dengan instans penampung Amazon EC2 untuk Amazon ECS menggunakan salah satu metode berikut:
+ Metode 1 - Saat membuat instance container menggunakan Amazon EC2 API, CLI, atau konsol, tentukan tag dengan meneruskan data pengguna ke instance menggunakan parameter konfigurasi agen penampung. `ECS_CONTAINER_INSTANCE_TAGS` Ini membuat tag yang terkait dengan instance container di Amazon ECS saja, tag tersebut tidak dapat dicantumkan menggunakan Amazon EC2 API. Untuk informasi selengkapnya, lihat [Bootstrapping instance container Amazon ECS Linux untuk meneruskan data](bootstrap_container_instance.md).
**penting**
Jika Anda meluncurkan instance container menggunakan grup Amazon EC2 Auto Scaling, Anda harus menggunakan parameter konfigurasi agen ECS\$1CONTAINER\$1INSTANCE\$1TAGS untuk menambahkan tag. Hal ini disebabkan oleh cara tag ditambahkan ke instans Amazon EC2 yang diluncurkan menggunakan grup Auto Scaling.
Berikut ini adalah contoh skrip data pengguna yang mengaitkan tag dengan instance container Anda:
```
#!/bin/bash
cat <<'EOF' >> /etc/ecs/ecs.config
ECS_CLUSTER=MyCluster
ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}
EOF
```
+ Metode 2 — Saat Anda membuat instance container menggunakan Amazon EC2 API, CLI, atau konsol, tentukan tag terlebih dahulu menggunakan parameter tersebut. `TagSpecification.N` Kemudian, berikan data pengguna ke instance dengan menggunakan parameter konfigurasi agen kontainer`ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM`. Melakukannya menyebarkannya dari Amazon EC2 ke Amazon ECS.
Berikut ini adalah contoh skrip data pengguna yang menyebarkan tag yang terkait dengan instans Amazon EC2, dan mendaftarkan instance dengan cluster yang diberi nama. `MyCluster`
```
#!/bin/bash
cat <<'EOF' >> /etc/ecs/ecs.config
ECS_CLUSTER=MyCluster
ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM=ec2_instance
EOF
```
Untuk menyediakan akses agar tag instans penampung dapat disebarkan dari Amazon EC2 ke Amazon ECS, tambahkan izin berikut secara manual sebagai kebijakan sebaris ke peran IAM instans penampung Amazon ECS. Untuk informasi selengkapnya, lihat [Menambahkan dan Menghapus Kebijakan IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html).
+ `ec2:DescribeTags`
Berikut ini adalah contoh kebijakan yang digunakan untuk menambahkan izin ini.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ec2:DescribeTags"
],
"Resource": "*"
}
]
}
```
------
# Menambahkan tag ke instans kontainer eksternal untuk Amazon ECS
Anda dapat mengaitkan tag dengan instans penampung eksternal untuk Amazon ECS dengan menggunakan salah satu metode berikut.
+ Metode 1 — Sebelum menjalankan skrip instalasi untuk mendaftarkan instans eksternal Anda dengan cluster Anda, buat atau edit file konfigurasi agen penampung Amazon ECS di `/etc/ecs/ecs.config` dan tambahkan parameter konfigurasi agen `ECS_CONTAINER_INSTANCE_TAGS` penampung. Metode ini membuat tanda yang terkait dengan instans eksternal.
Berikut ini adalah contoh sintaks.
```
ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}
```
+ Metode 2 - Setelah instance eksternal Anda terdaftar ke cluster Anda, Anda dapat menggunakan Konsol Manajemen AWS untuk menambahkan tag. Untuk informasi selengkapnya, lihat [Menambahkan tag ke sumber daya yang ada (konsol Amazon ECS)](tag-resources-console.md#adding-or-deleting-tags).
# Laporan penggunaan Amazon ECS
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.
Data pengukuran dalam Laporan Biaya dan Penggunaan menunjukkan penggunaan di semua tugas Amazon ECS Anda. Data pengukuran meliputi penggunaan CPU sebagai `vCPU-Hours` dan penggunaan memori sebagai `GB-Hours` untuk setiap tugas yang dijalankan. Bagaimana data disajikan tergantung pada opsi komputasi tugas.
Untuk tugas yang menggunakan Fargate, `lineItem/Operation` kolom menunjukkan `FargateTask` dan Anda akan melihat biaya yang terkait dengan setiap tugas.
Untuk tugas yang menggunakan EC2, `lineItem/Operation` kolom ditampilkan `ECSTask-EC2` dan tugas tidak memiliki biaya langsung yang terkait dengannya. Data pengukuran yang ditampilkan dalam laporan, seperti penggunaan memori, mewakili total sumber daya yang dicadangkan tugas selama periode penagihan yang Anda tentukan. Anda dapat menggunakan data ini untuk menentukan biaya cluster instans Amazon EC2 yang mendasari Anda. Data biaya dan penggunaan untuk instans Amazon EC2 Anda tercantum secara terpisah di bawah layanan Amazon EC2.
Anda juga dapat menggunakan tag terkelola Amazon ECS untuk mengidentifikasi layanan atau klaster yang dimiliki setiap tugas. Untuk informasi selengkapnya, lihat [Gunakan tag untuk penagihan](ecs-using-tags.md#tag-resources-for-billing).
**penting**
Data pengukuran hanya dapat dilihat untuk tugas yang diluncurkan pada atau setelah 16 November 2018. Tugas yang diluncurkan sebelum tanggal ini tidak menampilkan data pengukuran.
Berikut ini adalah contoh dari beberapa bidang yang dapat Anda gunakan untuk mengurutkan data alokasi biaya di Cost Explorer.
+ Nama klaster
+ Nama layanan
+ Tanda sumber daya
+ Jenis peluncuran
+ Wilayah AWS
+ Jenis penggunaan
Untuk informasi selengkapnya tentang membuat Laporan AWS Biaya dan Penggunaan, lihat [Laporan AWS Biaya dan Penggunaan](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-reports-costusage.html) di *Panduan AWS Billing Pengguna*.
## Laporan Biaya dan Penggunaan Tingkat Tugas
AWS Cost Management dapat menyediakan data penggunaan CPU dan memori di AWS Cost and Usage Report untuk setiap tugas di Amazon ECS, termasuk tugas di Fargate dan tugas di EC2. Data ini disebut *Split Cost Allocation Data*. Anda dapat menggunakan data ini untuk menganalisis biaya dan penggunaan untuk aplikasi. Selain itu, Anda dapat membagi dan mengalokasikan biaya ke unit bisnis individu dan tim dengan tag alokasi biaya dan kategori biaya. Untuk informasi selengkapnya tentang *Data Alokasi Biaya* [Pisahkan, lihat Memahami data alokasi biaya terpisah](https://docs.aws.amazon.com/cur/latest/userguide/split-cost-allocation-data.html) di AWS Cost and Usage Report Panduan Pengguna.
Anda dapat ikut serta dalam *Data Alokasi Biaya Split* tingkat tugas untuk akun di. AWS Cost Management Console Jika Anda memiliki akun manajemen (pembayar), Anda dapat ikut serta dari akun pembayar untuk menerapkan konfigurasi ini ke setiap akun yang ditautkan.
Setelah Anda mengatur *Data Alokasi Biaya Split*, akan ada kolom tambahan di bawah **splitLineItem**header dalam laporan. Untuk informasi selengkapnya lihat [Membagi detail item baris](https://docs.aws.amazon.com/cur/latest/userguide/split-line-item-columns.html) di Panduan AWS Cost and Usage Report Pengguna
Untuk tugas di EC2, data ini membagi biaya instans EC2 berdasarkan penggunaan sumber daya atau reservasi dan sumber daya yang tersisa pada instans.
Berikut ini adalah prasyarat:
+ Setel parameter konfigurasi agen `ECS_DISABLE_METRICS` Amazon ECS ke`false`.
Saat pengaturan ini`false`, agen Amazon ECS mengirimkan metrik ke Amazon. CloudWatch Di Linux, pengaturan ini secara `false` default dan metrik dikirim ke CloudWatch. Di Windows, pengaturan ini secara `true` default, jadi Anda harus mengubah pengaturan `false` untuk mengirim metrik CloudWatch AWS Cost Management untuk digunakan. Untuk informasi selengkapnya tentang konfigurasi agen ECS, lihat[Konfigurasi agen kontainer Amazon ECS](ecs-agent-config.md).
+ Versi Docker minimum untuk metrik yang andal adalah Docker versi v20.10.13 dan yang lebih baru, yang disertakan dalam AMI 20220607 yang dioptimalkan Amazon ECS dan yang lebih baru.
Untuk menggunakan *Split Cost Allocation Data*, Anda harus membuat laporan, dan pilih **Split data alokasi biaya**. Untuk informasi selengkapnya, lihat [Membuat Laporan Biaya dan Penggunaan](https://docs.aws.amazon.com/cur/latest/userguide/cur-create.html) di Panduan AWS Cost and Usage Report Pengguna.
AWS Cost Management menghitung *Data Alokasi Biaya Split* dengan CPU tugas dan penggunaan memori. AWS Cost Management dapat menggunakan CPU tugas dan reservasi memori alih-alih penggunaan, jika penggunaan tidak tersedia. Jika Anda melihat CUR menggunakan reservasi, periksa apakah instance penampung Anda memenuhi prasyarat dan metrik penggunaan sumber daya tugas muncul. CloudWatch