Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Alat manajemen tag untuk Mempercepat **Daftar Isi** + [Mempercepat Tagger Sumber Daya](acc-resource-tagger.md) + [Menggunakan CloudFormation untuk membuat tag untuk AMS Accelerate](acc-tag-how-works-cfn.md) + [Menggunakan Terraform untuk membuat tag untuk AMS Accelerate](acc-tag-tools-terraform.md) # Mempercepat Tagger Sumber Daya Dengan Resource Tagger, Anda dapat menentukan aturan untuk mengatur cara AWS sumber daya ditandai di akun Anda. Saat melakukan onboarding akun, AMS Accelerate menerapkan kebijakan penandaan Anda untuk memastikan sumber daya dalam akun terkelola Anda diberi tag. **Contents** + [ ## Apa itu Resource Tagger? ](#acc-rt-what-is) + [ ## Bagaimana Resource Tagger bekerja ](#acc-rt-how-works) + [ # Profil Konfigurasi Resource Tagger di AMS Accelerate ](acc-tag-tools-profiles.md) + [ ## Sintaks dan struktur ](acc-tag-tools-profiles.md#acc-rt-config-doc-format) + [ # Kasus penggunaan Resource Tagger di AMS Accelerate ](acc-rt-using.md) + [ ## Melihat tag yang diterapkan oleh Resource Tagger ](acc-rt-using.md#acc-rt-using-view-tags) + [ ## Menggunakan Resource Tagger untuk membuat tag ](acc-rt-using.md#acc-tag-how-works-rt) + [ ## Mencegah Resource Tagger dari memodifikasi sumber daya ](acc-rt-using.md#acc-rt-preventing-rt-changes) + [ ## Contoh profil konfigurasi ](acc-rt-using.md#acc-rt-using-ex-config-doc) + [ ## Menggabungkan konfigurasi default ](acc-rt-using.md#acc-rt-using-merge-default-config) + [ ## Menonaktifkan konfigurasi default ](acc-rt-using.md#acc-rt-using-disable-default-config) + [ ## Menghapus tag yang diterapkan oleh Resource Tagger ](acc-rt-using.md#acc-rt-remove-tags) + [ ## Melihat atau membuat perubahan pada konfigurasi Resource Tagger ](acc-rt-using.md#acc-rt-make-changes) + [ ## Menerapkan perubahan konfigurasi ](acc-rt-using.md#acc-rt-deploy-changes) + [ ## Mengonfigurasi Terraform untuk mengabaikan tag Resource Tagger ](acc-rt-using.md#acc-rt-ignore-tags) + [ ## Melihat jumlah sumber daya yang dikelola oleh Resource Tagger ](acc-rt-using.md#acc-rt-number-of-resources) ## Apa itu Resource Tagger? Resource Tagger adalah layanan AMS Accelerate yang menawarkan Anda gunakan untuk menentukan aturan untuk mengatur cara AWS sumber daya ditandai di akun Anda. Ini bertujuan untuk memberi Anda visibilitas lengkap tentang bagaimana tag Anda diterapkan ke AWS sumber daya Anda. Resource Tagger secara otomatis membuat, memperbarui, dan menghapus tag pada AWS sumber daya yang didukung, berdasarkan aturan penandaan yang Anda tentukan di profil konfigurasi Anda. Misalnya, Anda dapat menentukan aturan yang menerapkan tag ke kumpulan EC2 instans Amazon, yang menunjukkan bahwa mereka harus dikelola oleh AMS Accelerate, yang mengakibatkan instans dipantau atau dicadangkan. Anda dapat menggunakan tag seperti ini untuk mengidentifikasi status kepatuhan AWS sumber daya berdasarkan kebijakan yang ditentukan di profil AWS AppConfig konfigurasi Anda. Untuk informasi selengkapnya, lihat [AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/what-is-appconfig.html). AMS Accelerate menyediakan konfigurasi penandaan terkelola default sehingga sumber daya Anda dapat dipantau oleh AMS Accelerate. Anda menentukan sumber daya mana yang harus dikelola oleh AMS Accelerate, dan aturan penandaan terkelola memastikan bahwa sumber daya yang memiliki tag yang sesuai dipantau oleh AMS Accelerate. Dengan Resource Tagger, jika Anda memilih, Anda dapat mengganti atau menonaktifkan tag terkelola AMS Accelerate default, memberikan aturan penandaan Anda sendiri untuk memenuhi kebijakan Anda, dan menggunakan mekanisme lain, seperti Terraform, untuk menghindari penyimpangan. Anda dapat menentukan pengecualian untuk skala, berdasarkan operasi Anda. Misalnya, Anda dapat menentukan kebijakan untuk menerapkan tag untuk semua EC2 instans Amazon dengan platform yang didukung (seperti Windows dan Linux), dan mengecualikan dari menandai instance tertentu. IDs **penting** Resource Tagger mengontrol semua tag di akun Anda yang memiliki awalan **ams:rt**:. Tag apa pun yang dimulai dengan awalan ini akan dihapus kecuali ada dalam aturan konfigurasi Resource Tagger. Untuk meringkas, tag apa pun pada sumber daya yang didukung yang dimulai dengan **ams:rt:** dianggap dimiliki oleh Resource Tagger. Jika Anda menandai sesuatu secara manual dengan, misalnya, **ams:rt:**, tag itu akan dihapus secara otomatis jika tidak ditentukan di salah satu profil konfigurasi Resource Tagger. ## Bagaimana Resource Tagger bekerja Saat akun Anda di-onboard ke AMS Accelerate, dua dokumen konfigurasi JSON akan di-deploy ke akun Anda. AWS AppConfig Dua dokumen, yang disebut *profil Konfigurasi*, adalah **AMSManagedTag**, disebut sebagai **profil konfigurasi default**, dan **CustomerManagedTags**, disebut sebagai **profil konfigurasi kustomisasi**. Anda menggunakan profil konfigurasi kustomisasi untuk menentukan kebijakan dan aturan Anda sendiri untuk akun Anda, dan itu tidak ditimpa oleh AMS Accelerate. Kedua profil berada di aplikasi **AMSResourceTagger**, dan di lingkungan. **AMSInfrastructure** Semua tag yang diterapkan oleh tagger sumber daya memiliki key **prefix** ams:rt:. **Profil konfigurasi kustomisasi**: Profil konfigurasi kustomisasi awalnya kosong pada saat orientasi akun; Namun, aturan apa pun yang ditempatkan dalam dokumen profil diberlakukan, selain aturan di profil konfigurasi default. Setiap konfigurasi dalam profil konfigurasi kustomisasi sepenuhnya dikelola oleh Anda, dan tidak ditimpa oleh AMS Accelerate, kecuali oleh permintaan Anda. Anda dapat menentukan aturan penandaan kustom yang Anda inginkan di profil konfigurasi kustom untuk AWS sumber daya yang didukung, dan Anda juga dapat menentukan modifikasi pada konfigurasi default AMS Accelerate-managed di sini, lihat. [Kasus penggunaan Resource Tagger di AMS Accelerate](acc-rt-using.md) **penting** Jika Anda memperbarui profil ini, Resource Tagger secara otomatis memberlakukan perubahan di semua sumber daya yang relevan di situs Anda. Akun AWS Perubahan diberlakukan secara otomatis, tetapi mungkin membutuhkan waktu hingga 60 menit untuk diterapkan. Anda dapat memperbarui profil ini dengan menggunakan Konsol Manajemen AWS, atau melalui alat AWS CLI/SDK. Untuk informasi tentang memperbarui profil konfigurasi kustomisasi, lihat panduan AWS AppConfig pengguna: [Apa itu AWS AppConfig?](https://docs.aws.amazon.com/appconfig/latest/userguide/what-is-appconfig.html) **Profil konfigurasi default**: Dokumen profil konfigurasi default adalah internal AMS Accelerate dan berisi aturan default yang disediakan AMS Accelerate yang tidak dapat Anda ubah atau hapus secara permanen. Profil ini dapat diperbarui kapan saja oleh AMS Accelerate dan tersedia bagi Anda untuk ditinjau; setiap perubahan yang Anda buat terhadapnya akan dihapus secara otomatis. Jika Anda ingin mengubah atau menonaktifkan salah satu aturan konfigurasi default yang Anda gunakan profil konfigurasi kustomisasi, lihat[Kasus penggunaan Resource Tagger di AMS Accelerate](acc-rt-using.md). # Profil Konfigurasi Resource Tagger di AMS Accelerate Profil konfigurasi membantu memastikan bahwa tag diterapkan secara seragam ke sumber daya sepanjang masa sumber daya. ## Sintaks dan struktur Profil konfigurasi adalah objek JSON dengan struktur berikut: ``` { "Options": { "ReadOnly": false }, "ResourceType": { "ConfigurationID": { "Enabled": true, "Filter": { ... }, "Tags": [ ... ] }, "ConfigurationID": { ... } }, "ResourceType": { ... } } ``` **Opsi**: (opsional) Tentukan opsi untuk bagaimana Anda ResourceTagger ingin berperilaku. Menghilangkan blok sama dengan mengatur semua opsi ke nilai defaultnya. Lihat di bawah untuk pengaturan **Opsi** yang tersedia: + **ReadOnly**: (opsional, default ke false): Menentukan ReadOnly mode untuk Resource Tagger. Setel ReadOnly ke true untuk menonaktifkan Resource Tagger yang membuat atau menghapus tag pada sumber daya AWS. Untuk informasi selengkapnya, lihat [Mencegah Resource Tagger dari memodifikasi sumber daya](acc-rt-using.md#acc-rt-preventing-rt-changes). **ResourceType**: Kunci ini harus berupa salah satu string yang didukung berikut, dan mewakili semua konfigurasi yang terkait dengan jenis sumber daya yang ditunjukkan: + AWS::AutoScaling::AutoScalingKelompok + AWS::DynamoDB::Table + AWS::EC2::Instance + AWS::EC2::NatGateway + AWS::EC2:: VPNConnection + AWS::EFS::FileSystem + AWS::EKS::Cluster + AWS::ElasticLoadBalancing::LoadBalancer + AWS::ElasticLoadBalancingV2::LoadBalancer + AWS::Elasticsearch::Domain + AWS::FSx::FileSystem + AWS::OpenSearch::Domain + AWS: :RDS:: DBCluster + AWS: :RDS:: DBInstance + AWS::Redshift::Cluster + AWS::S3::Bucket + AWS::Synthetics::Canary **ConfigurationId**: Kunci ini harus unik dalam dokumen profil, dan secara unik menamai blok konfigurasi berikut. Jika dua blok konfigurasi di blok yang sama memiliki **ConfigurationId** yang sama, **ResourceType**blok yang muncul terakhir di profil akan berlaku. Jika Anda menentukan **ConfigurationId** di profil penyesuaian Anda yang sama dengan yang ditentukan dalam dokumen default, blok konfigurasi yang ditentukan dalam profil penyesuaian akan berlaku. **penting** **ConfigurationId** **harus ***not***tumpang tindih dengan profil AMS Accelerate; misalnya, itu tidak boleh **AMSMonitoringLinux** atau **AMSMonitoringWindows**, jika tidak maka akan menonaktifkan konfigurasi masing-masing profil konfigurasi Tags. AMSManaged** **Diaktifkan** (opsional, default ke **true**): Menentukan apakah blok konfigurasi berlaku. Setel ini ke **false** untuk menonaktifkan blok konfigurasi. Blok konfigurasi yang dinonaktifkan tidak berpengaruh. **Filter**: Menentukan sumber daya yang konfigurasi berlaku. Setiap objek filter dapat memiliki salah satu (tetapi hanya satu) dari bidang berikut: + **AWS::AutoScaling::AutoScalingKelompok**: + **AutoScalingGroupName**: Nama Grup Autoscaling. Bidang ini mendukung pencocokan wildcard. + **AWS::DynamoDB::Table**: + **TableName**: Nama tabel DynamoDB. Bidang ini mendukung pencocokan wildcard. + **AWS::EC2::Instance**: + **AvailabilityZone**: Filter cocok dengan EC2 instance di zona ketersediaan yang ditentukan. Bidang ini mendukung pencocokan wildcard, jadi **\$1a cocok dengan us-east-1a**, ap-northeast-1a, dan sebagainya. + **InstanceId**: Filter cocok dengan EC2 instance ID yang ditentukan. **Bidang ini mendukung pencocokan wildcard, jadi **i-00000\$1** akan cocok dengan instance apa pun yang memiliki ID instance dimulai dengan i-00000.** + **Platform**: Filter mencocokkan EC2 instance dengan platform yang ditentukan. Nilai yang valid adalah **windows**, **linux** atau **wildcard\$1** (untuk mencocokkan platform apa pun). + **AWS::EC2::NatGateway**: + **NatGatewayId**: ID dari NAT Gateway. Bidang ini mendukung pencocokan wildcard. + **Status**: Status gateway NAT (tertunda \$1 gagal \$1 tersedia \$1 menghapus \$1 dihapus atau wildcard “\$1”) + **VpcId**: ID VPC tempat NAT Gateway berada. Bidang ini mendukung pencocokan wildcard. + **SubnetId**: ID Subnet di mana NAT Gateway berada. Bidang ini mendukung pencocokan wildcard + **AWS::EC2:: VPNConnection**: + **VpnConnectionId**: ID koneksi. Bidang ini mendukung pencocokan wildcard. + **AWS::EFS::FileSystem**: + **FileSystemId**: ID dari sistem file EFS. Bidang ini mendukung pencocokan wildcard. + **AWS::EKS::Cluster**: + **ClusterName**: Nama cluster. Bidang ini mendukung pencocokan wildcard. + **AWS::ElasticLoadBalancing::LoadBalancer (Classic Load Balancer**): + **LoadBalancerName**: LoadBalancer Nama. Bidang ini mendukung pencocokan wildcard. + **Skema**: Dapat berupa “menghadap internet”, “internal” atau wildcard “\$1”. + **VPCId**: VPCId Di mana loadbalancer digunakan, bisa menjadi wildcard “\$1”. + **AWS::ElasticLoadBalancingV2::LoadBalancer (Application Load Balancer (ALB**)): + **LoadBalancerArn**: Nama Sumber Daya LoadBalancer Amazon (ARN). + **DNSName**: DNSName Dari LoadBalancer. Bidang ini mendukung pencocokan wildcard. + **LoadBalancerName**: LoadBalancer Nama. Bidang ini mendukung pencocokan wildcard. + **AWS::Elasticsearch::Domain**: + **DomainId**: DomainId ElasticSearch Sumber daya. Bidang ini mendukung pencocokan wildcard. + **DomainName**: DomainName ElasticSearch Sumber daya. Bidang ini mendukung pencocokan wildcard. + **HasMasterNode**: Nilai Boolean benar atau salah. Cocokkan jika Domain memiliki node master khusus. + **HasKmsKey**Nilai boolean benar atau salah. Cocokkan jika Domain memiliki kunci KMS untuk enkripsi saat istirahat. + **AWS::FSx::FileSystem**: + **FileSystemId**: ID dari sistem FSx file. Bidang ini mendukung pencocokan wildcard. + **AWS::OpenSearch::Domain**: + **DomainId**: DomainId OpenSearch Sumber daya. Bidang ini mendukung pencocokan wildcard. + **DomainName**: DomainName OpenSearch Sumber daya. Bidang ini mendukung pencocokan wildcard. + **HasMasterNode**: Boolean; Jika Domain memiliki node master khusus, ini dapat diatur ke true. + **HasKmsKey**: Jika Domain memiliki kunci KMS untuk enkripsi saat istirahat, ini dapat diatur ke true. + **AWS: :RDS::: DBCluster** + **DBClusterIdentifier**: Filter mencocokkan pengidentifikasi cluster RDS dengan pengenal yang ditentukan. Bidang ini tidak mendukung pencocokan wildcard, jadi pengidentifikasi cluster harus ditentukan. + **Mesin**: Mesin yang digunakan oleh Instans RDS. Bidang ini mendukung pencocokan wildcard. + **EngineVersion**: Versi mesin. Bidang ini mendukung pencocokan wildcard. + **AWS: :RDS::: DBInstance** + **DBInstanceIdentifier**: Filter cocok dengan instance RDS dengan ID instance yang ditentukan. Bidang ini tidak mendukung pencocokan wildcard, jadi pengidentifikasi instance harus ditentukan. + **Mesin**: Mesin yang digunakan oleh Instans RDS. Bidang ini mendukung pencocokan wildcard. + **EngineVersion**: Versi mesin. Bidang ini mendukung pencocokan wildcard. + **AWS::Redshift::Cluster**: + **ClusterIdentifier**: Pengidentifikasi Cluster. Bidang ini mendukung pencocokan wildcard. + **AWS::S3::Bucket**: + **BucketName**: Nama ember S3. Bidang ini mendukung pencocokan wildcard. + **AWS::Synthetics::Canary**: + **CanaryName**: Nama kenari Synthetics. **Properti Filter lainnya:** + **Tag**: Filter berlaku untuk sumber daya apa pun yang sudah memiliki tag yang diberikan diterapkan. Nilai untuk properti ini harus berupa objek JSON dengan bidang berikut: + **Key**: Harus berupa string yang tepat, dan menentukan bahwa sumber daya harus memiliki tag dengan kunci yang tepat. + **Nilai**: Menentukan nilai yang cocok untuk tag. Mendukung wildcard, sehingga nilai **Sample** cocok dengan nilai apa pun yang diakhiri dengan string **Sample**. + **Fn: :AND**: Sebuah array JSON dari objek JSON. Setiap objek mengikuti aturan yang sama dengan blok konfigurasi **Filter**. Ini menentukan bahwa filter cocok dengan sumber daya apa pun yang cocok dengan semua sub-filter. + **Fn: :OR**: Sebuah array JSON dari objek JSON. Setiap objek mengikuti aturan yang sama dengan blok konfigurasi **Filter**. Ini menentukan bahwa filter cocok dengan sumber daya apa pun yang cocok dengan salah satu sub-filter. + **Fn: :NOT**: Objek JSON yang mengikuti aturan yang sama dengan blok konfigurasi **Filter**. Ini menentukan bahwa filter secara eksplisit tidak cocok dengan sumber daya apa pun yang cocok dengan sub-filter. Gunakan ini untuk menentukan pengecualian pada aturan penandaan Anda. **Tag**: Tag yang akan diterapkan ke sumber daya yang cocok. (Lihat [Konvensi penamaan dan penggunaan tag](https://docs.aws.amazon.com/mediaconnect/latest/ug/tagging-restrictions.html).) Bidang ini adalah array pasangan kunci-nilai: + **Kunci**: Kunci tag yang akan diterapkan. + **Nilai**: Nilai tag yang akan diterapkan. **catatan** Tag yang diterapkan oleh Resource Tagger selalu memiliki kunci yang dimulai dengan **ams:rt**:. Jika Anda tidak menentukan awalan ini di profil Anda, Resource Tagger menyisipkannya untuk Anda. Ini adalah bagaimana Resource Tagger membedakan tag yang dimilikinya dan dikelola dari tag yang digunakan oleh alat lain untuk tujuan lain. # 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. # Menggunakan CloudFormation untuk membuat tag untuk AMS Accelerate Anda dapat menggunakan CloudFormation untuk menerapkan tag di tingkat tumpukan (lihat CloudFormation dokumentasi, [tag sumber daya](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html)) atau di tingkat sumber daya individual (misalnya, lihat [Menandai EC2 sumber daya Amazon Anda](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html)). **penting** Beberapa komponen layanan AMS Accelerate memerlukan tag dengan awalan **ams:rt**:. Resource Tagger percaya bahwa ia memiliki tag ini, dan akan menghapusnya jika tidak ada aturan konfigurasi Resource Tagger yang mengizinkannya. Anda selalu perlu menerapkan profil konfigurasi Resource Tagger untuk tag ini, bahkan jika Anda menggunakan CloudFormation atau Terraform. # CloudFormation Kasus penggunaan untuk AMS Accelerate Bagian ini mencantumkan tindakan yang umum dilakukan dengan CloudFormation. **Topics** + [ # Menandai EC2 instance dengan CloudFormation Accelerate ](acc-tag-cf-ex-tag-ec2.md) + [ # Menandai AutoScaling Grup (ASG) dengan CloudFormation for Accelerate ](acc-tag-cf-ex-tag-asg.md) + [ # Menerapkan profil konfigurasi dengan CloudFormation untuk Accelerate ](acc-tag-cf-ex-deploy-config.md) # Menandai EC2 instance dengan CloudFormation Accelerate Berikut ini adalah contoh bagaimana Anda dapat menerapkan tag **ams:rt:ams-managed** dengan nilai true **ke** instance Amazon yang dikelola oleh. EC2 CloudFormation Tag **ams:rt:ams-managed** memilih Anda agar sumber daya Anda dipantau oleh AMS Accelerate. ``` Type: AWS::EC2::Instance Properties: InstanceType: "t3.micro" # ...other properties... Tags: - Key: "ams:rt:ams-managed" Value: "true" ``` # Menandai AutoScaling Grup (ASG) dengan CloudFormation for Accelerate Berikut ini adalah contoh bagaimana Anda dapat menerapkan tag **ams:rt:ams-managed** dengan nilai true ke grup Auto Scaling **yang** dikelola oleh. CloudFormation Perhatikan bahwa grup Auto Scaling akan menyebarkan tag ke EC2 instans Amazon yang dibuat olehnya. Tag **ams:rt:ams-managed** memilih Anda agar sumber daya Anda dipantau oleh AMS Accelerate. ``` Type: AWS::AutoScaling::AutoScalingGroup Properties: AutoScalingGroupName: "SampleASG" # ...other properties... Tags: - Key: "ams:rt:ams-managed" Value: "true" ``` # Menerapkan profil konfigurasi dengan CloudFormation untuk Accelerate Jika Anda ingin menerapkan profil `CustomerManagedTags` konfigurasi Anda menggunakan CloudFormation, Anda dapat menggunakan CloudFormation template berikut. Letakkan konfigurasi JSON yang Anda inginkan di `AMSResourceTaggerConfigurationVersion.Content` lapangan. Saat Anda menerapkan template dalam CloudFormation Stack atau Stack Set, penyebaran `AMSResourceTaggerDeployment ` sumber daya akan gagal jika Anda belum mengikuti format JSON yang diperlukan untuk konfigurasi. Lihat [Sintaks dan struktur](acc-tag-tools-profiles.md#acc-rt-config-doc-format) untuk detail tentang format yang diharapkan. Untuk bantuan dalam menerapkan template ini sebagai kumpulan CloudFormation tumpukan atau tumpukan, lihat AWS CloudFormation dokumentasi yang relevan di bawah ini: + [Membuat tumpukan di AWS CloudFormation konsol](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) + [Membuat tumpukan dengan AWS CLI](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-cli-creating-stack.html) + [Membuat set tumpukan](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-getting-started-create.html) **catatan** Jika Anda menerapkan versi konfigurasi menggunakan salah satu templat ini, dan kemudian menghapus kumpulan CloudFormation tumpukan/tumpukan, versi konfigurasi templat akan tetap sebagai versi yang diterapkan saat ini, dan tidak ada penerapan tambahan yang akan dilakukan. Jika Anda ingin kembali ke konfigurasi default, Anda perlu menerapkan konfigurasi kosong secara manual (yaitu, hanya`{}`), atau memperbarui tumpukan Anda ke konfigurasi kosong, daripada menghapus tumpukan. **JSON** ``` { "Description": "Custom configuration for the AMS Resource Tagger.", "Resources": { "AMSResourceTaggerConfigurationVersion": { "Type": "AWS::AppConfig::HostedConfigurationVersion", "Properties": { "ApplicationId": { "Fn::ImportValue": "AMS-ResourceTagger-Configuration-ApplicationId" }, "ConfigurationProfileId": { "Fn::ImportValue": "AMS-ResourceTagger-Configuration-CustomerManagedTags-ProfileID" }, "Content": "{\"Options\": {\"ReadOnly\": false}}", "ContentType": "application/json" } }, "AMSResourceTaggerDeployment": { "Type": "AWS::AppConfig::Deployment", "Properties": { "ApplicationId": { "Fn::ImportValue": "AMS-ResourceTagger-Configuration-ApplicationId" }, "ConfigurationProfileId": { "Fn::ImportValue": "AMS-ResourceTagger-Configuration-CustomerManagedTags-ProfileID" }, "ConfigurationVersion": { "Ref": "AMSResourceTaggerConfigurationVersion" }, "DeploymentStrategyId": { "Fn::ImportValue": "AMS-ResourceTagger-Configuration-Deployment-StrategyID" }, "EnvironmentId": { "Fn::ImportValue": "AMS-ResourceTagger-Configuration-EnvironmentId" } } } } } ``` **YAML** ``` Description: Custom configuration for the AMS Resource Tagger. Resources: AMSResourceTaggerConfigurationVersion: Type: AWS::AppConfig::HostedConfigurationVersion Properties: ApplicationId: !ImportValue AMS-ResourceTagger-Configuration-ApplicationId ConfigurationProfileId: !ImportValue AMS-ResourceTagger-Configuration-CustomerManagedTags-ProfileID Content: | { "Options": { "ReadOnly": false } } ContentType: application/json AMSResourceTaggerDeployment: Type: AWS::AppConfig::Deployment Properties: ApplicationId: !ImportValue AMS-ResourceTagger-Configuration-ApplicationId ConfigurationProfileId: !ImportValue AMS-ResourceTagger-Configuration-CustomerManagedTags-ProfileID ConfigurationVersion: !Ref AMSResourceTaggerConfigurationVersion DeploymentStrategyId: !ImportValue AMS-ResourceTagger-Configuration-Deployment-StrategyID EnvironmentId: !ImportValue AMS-ResourceTagger-Configuration-EnvironmentId ``` # Menggunakan Terraform untuk membuat tag untuk AMS Accelerate Jika Anda tidak ingin menggunakan AMS Accelerate Resource Tagger, Anda dapat menerapkan tag Anda sendiri menggunakan Terraform. Namun, jika Anda tidak ingin menggunakan Resource Tagger karena penyimpangan dari definisi Terraform Anda, ada cara bagi Anda untuk menggunakan Resource Tagger dan mengabaikan penyimpangan yang ditimbulkannya; lihat. [Mengonfigurasi Terraform untuk mengabaikan tag Resource Tagger](acc-rt-using.md#acc-rt-ignore-tags) **penting** Beberapa komponen layanan AMS Accelerate memerlukan tag dengan awalan **ams:rt**:. Resource Tagger percaya bahwa ia memiliki tag ini, dan menghapusnya jika tidak ada aturan konfigurasi Resource Tagger yang mengizinkannya. Anda harus menerapkan profil konfigurasi Resource Tagger untuk tag ini, bahkan jika Anda menggunakan CloudFormation atau Terraform. Berikut ini adalah contoh bagaimana Anda dapat menerapkan tag **ams:rt:ams-managed dengan nilai true **ke** instance Amazon yang dikelola** oleh Terraform. EC2 Tag **ams:rt:ams-managed** memilih Anda agar sumber daya Anda dipantau oleh AMS Accelerate. ``` resource "aws_instance" "sample_linux_instance" { # ...ami and other properties... instance_type = "t3.micro" tags = { "ams:rt:ams-managed" = "true" } } ``` **Berikut ini adalah contoh bagaimana Anda dapat menerapkan tag **ams:rt:ams-managed dengan nilai true ke grup Auto Scaling yang dikelola** oleh Terraform.** Perhatikan bahwa grup Auto Scaling menyebarkan tag ke EC2 instans Amazon yang dibuat olehnya. Tag **ams:rt:ams-managed** memilih Anda agar sumber daya Anda dipantau oleh AMS Accelerate. ``` resource "aws_autoscaling_group" "sample_asg" { # ...other properties... name = "terraform-sample" tags = { "ams:rt:ams-managed" = "true" } } ``` Untuk deskripsi tentang cara mengelola tag sumber daya yang dibuat Terraform, lihat. [Mengonfigurasi Terraform untuk mengabaikan tag Resource Tagger](acc-rt-using.md#acc-rt-ignore-tags)