Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Contoh Resource Groups menggunakan AWS CLI
Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum dengan menggunakan AWS Command Line Interface with Resource Groups.
*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.
Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.
**Topics**
+ [Tindakan](#actions)
## Tindakan
### `create-group`
Contoh kode berikut menunjukkan cara menggunakan`create-group`.
**AWS CLI**
**Contoh 1: Untuk membuat grup sumber daya berbasis tag**
`create-group`Contoh berikut membuat grup sumber daya berbasis tag dari instans Amazon EC2 di wilayah saat ini. Ini didasarkan pada kueri untuk sumber daya yang ditandai dengan kunci`Name`, dan nilainya`WebServers`. Nama grup adalah`tbq-WebServer`. Kueri berada dalam file JSON terpisah yang diteruskan ke perintah.
```
aws resource-groups create-group \
--name tbq-WebServer \
--resource-query file://query.json
```
Isi dari `query.json`:
```
{
"Type": "TAG_FILTERS_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"
}
```
Output:
```
{
"Group": {
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
"Name": "tbq-WebServer"
},
"ResourceQuery": {
"Type": "TAG_FILTERS_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"
}
}
```
**Contoh 2: Untuk membuat grup sumber CloudFormation daya berbasis tumpukan**
`create-group`Contoh berikut membuat grup sumber daya AWS CloudFormation berbasis tumpukan bernama. `sampleCFNstackgroup` Kueri mencakup semua sumber daya dalam CloudFormation tumpukan tertentu yang didukung oleh AWS Resource Groups.
```
aws resource-groups create-group \
--name cbq-CFNstackgroup \
--resource-query file://query.json
```
Isi dari `query.json`:
```
{
"Type": "CLOUDFORMATION_STACK_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"
}
```
Output:
```
{
"Group": {
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNstackgroup",
"Name": "cbq-CFNstackgroup"
},
"ResourceQuery": {
"Type": "CLOUDFORMATION_STACK_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-east-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"}'
}
}
```
Untuk informasi selengkapnya, lihat [Membuat Grup](https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html) di *Panduan Pengguna AWS Resource Groups*.
+ Untuk detail API, lihat [CreateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/create-group.html)di *Referensi AWS CLI Perintah*.
### `delete-group`
Contoh kode berikut menunjukkan cara menggunakan`delete-group`.
**AWS CLI**
**Untuk memperbarui deskripsi untuk grup sumber daya**
`delete-group`Contoh berikut memperbarui grup sumber daya yang ditentukan.
```
aws resource-groups delete-group \
--group-name tbq-WebServer
```
Output:
```
{
"Group": {
"GroupArn": "arn:aws:resource-groups:us-west-2:1234567890:group/tbq-WebServer",
"Name": "tbq-WebServer"
}
}
```
Untuk informasi selengkapnya, lihat [Menghapus Grup](https://docs.aws.amazon.com/ARG/latest/userguide/deleting-resource-groups.html) di *Panduan Pengguna AWS Resource Groups*.
+ Untuk detail API, lihat [DeleteGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/delete-group.html)di *Referensi AWS CLI Perintah*.
### `get-group-query`
Contoh kode berikut menunjukkan cara menggunakan`get-group-query`.
**AWS CLI**
**Untuk mendapatkan kueri yang dilampirkan ke grup sumber daya**
`get-group-query`Contoh berikut menampilkan query yang dilampirkan ke kelompok sumber daya tertentu.
```
aws resource-groups get-group-query \
--group-name tbq-WebServer
```
Output:
```
{
"GroupQuery": {
"GroupName": "tbq-WebServer",
"ResourceQuery": {
"Type": "TAG_FILTERS_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"
}
}
}
```
+ Untuk detail API, lihat [GetGroupQuery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/get-group-query.html)di *Referensi AWS CLI Perintah*.
### `get-group`
Contoh kode berikut menunjukkan cara menggunakan`get-group`.
**AWS CLI**
**Untuk mendapatkan informasi tentang grup sumber daya**
`get-group`Contoh berikut menampilkan rincian tentang kelompok sumber daya tertentu. Untuk mendapatkan kueri yang dilampirkan ke grup, gunakan`get-group-query`.
```
aws resource-groups get-group \
--group-name tbq-WebServer
```
Output:
```
{
"Group": {
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
"Name": "tbq-WebServer",
"Description": "A tag-based query resource group of WebServers."
}
}
```
+ Untuk detail API, lihat [GetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/get-group.html)di *Referensi AWS CLI Perintah*.
### `get-tags`
Contoh kode berikut menunjukkan cara menggunakan`get-tags`.
**AWS CLI**
**Untuk mengambil tag yang dilampirkan ke grup sumber daya**
`get-tags`Contoh berikut menampilkan kunci tag dan pasangan nilai yang dilampirkan ke grup sumber daya tertentu (grup itu sendiri, bukan anggotanya).
```
aws resource-groups get-tags \
--arn arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer
```
Output:
```
{
"Arn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
"Tags": {
"QueryType": "tags",
"QueryResources": "ec2-instances"
}
}
```
+ Untuk detail API, lihat [GetTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/get-tags.html)di *Referensi AWS CLI Perintah*.
### `list-group-resources`
Contoh kode berikut menunjukkan cara menggunakan`list-group-resources`.
**AWS CLI**
**Untuk membuat daftar semua sumber daya dalam grup sumber daya**
Contoh 1: `list-resource-groups` Contoh berikut mencantumkan semua sumber daya yang merupakan bagian dari grup sumber daya yang ditentukan.
```
aws resource-groups list-group-resources \
--group-name tbq-WebServer
```
Output:
```
{
"ResourceIdentifiers": [
{
"ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-09f77fa38c12345ab",
"ResourceType": "AWS::EC2::Instance"
}
]
}
```
Contoh 2: Contoh berikut mencantumkan semua sumber daya dalam grup yang juga memiliki 'tipe sumber daya' dari ': :EC2: :Instance'AWS. :
aws resource-groups list-group-resources --group-name tbq- WebServer --filters name=Resource-type, Values=: :EC2: :Instance AWS
+ Untuk detail API, lihat [ListGroupResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/list-group-resources.html)di *Referensi AWS CLI Perintah*.
### `list-groups`
Contoh kode berikut menunjukkan cara menggunakan`list-groups`.
**AWS CLI**
**Untuk daftar grup sumber daya yang tersedia**
`list-groups`Contoh berikut menampilkan daftar semua kelompok sumber daya.
```
aws resource-groups list-groups
```
Output:
```
{
"GroupIdentifiers": [
{
"GroupName": "tbq-WebServer",
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer3"
},
{
"GroupName": "cbq-CFNStackQuery",
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNStackQuery"
}
],
"Groups": [
{
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
"Name": "tbq-WebServer"
},
{
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNStackQuery",
"Name": "cbq-CFNStackQuery"
}
]
}
```
+ Untuk detail API, lihat [ListGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/list-groups.html)di *Referensi AWS CLI Perintah*.
### `list-resource-groups`
Contoh kode berikut menunjukkan cara menggunakan`list-resource-groups`.
**AWS CLI**
**Untuk membuat daftar semua sumber daya dalam grup sumber daya**
`list-resource-groups`Contoh berikut mencantumkan semua sumber daya yang merupakan bagian dari kelompok sumber daya yang ditentukan.
```
aws resource-groups list-group-resources \
--group-name tbq-WebServer
```
Output:
```
{
"ResourceIdentifiers": [
{
"ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-09f77fa38c12345ab",
"ResourceType": "AWS::EC2::Instance"
}
]
}
```
+ Untuk detail API, lihat [ListResourceGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/list-resource-groups.html)di *Referensi AWS CLI Perintah*.
### `put-group-configuration`
Contoh kode berikut menunjukkan cara menggunakan`put-group-configuration`.
**AWS CLI**
**Untuk melampirkan konfigurasi layanan ke grup sumber daya**
Contoh 1: `put-group-configuration` Contoh berikut menentukan bahwa grup sumber daya hanya berisi reservasi kapasitas Amazon EC2 untuk instans dalam atau keluarga. `C5` `M5`
```
aws resource-groups put-group-configuration \
--group MyTestGroup \
--configuration file://config.json
```
Isi dari `config.json`:
```
[
{
"Type": "AWS::EC2::HostManagement",
"Parameters": [
{
"Name": "allowed-host-families",
"Values": [ "c5", "m5" ]
},
{
"Name": "any-host-based-license-configuration",
"Values": [ "true" ]
}
]
},
{
"Type": "AWS::ResourceGroups::Generic",
"Parameters": [
{
"Name": "allowed-resource-types",
"Values": [ "AWS::EC2::Host" ]
},
{
"Name": "deletion-protection",
"Values": [ "UNLESS_EMPTY" ]
}
]
}
]
```
Perintah ini tidak menghasilkan output jika berhasil.
Untuk informasi selengkapnya, lihat [Konfigurasi layanan untuk grup sumber daya](https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html) di *Panduan Referensi API Resource Groups*.
+ Untuk detail API, lihat [PutGroupConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/put-group-configuration.html)di *Referensi AWS CLI Perintah*.
### `search-resources`
Contoh kode berikut menunjukkan cara menggunakan`search-resources`.
**AWS CLI**
**Untuk menemukan sumber daya yang cocok dengan kueri**
`search-resources`Contoh berikut mengambil daftar semua AWS sumber daya yang cocok dengan query yang ditentukan.
```
aws resource-groups search-resources \
--resource-query file://query.json
```
Isi dari `query.json`:
```
{
"Type": "TAG_FILTERS_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Patch Group\", \"Values\":[\"Dev\"]}]}"
}
```
Output:
```
{
"ResourceIdentifiers": [
{
"ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-01a23bc45d67890ef",
"ResourceType": "AWS::EC2::Instance"
}
]
}
```
+ Untuk detail API, lihat [SearchResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/search-resources.html)di *Referensi AWS CLI Perintah*.
### `tag`
Contoh kode berikut menunjukkan cara menggunakan`tag`.
**AWS CLI**
**Untuk melampirkan tag ke grup sumber daya**
`tag`Contoh berikut melampirkan kunci tag yang ditentukan dan pasangan nilai ke grup sumber daya tertentu (grup itu sendiri, bukan anggotanya).
```
aws resource-groups tag \
--tags QueryType=tags,QueryResources=ec2-instances \
--arn arn:aws:resource-groups:us-west-2:128716708097:group/tbq-WebServer
```
Output:
```
{
"Arn": "arn:aws:resource-groups:us-west-2:128716708097:group/tbq-WebServer",
"Tags": {
"QueryType": "tags",
"QueryResources": "ec2-instances"
}
}
```
Untuk informasi selengkapnya, lihat [Mengelola tag](https://docs.aws.amazon.com/ARG/latest/userguide/tagging-resources.html) di *Panduan Pengguna AWS Resource Groups*.
+ Untuk detail API, lihat [Tag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/tag.html) di *Referensi AWS CLI Perintah*.
### `untag`
Contoh kode berikut menunjukkan cara menggunakan`untag`.
**AWS CLI**
**Untuk menghapus tag dari grup sumber daya**
`untags`Contoh berikut menghapus tag apa pun dengan kunci yang ditentukan dari grup sumber daya itu sendiri, bukan anggotanya.
```
aws resource-groups untag \
--arn arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer \
--keys QueryType
```
Output:
```
{
"Arn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
"Keys": [
"QueryType"
]
}
```
Untuk informasi selengkapnya, lihat [Mengelola tag](https://docs.aws.amazon.com/ARG/latest/userguide/tagging-resources.html) di *Panduan Pengguna AWS Resource Groups*.
+ Untuk detail API, lihat [Untag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/untag.html) di *Referensi AWS CLI Perintah*.
### `update-group-query`
Contoh kode berikut menunjukkan cara menggunakan`update-group-query`.
**AWS CLI**
**Contoh 1: Untuk memperbarui kueri untuk grup sumber daya berbasis tag**
`update-group-query`Contoh berikut memperbarui kueri yang dilampirkan ke grup sumber daya berbasis tag yang ditentukan.
```
aws resource-groups update-group-query \
--group-name tbq-WebServer \
--resource-query '{"Type":"TAG_FILTERS_1_0", "Query":"{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"}'
```
Output:
```
{
"Group": {
"GroupArn": "arn:aws:resource-groups:us-east-2:123456789012:group/tbq-WebServer",
"Name": "tbq-WebServer"
},
"ResourceQuery": {
"Type": "TAG_FILTERS_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"
}
}
```
Untuk informasi selengkapnya, lihat [Memperbarui Grup](https://docs.aws.amazon.com/ARG/latest/userguide/updating-resource-groups.html) di *Panduan Pengguna AWS Resource Groups*.
**Contoh 2: Untuk memperbarui kueri untuk grup sumber daya CloudFormation berbasis tumpukan**
`update-group-query`Contoh berikut memperbarui kueri yang dilampirkan ke grup sumber daya AWS CloudFormation berbasis tumpukan yang ditentukan.
```
aws resource-groups update-group-query \
--group-name cbq-CFNstackgroup \
--resource-query '{"Type": "CLOUDFORMATION_STACK_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"}'
```
Output:
```
{
"Group": {
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNstackgroup",
"Name": "cbq-CFNstackgroup"
},
"ResourceQuery": {
"Type": "CLOUDFORMATION_STACK_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"
}
}
```
Untuk informasi selengkapnya, lihat [Memperbarui Grup](https://docs.aws.amazon.com/ARG/latest/userguide/updating-resource-groups.html) di *Panduan Pengguna AWS Resource Groups*.
+ Untuk detail API, lihat [UpdateGroupQuery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/update-group-query.html)di *Referensi AWS CLI Perintah*.
### `update-group`
Contoh kode berikut menunjukkan cara menggunakan`update-group`.
**AWS CLI**
**Untuk memperbarui deskripsi untuk grup sumber daya**
`update-group`Contoh berikut memperbarui deskripsi untuk grup sumber daya yang ditentukan.
```
aws resource-groups update-group \
--group-name tbq-WebServer \
--description "Resource group for all web server resources."
```
Output:
```
{
"Group": {
"GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
"Name": "tbq-WebServer"
"Description": "Resource group for all web server resources."
}
}
```
Untuk informasi selengkapnya, lihat [Memperbarui Grup](https://docs.aws.amazon.com/ARG/latest/userguide/updating-resource-groups.html) di *Panduan Pengguna AWS Resource Groups*.
+ Untuk detail API, lihat [UpdateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-groups/update-group.html)di *Referensi AWS CLI Perintah*.