Contoh Resource Groups menggunakan AWS CLI - AWS SDKContoh Kode
Tindakan

Ada lebih banyak AWS SDK contoh yang tersedia di GitHub repo SDKContoh AWS Dokumen.

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 adalah 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.

Tindakan

Contoh kode berikut menunjukkan cara menggunakancreate-group.

AWS CLI

Contoh 1: Untuk membuat grup sumber daya berbasis tag

create-groupContoh berikut membuat grup sumber daya berbasis tag dari EC2 instans Amazon di wilayah saat ini. Ini didasarkan pada kueri untuk sumber daya yang ditandai dengan kunciName, dan nilainyaWebServers. Nama grup adalahtbq-WebServer. Kueri berada dalam JSON file 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-groupContoh 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 di Panduan Pengguna AWS Resource Groups.

  • Untuk API detailnya, lihat CreateGroupdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-group.

AWS CLI

Untuk memperbarui deskripsi untuk grup sumber daya

delete-groupContoh 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 selengkapnya, lihat Menghapus Grup di Panduan Pengguna AWS Resource Groups.

  • Untuk API detailnya, lihat DeleteGroupdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-group-query.

AWS CLI

Untuk mendapatkan kueri yang dilampirkan ke grup sumber daya

get-group-queryContoh 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 API detailnya, lihat GetGroupQuerydi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-group.

AWS CLI

Untuk mendapatkan informasi tentang grup sumber daya

get-groupContoh berikut menampilkan rincian tentang kelompok sumber daya tertentu. Untuk mendapatkan kueri yang dilampirkan ke grup, gunakanget-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 API detailnya, lihat GetGroupdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-tags.

AWS CLI

Untuk mengambil tag yang dilampirkan ke grup sumber daya

get-tagsContoh 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 API detailnya, lihat GetTagsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-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 '::: :Instance'AWS EC2 . :

aws resource-groups list-group-resources --group-name tbq- WebServer --filters name=Resource-type, Values=::: :Instance AWS EC2

Contoh kode berikut menunjukkan cara menggunakanlist-groups.

AWS CLI

Untuk daftar grup sumber daya yang tersedia

list-groupsContoh 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 API detailnya, lihat ListGroupsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-resource-groups.

AWS CLI

Untuk membuat daftar semua sumber daya dalam grup sumber daya

list-resource-groupsContoh 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"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanput-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 EC2 kapasitas Amazon untuk instance dalam keluarga atau. 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 di Panduan API Referensi Resource Groups.

Contoh kode berikut menunjukkan cara menggunakansearch-resources.

AWS CLI

Untuk menemukan sumber daya yang cocok dengan kueri

search-resourcesContoh 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"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakantag.

AWS CLI

Untuk melampirkan tag ke grup sumber daya

tagContoh 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 di Panduan Pengguna AWS Resource Groups.

  • Untuk API detailnya, lihat Tag di Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanuntag.

AWS CLI

Untuk menghapus tag dari grup sumber daya

untagsContoh 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 di Panduan Pengguna AWS Resource Groups.

  • Untuk API detailnya, lihat Untag di Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-group-query.

AWS CLI

Contoh 1: Untuk memperbarui kueri untuk grup sumber daya berbasis tag

update-group-queryContoh 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 di Panduan Pengguna AWS Resource Groups.

Contoh 2: Untuk memperbarui kueri untuk grup sumber daya CloudFormation berbasis tumpukan

update-group-queryContoh 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 di Panduan Pengguna AWS Resource Groups.

Contoh kode berikut menunjukkan cara menggunakanupdate-group.

AWS CLI

Untuk memperbarui deskripsi untuk grup sumber daya

update-groupContoh 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 di Panduan Pengguna AWS Resource Groups.

  • Untuk API detailnya, lihat UpdateGroupdi Referensi AWS CLI Perintah.