Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Kasus penggunaan Resource Tagger di AMS Accelerate
Bagian ini mencantumkan tindakan yang umum dilakukan dengan Resource Tagger.
## Melihat tag yang diterapkan oleh Resource Tagger
Semua tag yang diterapkan oleh Resource Tagger memiliki key **prefix ams:rt**:. **Misalnya, definisi tag berikut menghasilkan tag dengan kunci **AMS: rt:sampleKey dan nilai sampleValue**.** Semua tag dengan awalan ini diperlakukan sebagai bagian dari Resource Tagger.
```
{
"Key": "sampleKey",
"Value": "sampleValue"
}
```
**penting**
Jika Anda secara manual membuat tag Anda sendiri dengan awalan **ams:rt:**, itu dianggap dikelola oleh Resource Tagger. Ini berarti bahwa jika sumber daya dikelola oleh Resource Tagger, tetapi profil konfigurasi tidak menunjukkan bahwa tag harus diterapkan, maka Resource Tagger menghapus tag yang ditambahkan secara manual. Jika Anda secara manual menandai sumber daya yang dikelola oleh Resource Tagger, jangan gunakan awalan **ams:rt:** untuk kunci tag.
## Menggunakan Resource Tagger untuk membuat tag
AMS Accelerate Resource Tagger adalah komponen yang digunakan di akun Anda selama orientasi AMS Accelerate. Resource Tagger memiliki seperangkat aturan yang dapat dikonfigurasi yang menentukan bagaimana sumber daya Anda harus ditandai, kemudian memberlakukan aturan tersebut, secara otomatis menambahkan dan menghapus tag pada sumber daya untuk memastikan mereka mematuhi aturan Anda.
Jika Anda ingin menggunakan Resource Tagger untuk menandai sumber daya Anda, lihat[Mempercepat Tagger Sumber Daya](acc-resource-tagger.md).
**Berikut ini adalah contoh cuplikan konfigurasi Resource Tagger yang menambahkan tag **ams:rt:ams-managed** dengan nilai true ke semua instance Amazon.** EC2 Tag **ams:rt:ams-managed** memilih Anda agar sumber daya Anda dipantau oleh AMS Accelerate.
```
{
"AWS::EC2::Instance": {
"SampleConfigurationBlock": {
"Enabled": true,
"Filter": {
"Platform": "*"
},
"Tags": [
{
"Key": "ams:rt:ams-managed",
"Value": "true"
}
]
}
}
}
```
**Awas**
Berhati-hatilah saat menentukan nama untuk konfigurasi baru Anda (`SampleConfigurationBlock`dalam contoh yang diberikan) karena Anda mungkin secara tidak sengaja mengganti konfigurasi yang dikelola AMS dengan nama yang sama.
## Mencegah Resource Tagger dari memodifikasi sumber daya
Resource Tagger dapat diatur ke mode read-only yang mencegahnya menambahkan atau menghapus tag apa pun pada sumber daya Anda. Ini berguna jika Anda ingin menyediakan mekanisme penandaan Anda sendiri.
Saat dalam mode hanya-baca, Resource Tagger masih memeriksa aturan penandaan yang ditentukan dalam profil konfigurasi terkelola dan pelanggan, dan memindai sumber daya yang tidak memenuhi aturan penandaan ini. Setiap sumber daya yang tidak sesuai akan muncul dengan. AWS Config Aturan AWS Config Yang bisa Anda cari memiliki `AMSResourceTagger-` awalan. Misalnya `AMSResourceTagger-EC2Instance` AWS Config aturan mengevaluasi jika tag yang sesuai dibuat untuk `AWS::EC2::Instance` sumber daya berdasarkan profil konfigurasi.
Resource Tagger berhenti pada titik ini, dan tidak membuat perubahan apa pun pada sumber daya Anda (tidak menambah atau menghapus tag).
**Anda dapat mengaktifkan mode hanya-baca dengan memodifikasi profil konfigurasi pelanggan untuk menyertakan **ReadOnly**kunci di blok Opsi.** Misalnya, cuplikan profil konfigurasi berikut menunjukkan tampilannya:
```
{
"Options": {
"ReadOnly": true
},
"AWS::EC2::Instance": {
[... the rest of your configuration ...]
}
}
```
Resource Tagger akan bereaksi terhadap konfigurasi baru ini segera setelah selesai digunakan, dan berhenti menambahkan dan menghapus tag pada sumber daya.
**catatan**
**Untuk mengaktifkan kembali modifikasi tag, ubah **ReadOnly**nilainya menjadi **false**, atau hapus kunci sama sekali, karena nilai defaultnya adalah false.**
Untuk selengkapnya tentang pengaturan **Opsi**, lihat[Sintaks dan struktur](acc-tag-tools-profiles.md#acc-rt-config-doc-format), selanjutnya.
## Contoh profil konfigurasi
Contoh dokumen profil berikut menetapkan bahwa semua EC2 instance Windows yang merupakan bagian dari CloudFormation tumpukan stack-\$1 dikelola oleh AMS Accelerate; namun, secara eksplisit mengecualikan instance tertentu dengan ID i-000000000000001. EC2
```
{
"AWS::EC2::Instance": {
"AMSMonitoringWindows": {
"Enabled": true,
"Filter": {
"Fn::AND": [
{
"Platform": "Windows"
},
{
"Tag": {
"Key": "aws:cloudformation:stack-name",
"Value": "stack-*"
}
},
{
"Fn::NOT": {
"InstanceId": "i-00000000000000001"
}
}
]
},
"Tags": [
{
"Key": "ams:rt:ams-managed",
"Value": "true"
}
]
}
}
}
```
**Awas**
Berhati-hatilah saat menentukan nama untuk konfigurasi baru Anda (`SampleConfigurationBlock`dalam contoh yang diberikan) karena Anda mungkin secara tidak sengaja mengganti konfigurasi yang dikelola AMS dengan nama yang sama.
## Menggabungkan konfigurasi default
Profil konfigurasi default disediakan oleh AMS Accelerate pada saat orientasi akun. Profil ini menyediakan aturan default yang diterapkan di akun Anda.
Meskipun Anda tidak dapat mengubah profil konfigurasi default, Anda dapat memberikan penggantian ke default dengan menentukan blok konfigurasi di profil konfigurasi kustomisasi Anda dengan ConfigurationId yang sama dengan blok **konfigurasi** default. Jika Anda melakukan ini, blok konfigurasi Anda akan menimpa blok konfigurasi default.
Misalnya, pertimbangkan dokumen konfigurasi default berikut:
```
{
"AWS::EC2::Instance": {
"AMSManagedBlock1": {
"Enabled": true,
"Filter": {
"Platform": "Windows"
},
"Tags": [{
"Key": "my-tag",
"Value": "SampleValueA"
}]
}
}
}
```
Untuk mengubah nilai tag yang diterapkan di sini dari `SampleValueA` ke`SampleValueB`, dan menerapkan tag ke semua instance, bukan hanya instance Windows, Anda akan memberikan profil konfigurasi penyesuaian berikut:
```
{
"AWS::EC2::Instance": {
"AMSManagedBlock1": {
"Enabled": true,
"Filter": {
"Platform": "*"
},
"Tags": [{
"Key": "my-tag",
"Value": "SampleValueB"
}]
}
}
}
```
**penting**
Ingatlah untuk menerapkan perubahan konfigurasi Anda setelah Anda membuatnya. Untuk informasi selengkapnya, lihat [Menerapkan perubahan konfigurasi](#acc-rt-deploy-changes). Di SSM AppConfig, Anda harus menerapkan versi konfigurasi baru setelah membuatnya.
## Menonaktifkan konfigurasi default
**Anda dapat menonaktifkan aturan konfigurasi default dengan menambahkan blok konfigurasi dengan **ConfigurationId** yang sama ke profil konfigurasi kustomisasi Anda dan memberikan bidang **Enabled** untuk nilai false.**
Misalnya, jika konfigurasi berikut ada di profil konfigurasi default:
```
{
"AWS::EC2::Instance": {
"AMSManagedBlock1": {
"Enabled": true,
"Filter": {
"Platform": "Windows"
},
"Tags": [{
"Key": "my-tag",
"Value": "SampleValueA"
}]
}
}
}
```
Anda dapat menonaktifkan aturan penandaan ini dengan memasukkan yang berikut dalam profil konfigurasi kustomisasi Anda:
```
{
"AWS::EC2::Instance": {
"AMSManagedBlock1": {
"Enabled": false
}
}
}
```
**penting**
Ingatlah untuk menerapkan perubahan konfigurasi setelah Anda membuatnya; untuk informasi, lihat[Menerapkan perubahan konfigurasi](#acc-rt-deploy-changes). Di SSM AppConfig, Anda harus menerapkan versi konfigurasi baru setelah membuatnya.
## Menghapus tag yang diterapkan oleh Resource Tagger
Tag apa pun yang diawali dengan **ams:rt** akan dihapus oleh Resource Tagger jika tag tidak ada di profil konfigurasi, atau, jika ada, di mana filter tidak cocok. Ini berarti Anda dapat menghapus tag yang diterapkan oleh Resource Tagger dengan melakukan salah satu hal berikut:
+ Memodifikasi bagian konfigurasi kustomisasi yang mendefinisikan tag.
+ Menambahkan pengecualian untuk sumber daya tertentu sehingga tidak lagi cocok dengan filter.
Misalnya: jika instance **Linux** memiliki tag berikut:
```
"Tags": [{
"Key": "ams:rt:MyOwnTag",
"Value": true
},{
"Key": "myTag",
"Value": true
}]
```
Dan Anda menerapkan profil konfigurasi Resource Tagger berikut:
```
{
"AWS::EC2::Instance": {
"AMSMonitoringWindows": {
"Enabled": true,
"Filter": {
"Platform": "Windows"
},
"Tags": [{
"Key": "ams:rt:ams-managed",
"Value": "true"
}]
}
}
}
```
Resource Tagger bereaksi terhadap perubahan konfigurasi baru, dan satu-satunya tag pada instance menjadi:
```
"Tags": [{
"Key": "myTag",
"Value": true
}]
```
**Awas**
Berhati-hatilah saat menentukan nama untuk konfigurasi baru Anda (`SampleConfigurationBlock`dalam contoh yang diberikan) karena Anda mungkin secara tidak sengaja mengganti konfigurasi yang dikelola AMS dengan nama yang sama.
**penting**
Ingatlah untuk menerapkan perubahan konfigurasi setelah Anda membuatnya; untuk informasi, lihat[Menerapkan perubahan konfigurasi](#acc-rt-deploy-changes). Di SSM AppConfig, Anda harus menerapkan versi konfigurasi baru setelah membuatnya.
## Melihat atau membuat perubahan pada konfigurasi Resource Tagger
Dua profil konfigurasi JSON, **AMSManagedTag** dan **CustomerManagedTags**, yang diterapkan ke akun Anda AppConfig di [AWS](https://docs.aws.amazon.com/appconfig/latest/userguide/what-is-appconfig.html) saat orientasi dan berada di aplikasi AMSResource Tagger, dan di **AMSInfrastructure**lingkungan, dapat ditinjau melalui API. AppConfig [GetConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_GetConfiguration.html)
Berikut ini adalah contoh dari GetConfiguration panggilan ini:
```
aws appconfig get-configuration
--application AMSResourceTagger
--environment AMSInfrastructure
--configuration AMSManagedTags
--client-id ANY_STRING
outfile.json
```
**Aplikasi**: unit AppConfig logis untuk menyediakan kemampuan, untuk Resource Tagger, ini adalah AMSResource Tagger.
+ **Lingkungan**: AMSInfrastructure.
+ **Konfigurasi**: Untuk melihat definisi tag default AMS Accelerate, nilainya adalah AMSManaged Tag, sedangkan untuk melihat definisi tag pelanggan, nilainya adalah CustomerManagedTags.
+ **ID Klien**: Pengidentifikasi contoh aplikasi unik, ini bisa berupa string apa pun.
+ Definisi tag kemudian dapat dilihat dalam file output yang ditentukan, dalam hal ini, outfile.json.
Definisi alarm kemudian dapat dilihat dalam file output yang ditentukan, dalam hal ini, outfile.json.
Anda dapat melihat versi konfigurasi mana yang digunakan ke akun Anda dengan melihat penerapan sebelumnya di lingkungan. **AMSInfrastructure**
****Untuk mengganti aturan tag:
Salah satu aturan tag yang ada dapat diganti dengan memperbarui profil penyesuaian baik dengan CloudFormation oleh [Menerapkan profil konfigurasi dengan CloudFormation untuk Accelerate](acc-tag-cf-ex-deploy-config.md) atau, atau langsung menggunakan API using AppConfig. [https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateHostedConfigurationVersion.html](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateHostedConfigurationVersion.html) Menggunakan **ConfigurationId** yang sama sebagai aturan tag konfigurasi default mengesampingkan aturan default, dan menerapkan aturan kustom sebagai gantinya.
Untuk menyebarkan perubahan yang dibuat pada **CustomerManagedTags**dokumen:
Setelah Anda membuat perubahan pada profil konfigurasi penyesuaian, Anda harus menerapkan perubahan untuk mereka. Untuk menerapkan perubahan baru, AppConfig [StartDeployment](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_StartDeployment.html)API harus dijalankan menggunakan AWS AppConfig Konsol atau CLI.
## Menerapkan perubahan konfigurasi
Setelah kustomisasi selesai, perubahan ini harus diterapkan melalui AWS AppConfig [ StartDeployment](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_StartDeployment.html)API. Petunjuk berikut menunjukkan cara menerapkan menggunakan. AWS CLI Selain itu, Anda dapat menggunakan Konsol Manajemen AWS untuk membuat perubahan ini. Untuk selengkapnya, lihat [Langkah 5: Menerapkan konfigurasi](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-deploying.html).
```
aws appconfig start-deployment
--application-id
--environment-id
--deployment-strategy-id
--configuration-profile-id
--configuration-version 1
```
+ **ID Aplikasi**: ID aplikasi AMSResource Tagger aplikasi. Dapatkan ini dengan panggilan [ ListApplications](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_ListApplications.html)API.
+ **ID Lingkungan**: ID lingkungan; dapatkan ini dengan panggilan [ ListEnvironments](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_ListEnvironments.html)API.
+ **ID Strategi Penerapan: ID** strategi penerapan; dapatkan ini dengan panggilan [ ListDeploymentStrategies](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_ListDeploymentStrategies.html)API.
+ **ID Profil Konfigurasi**: ID profil konfigurasi dari CustomerManagedTags; dapatkan ini dengan panggilan [ ListConfigurationProfiles](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_ListConfigurationProfiles.html)API.
+ **Versi Konfigurasi**: Versi profil konfigurasi yang ingin Anda gunakan.
**penting**
Resource Tagger menerapkan tag seperti yang ditentukan dalam profil konfigurasi. Setiap modifikasi manual yang Anda buat (dengan Konsol Manajemen AWS, atau CloudWatch CLI/SDK) ke tag sumber daya secara otomatis dikembalikan kembali, jadi pastikan perubahan Anda ditentukan melalui Resource Tagger. Untuk mengetahui tag mana yang dibuat oleh Resource Tagger, cari kunci tag yang diawali dengan. `ams:rt:`
Batasi akses ke penerapan dengan tindakan [StopDeployment](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_StopDeployment.html)API [StartDeployment](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_StartDeployment.html)dan pengguna tepercaya yang memahami tanggung jawab dan konsekuensi penerapan konfigurasi baru ke target Anda.
Untuk mempelajari lebih lanjut tentang cara menggunakan AWS AppConfig fitur untuk membuat dan menerapkan konfigurasi, lihat dokumentasi di [Bekerja dengan AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-working.html).
## Mengonfigurasi Terraform untuk mengabaikan tag Resource Tagger
Jika Anda menggunakan Terraform untuk menyediakan sumber daya Anda, dan Anda ingin menggunakan Resource Tagger untuk menandai sumber daya Anda, tag Resource Tagger dapat diidentifikasi sebagai drift oleh Terraform.
**Anda dapat mengonfigurasi Terraform untuk mengabaikan semua tag Resource Tagger menggunakan blok konfigurasi **siklus hidup**, atau blok konfigurasi global ignore\$1tags.** [Untuk informasi selengkapnya, lihat dokumentasi Terraform tentang Penandaan Sumber Daya di Penandaan Sumber Daya.](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/guides/resource-tagging)
Contoh berikut menunjukkan cara membuat konfigurasi global untuk mengabaikan semua tag yang dimulai dengan awalan `ams:rt:` tag Resource Tagger:
```
provider "aws" {
# ... potentially other configuration ...
ignore_tags {
key_prefixes = ["ams:rt:"]
}
}
```
## Melihat jumlah sumber daya yang dikelola oleh Resource Tagger
Resource Tagger mengirimkan metrik setiap jam ke Amazon CloudWatch, di namespace. `AMS/ResourceTagger` Metrik dipancarkan hanya untuk jenis sumber daya yang didukung oleh Resource Tagger.
| Nama Metrik | Dimensi | Deskripsi |
| --- | --- | --- |
| ResourceCount | Komponen, ResourceType | Jumlah sumber daya (dari jenis sumber daya yang ditentukan) yang digunakan di wilayah ini. Unit: Hitungan |
| ResourcesMissingManagedTags | Komponen, ResourceType | Jumlah sumber daya (dari jenis sumber daya tertentu) yang memerlukan tag terkelola, sesuai dengan profil konfigurasi, tetapi belum diberi tag oleh Resource Tagger. Unit: Hitungan |
| UnmanagedResources | Komponen, ResourceType | Jumlah sumber daya (dari jenis sumber daya yang ditentukan) tanpa tag terkelola yang diterapkan oleh Resource Tagger. Biasanya, sumber daya ini tidak cocok dengan blok konfigurasi Resource Tagger, atau secara eksplisit dikecualikan dari blok konfigurasi. Unit: Hitungan |
| MatchingResourceCount | Komponen, ResourceType, ConfigClauseName | Jumlah sumber daya (dari jenis sumber daya tertentu) yang cocok dengan blok konfigurasi Resource Tagger. Agar sumber daya cocok dengan blok konfigurasi, blok harus diaktifkan dan sumber daya harus cocok dengan filter blok. Unit: Hitungan |
**Metrik ini juga dapat dilihat sebagai grafik, di dasbor AMS-Resource-Tagger-Reporting-.** Untuk melihat dasbor, dari konsol CloudWatch manajemen Amazon, pilih **AMS-Resource-Tagger-Reporting-Dashboard**. Secara default, grafik di dasbor ini menampilkan data untuk periode 12 jam sebelumnya.
AMS Accelerate menyebarkan CloudWatch alarm ke akun Anda untuk mendeteksi peningkatan signifikan dalam jumlah sumber daya yang tidak dikelola, misalnya, sumber daya yang dikecualikan dari manajemen oleh AMS Resource Tagger. Operasi AMS akan menyelidiki peningkatan sumber daya yang tidak dikelola yang melebihi: baik tiga sumber daya dari jenis yang sama, atau peningkatan 50% atas semua sumber daya dari jenis yang sama. Jika perubahan tampaknya tidak disengaja, Operasi AMS dapat menghubungi Anda untuk meninjau perubahan tersebut.