Ada lebih banyak contoh AWS SDK yang tersedia di repo Contoh [SDK AWS Doc](https://github.com/awsdocs/aws-doc-sdk-examples). GitHub Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Contoh kode untuk Resource Groups Tagging API menggunakan AWS SDKs Contoh kode berikut menunjukkan cara menggunakan AWS Resource Groups Tagging API kit pengembangan AWS perangkat lunak (SDK). *Tindakan* merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait. **Sumber daya lainnya** + **[Panduan Pengguna API Penandaan Resource Groups](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html)** — Informasi lebih lanjut tentang Resource Groups Tagging API. + **[Referensi API Penandaan Resource Groups](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html)** — Detail tentang semua tindakan API Penandaan Resource Groups yang tersedia. + **[AWS Pusat Pengembang](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23)** - Contoh kode yang dapat Anda filter berdasarkan kategori atau pencarian teks lengkap. + **[AWS Contoh SDK](https://github.com/awsdocs/aws-doc-sdk-examples)** — GitHub repo dengan kode lengkap dalam bahasa pilihan. Termasuk instruksi untuk mengatur dan menjalankan kode. **Contents** + [Hal-hal mendasar](resource-groups-tagging-api_code_examples_basics.md) + [Tindakan](resource-groups-tagging-api_code_examples_actions.md) + [`GetResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetResources_section.md) + [`GetTagKeys`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetTagKeys_section.md) + [`GetTagValues`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetTagValues_section.md) + [`TagResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_TagResources_section.md) + [`UntagResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_UntagResources_section.md) # Contoh dasar untuk Resource Groups Tagging API menggunakan AWS SDKs Contoh kode berikut menunjukkan cara menggunakan dasar-dasar AWS Resource Groups Tagging API dengan AWS SDKs. **Contents** + [Tindakan](resource-groups-tagging-api_code_examples_actions.md) + [`GetResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetResources_section.md) + [`GetTagKeys`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetTagKeys_section.md) + [`GetTagValues`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetTagValues_section.md) + [`TagResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_TagResources_section.md) + [`UntagResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_UntagResources_section.md) # Tindakan untuk Resource Groups Tagging API menggunakan AWS SDKs Contoh kode berikut menunjukkan cara melakukan tindakan API Tagging Resource Groups individual dengan AWS SDKs. Setiap contoh menyertakan tautan ke GitHub, di mana Anda dapat menemukan instruksi untuk mengatur dan menjalankan kode. Contoh berikut hanya mencakup tindakan yang paling umum digunakan. Untuk daftar lengkapnya, lihat [Referensi AWS Resource Groups Tagging API API](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html). **Topics** + [`GetResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetResources_section.md) + [`GetTagKeys`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetTagKeys_section.md) + [`GetTagValues`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetTagValues_section.md) + [`TagResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_TagResources_section.md) + [`UntagResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_UntagResources_section.md) # Gunakan `GetResources` dengan CLI Contoh kode berikut menunjukkan cara menggunakan`GetResources`. ------ #### [ CLI ] **AWS CLI** **Untuk mendapatkan daftar sumber daya yang ditandai** `get-resources`Contoh berikut menampilkan daftar sumber daya di akun yang ditandai dengan nama kunci dan nilai yang ditentukan. ``` aws resourcegroupstaggingapi get-resources \ --tag-filters Key=Environment,Values=Production \ --tags-per-page 100 ``` Output: ``` { "ResourceTagMappingList": [ { "ResourceARN": " arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0", "Tags": [ { "Key": "Environment", "Value": "Production" } ] } ] } ``` Untuk informasi selengkapnya, lihat [GetResources](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html)di *Referensi API Penandaan Resource Groups*. + Untuk detail API, lihat [GetResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-resources.html)di *Referensi AWS CLI Perintah*. ------ #### [ PowerShell ] **Alat untuk PowerShell V4** **Contoh 1: Mengembalikan semua sumber daya yang ditandai di wilayah dan kunci tag yang terkait dengan sumber daya. Jika tidak ada parameter -Region yang diberikan ke cmdlet, ia akan mencoba menyimpulkan wilayah dari metadata instance shell atau EC2.** ``` Get-RGTResource ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version} arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag} ``` **Contoh 2: Mengembalikan semua sumber daya yang ditandai dari jenis yang ditentukan di suatu wilayah. String untuk setiap nama layanan dan jenis sumber daya sama dengan yang disematkan di Amazon Resource Name (ARN) sumber daya.** ``` Get-RGTResource -ResourceType "s3" ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag} ``` **Contoh 3: Mengembalikan semua sumber daya yang ditandai dari jenis yang ditentukan di suatu wilayah. Perhatikan bahwa ketika jenis sumber daya disalurkan ke cmdlet, satu panggilan ke layanan dibuat untuk setiap jenis sumber daya yang disediakan.** ``` "dynamodb","s3" | Get-RGTResource ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version} arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag} ``` **Contoh 4: Mengembalikan semua sumber daya yang ditandai yang cocok dengan filter yang ditentukan.** ``` Get-RGTResource -TagFilter @{ Key="stage" } ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag} ``` **Contoh 5: Mengembalikan semua sumber daya yang ditandai yang cocok dengan filter dan jenis sumber daya yang ditentukan.** ``` Get-RGTResource -TagFilter @{ Key="stage" } -ResourceType "dynamodb" ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version} ``` **Contoh 6: Mengembalikan semua sumber daya yang ditandai yang cocok dengan filter yang ditentukan.** ``` Get-RGTResource -TagFilter @{ Key="stage"; Values=@("beta","gamma") } ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version} ``` + Untuk detail API, lihat [GetResources](https://docs.aws.amazon.com/powershell/v4/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V4)*. **Alat untuk PowerShell V5** **Contoh 1: Mengembalikan semua sumber daya yang ditandai di wilayah dan kunci tag yang terkait dengan sumber daya. Jika tidak ada parameter -Region yang diberikan ke cmdlet, ia akan mencoba menyimpulkan wilayah dari metadata instance shell atau EC2.** ``` Get-RGTResource ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version} arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag} ``` **Contoh 2: Mengembalikan semua sumber daya yang ditandai dari jenis yang ditentukan di suatu wilayah. String untuk setiap nama layanan dan jenis sumber daya sama dengan yang disematkan di Amazon Resource Name (ARN) sumber daya.** ``` Get-RGTResource -ResourceType "s3" ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag} ``` **Contoh 3: Mengembalikan semua sumber daya yang ditandai dari jenis yang ditentukan di suatu wilayah. Perhatikan bahwa ketika jenis sumber daya disalurkan ke cmdlet, satu panggilan ke layanan dibuat untuk setiap jenis sumber daya yang disediakan.** ``` "dynamodb","s3" | Get-RGTResource ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version} arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag} ``` **Contoh 4: Mengembalikan semua sumber daya yang ditandai yang cocok dengan filter yang ditentukan.** ``` Get-RGTResource -TagFilter @{ Key="stage" } ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag} ``` **Contoh 5: Mengembalikan semua sumber daya yang ditandai yang cocok dengan filter dan jenis sumber daya yang ditentukan.** ``` Get-RGTResource -TagFilter @{ Key="stage" } -ResourceType "dynamodb" ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version} ``` **Contoh 6: Mengembalikan semua sumber daya yang ditandai yang cocok dengan filter yang ditentukan.** ``` Get-RGTResource -TagFilter @{ Key="stage"; Values=@("beta","gamma") } ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version} ``` + Untuk detail API, lihat [GetResources](https://docs.aws.amazon.com/powershell/v5/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V5)*. ------ # Gunakan `GetTagKeys` dengan CLI Contoh kode berikut menunjukkan cara menggunakan`GetTagKeys`. ------ #### [ CLI ] **AWS CLI** **Untuk mendapatkan daftar semua kunci tag** `get-tag-keys`Contoh berikut mengambil daftar semua nama kunci tag yang digunakan oleh sumber daya di akun. ``` aws resourcegroupstaggingapi get-tag-keys ``` Output: ``` { "TagKeys": [ "Environment", "CostCenter", "Department" ] } ``` Untuk informasi selengkapnya, lihat [GetTagKeys](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetTagKeys.html)di *Referensi API Penandaan Resource Groups*. + Untuk detail API, lihat [GetTagKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-tag-keys.html)di *Referensi AWS CLI Perintah*. ------ #### [ PowerShell ] **Alat untuk PowerShell V4** **Contoh 1: Mengembalikan semua kunci tag di wilayah tertentu. Jika parameter -Region tidak ditentukan, cmdlet akan mencoba menyimpulkan wilayah dari wilayah shell default atau metadata instans EC2. Perhatikan bahwa kunci tag tidak dikembalikan dalam urutan tertentu.** ``` Get-RGTTagKey -region us-west-2 ``` **Output:** ``` version stage ``` + Untuk detail API, lihat [GetTagKeys](https://docs.aws.amazon.com/powershell/v4/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V4)*. **Alat untuk PowerShell V5** **Contoh 1: Mengembalikan semua kunci tag di wilayah tertentu. Jika parameter -Region tidak ditentukan, cmdlet akan mencoba menyimpulkan wilayah dari wilayah shell default atau metadata instans EC2. Perhatikan bahwa kunci tag tidak dikembalikan dalam urutan tertentu.** ``` Get-RGTTagKey -region us-west-2 ``` **Output:** ``` version stage ``` + Untuk detail API, lihat [GetTagKeys](https://docs.aws.amazon.com/powershell/v5/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V5)*. ------ # Gunakan `GetTagValues` dengan CLI Contoh kode berikut menunjukkan cara menggunakan`GetTagValues`. ------ #### [ CLI ] **AWS CLI** **Untuk mendapatkan daftar semua nilai tag** `get-tag-values`Contoh berikut menampilkan semua nilai yang digunakan untuk kunci yang ditentukan untuk semua sumber daya di ``` aws resourcegroupstaggingapi get-tag-values \ --key=Environment ``` Output: ``` { "TagValues": [ "Alpha", "Gamma", "Production" ] } ``` Untuk informasi selengkapnya, lihat [GetTagValues](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetTagValues.html)di *Referensi API Penandaan Resource Groups*. + Untuk detail API, lihat [GetTagValues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-tag-values.html)di *Referensi AWS CLI Perintah*. ------ #### [ PowerShell ] **Alat untuk PowerShell V4** **Contoh 1: Mengembalikan nilai untuk tag tertentu di wilayah. Jika parameter -Region tidak ditentukan, cmdlet akan mencoba menyimpulkan wilayah dari wilayah shell default atau metadata instans EC2.** ``` Get-RGTTagValue -Key "stage" -Region us-west-2 ``` **Output:** ``` beta ``` + Untuk detail API, lihat [GetTagValues](https://docs.aws.amazon.com/powershell/v4/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V4)*. **Alat untuk PowerShell V5** **Contoh 1: Mengembalikan nilai untuk tag tertentu di wilayah. Jika parameter -Region tidak ditentukan, cmdlet akan mencoba menyimpulkan wilayah dari wilayah shell default atau metadata instans EC2.** ``` Get-RGTTagValue -Key "stage" -Region us-west-2 ``` **Output:** ``` beta ``` + Untuk detail API, lihat [GetTagValues](https://docs.aws.amazon.com/powershell/v5/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V5)*. ------ # Gunakan `TagResources` dengan CLI Contoh kode berikut menunjukkan cara menggunakan`TagResources`. ------ #### [ CLI ] **AWS CLI** **Untuk melampirkan tag ke sumber daya** `tag-resources`Contoh berikut menandai sumber daya yang ditentukan dengan nama kunci dan nilai. ``` aws resourcegroupstaggingapi tag-resources \ --resource-arn-list arn:aws:s3:::MyProductionBucket \ --tags Environment=Production,CostCenter=1234 ``` Output: ``` { "FailedResourcesMap": {} } ``` Untuk informasi selengkapnya, lihat [TagResources](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_TagResources.html)di *Referensi API Penandaan Resource Groups*. + Untuk detail API, lihat [TagResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/tag-resources.html)di *Referensi AWS CLI Perintah*. ------ #### [ PowerShell ] **Alat untuk PowerShell V4** **Contoh 1: Contoh ini menambahkan kunci tag “stage” dan “version” dengan nilai “beta” dan “preprod\$1test” ke bucket Amazon S3 dan tabel Amazon DynamoDB. Satu panggilan dilakukan ke layanan untuk menerapkan tag.** ``` $arn1 = "arn:aws:s3:::amzn-s3-demo-bucket" $arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable" Add-RGTResourceTag -ResourceARNList $arn1,$arn2 -Tag @{ "stage"="beta"; "version"="preprod_test" } ``` **Contoh 2: Contoh ini menambahkan tag dan nilai yang ditentukan ke bucket Amazon S3 dan tabel Amazon DynamoDB. Dua panggilan dilakukan ke layanan, satu untuk setiap sumber daya ARN disalurkan ke cmdlet.** ``` $arn1 = "arn:aws:s3:::amzn-s3-demo-bucket" $arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable" $arn1,$arn2 | Add-RGTResourceTag -Tag @{ "stage"="beta"; "version"="preprod_test" } ``` + Untuk detail API, lihat [TagResources](https://docs.aws.amazon.com/powershell/v4/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V4)*. **Alat untuk PowerShell V5** **Contoh 1: Contoh ini menambahkan kunci tag “stage” dan “version” dengan nilai “beta” dan “preprod\$1test” ke bucket Amazon S3 dan tabel Amazon DynamoDB. Satu panggilan dilakukan ke layanan untuk menerapkan tag.** ``` $arn1 = "arn:aws:s3:::amzn-s3-demo-bucket" $arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable" Add-RGTResourceTag -ResourceARNList $arn1,$arn2 -Tag @{ "stage"="beta"; "version"="preprod_test" } ``` **Contoh 2: Contoh ini menambahkan tag dan nilai yang ditentukan ke bucket Amazon S3 dan tabel Amazon DynamoDB. Dua panggilan dilakukan ke layanan, satu untuk setiap sumber daya ARN disalurkan ke cmdlet.** ``` $arn1 = "arn:aws:s3:::amzn-s3-demo-bucket" $arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable" $arn1,$arn2 | Add-RGTResourceTag -Tag @{ "stage"="beta"; "version"="preprod_test" } ``` + Untuk detail API, lihat [TagResources](https://docs.aws.amazon.com/powershell/v5/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V5)*. ------ # Gunakan `UntagResources` dengan CLI Contoh kode berikut menunjukkan cara menggunakan`UntagResources`. ------ #### [ CLI ] **AWS CLI** **Untuk menghapus tag dari sumber daya** `untag-resources`Contoh berikut menghapus kunci tag yang ditentukan dan nilai terkait dari sumber daya yang ditentukan. ``` aws resourcegroupstaggingapi untag-resources \ --resource-arn-list arn:aws:s3:::amzn-s3-demo-bucket \ --tag-keys Environment CostCenter ``` Output: ``` { "FailedResourcesMap": {} } ``` Untuk informasi selengkapnya, lihat [UntagResources](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_UntagResources.html)di *Referensi API Penandaan Resource Groups*. + Untuk detail API, lihat [UntagResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/untag-resources.html)di *Referensi AWS CLI Perintah*. ------ #### [ PowerShell ] **Alat untuk PowerShell V4** **Contoh 1: Menghapus kunci tag “stage” dan “version”, dan nilai terkait, dari bucket Amazon S3 dan tabel Amazon DynamoDB. Satu panggilan dilakukan ke layanan untuk menghapus tag. Sebelum tag dihapus, cmdlet akan meminta konfirmasi. Untuk melewati konfirmasi tambahkan parameter -Force.** ``` $arn1 = "arn:aws:s3:::amzn-s3-demo-bucket" $arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable" Remove-RGTResourceTag -ResourceARNList $arn1,$arn2 -TagKey "stage","version" ``` **Contoh 2: Menghapus kunci tag “stage” dan “version”, dan nilai terkait, dari bucket Amazon S3 dan tabel Amazon DynamoDB. Dua panggilan dilakukan ke layanan, satu untuk setiap sumber daya ARN disalurkan ke cmdlet. Sebelum setiap panggilan, cmdlet akan meminta konfirmasi. Untuk melewati konfirmasi tambahkan parameter -Force.** ``` $arn1 = "arn:aws:s3:::amzn-s3-demo-bucket" $arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable" $arn1,$arn2 | Remove-RGTResourceTag -TagKey "stage","version" ``` + Untuk detail API, lihat [UntagResources](https://docs.aws.amazon.com/powershell/v4/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V4)*. **Alat untuk PowerShell V5** **Contoh 1: Menghapus kunci tag “stage” dan “version”, dan nilai terkait, dari bucket Amazon S3 dan tabel Amazon DynamoDB. Satu panggilan dilakukan ke layanan untuk menghapus tag. Sebelum tag dihapus, cmdlet akan meminta konfirmasi. Untuk melewati konfirmasi tambahkan parameter -Force.** ``` $arn1 = "arn:aws:s3:::amzn-s3-demo-bucket" $arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable" Remove-RGTResourceTag -ResourceARNList $arn1,$arn2 -TagKey "stage","version" ``` **Contoh 2: Menghapus kunci tag “stage” dan “version”, dan nilai terkait, dari bucket Amazon S3 dan tabel Amazon DynamoDB. Dua panggilan dilakukan ke layanan, satu untuk setiap sumber daya ARN disalurkan ke cmdlet. Sebelum setiap panggilan, cmdlet akan meminta konfirmasi. Untuk melewati konfirmasi tambahkan parameter -Force.** ``` $arn1 = "arn:aws:s3:::amzn-s3-demo-bucket" $arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable" $arn1,$arn2 | Remove-RGTResourceTag -TagKey "stage","version" ``` + Untuk detail API, lihat [UntagResources](https://docs.aws.amazon.com/powershell/v5/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V5)*. ------