Contoh Grup Sumber Daya menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface dengan Grup Sumber Daya.

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.

Topik

Tindakan

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 instans Amazon EC2 di wilayah saat ini. Ini didasarkan pada kueri untuk sumber daya yang ditandai dengan kunciName, dan nilainyaWebServers. Nama grup adalahtbq-WebServer. Kueri ada 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 daya CloudFormation berbasis tumpukan

create-groupContoh berikut membuat grup sumber daya AWS CloudFormation berbasis tumpukan bernama. sampleCFNstackgroup Kueri mencakup semua sumber daya dalam CloudFormation tumpukan yang ditentukan yang didukung oleh Grup AWS Sumber Daya.


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 AWS Pengguna Grup Sumber Daya.

Untuk detail API, lihat CreateGroup di Refer AWS CLI ensi 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 informasi selengkapnya, lihat Mengh apus Grup di AWS Panduan Pengguna Grup Sumber Daya.

Untuk detail API, lihat DeleteGroup di Refer AWS CLI ensi 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 kueri yang dilampirkan ke grup sumber daya yang ditentukan.


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 di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-group.

AWS CLI

Untuk mendapatkan informasi tentang grup sumber daya

get-groupContoh berikut menampilkan detail tentang grup sumber daya yang ditentukan. 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 detail API, lihat GetGroup di Refer AWS CLI ensi 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 detail API, lihat GetTags di Refer AWS CLI ensi 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 ': :EC2 AWS: :Instance' . :

aws resource-groups list-grup-resource --group-name tbq- --filters name=Jenis sumber daya, nilai=: :EC2: :Instance WebServer AWS

Untuk detail API, lihat ListGroupResources di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-groups.

AWS CLI

Untuk membuat 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 detail API, lihat ListGroups di Refer AWS CLI ensi 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 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"
        }
    ]
}

Untuk detail API, lihat ListResourceGroups di Refer AWS CLI ensi Perintah.

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 kapasitas Amazon EC2 untuk instans dalam M5 keluarga C5 or.


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 Referensi API Grup Sumber Daya.

Untuk detail API, lihat PutGroupConfiguration di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakansearch-resources.

AWS CLI

Untuk menemukan sumber daya yang cocok dengan kueri

search-resourcesContoh berikut mengambil daftar semua sumber AWS daya yang cocok dengan kueri 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 di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakantag.

AWS CLI

Untuk melampirkan tag ke grup sumber daya

tagContoh berikut melampirkan kunci tag dan pasangan nilai yang ditentukan ke grup sumber daya yang ditentukan (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 AWS Panduan Pengguna Grup Sumber Daya.

Untuk detail API, 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 AWS Panduan Pengguna Grup Sumber Daya.

Untuk detail API, lihat Untag di Refer ensi Per AWS CLI intah.

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 Memper barui Grup di AWS Panduan Pengguna Grup Sumber Daya.

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 Memper barui Grup di AWS Panduan Pengguna Grup Sumber Daya.

Untuk detail API, lihat UpdateGroupQuery di Refer AWS CLI ensi Perintah.

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 Memper barui Grup di AWS Panduan Pengguna Grup Sumber Daya.

Untuk detail API, lihat UpdateGroup di Refer AWS CLI ensi Perintah.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Penjelajah Sumber Daya

API Penandaan Grup Sumber Daya