Jenis kueri grup sumber daya Buat kueri berbasis tag dan buat grup Membuat grupAWS CloudFormation berbasis tumpukan

Membuat grup berbasis kueri diAWS Resource Groups

Topik

Jenis kueri grup sumber daya
Buat kueri berbasis tag dan buat grup
Membuat grupAWS CloudFormation berbasis tumpukan

Jenis kueri grup sumber daya

DalamAWS Resource Groups, query adalah dasar dari kelompok berbasis query. Anda dapat mendasarkan grup sumber daya pada salah satu dari dua jenis kueri.

Berbasis tag

Kueri berbasis tag mencakup daftar jenis sumber daya yang ditentukan dalam format berikutAWS::service::resource, dan tag. Tanda adalah kunci yang membantu mengidentifikasi dan mengurutkan sumber daya di organisasi. Secara opsional, tag menyertakan nilai untuk kunci.

Untuk kueri berbasis tag, Anda juga menentukan tag yang dibagikan oleh sumber daya yang Anda inginkan untuk menjadi anggota grup. Misalnya, jika Anda ingin membuat grup sumber daya yang memiliki semua instans Amazon EC2 dan bucket Amazon S3 yang Anda gunakan untuk menjalankan tahap pengujian aplikasi, dan Anda memiliki instans dan bucket yang ditandai dengan cara ini, pilihAWS::EC2::Instance dan jenisAWS::S3::Bucket sumber daya dari daftar drop-down, lalu tentukan kunci tagStage, dengan nilai tagTest.

SintaksResourceQuery parameter kelompok sumber daya berbasis tag berisi unsur-unsur berikut:

Type

Elemen ini menunjukkan jenis query mendefinisikan kelompok sumber daya ini. Untuk membuat grup sumber daya berbasis tag, tentukan nilainyaTAG_FILTERS_1_0, sebagai berikut:
```
"Type": "TAG_FILTERS_1_0"
```
Query

Elemen ini mendefinisikan query yang sebenarnya digunakan untuk mencocokkan terhadap sumber daya. Ini berisi representasi string dari struktur JSON dengan elemen-elemen berikut:
- ResourceTypeFilters
  
  Elemen ini membatasi hasil hanya pada tipe sumber daya yang cocok dengan filter. Anda dapat menentukan salah satu nilai berikut:
  - "AWS::AllSupported"— untuk menentukan bahwa hasil dapat menyertakan sumber daya dari jenis apa pun yang cocok dengan kueri dan yang saat ini didukung oleh layanan Resource Groups.
  - "AWS::service-id::resource-type- daftar dipisahkan koma dari string spesifikasi tipe sumber daya dengan format ini:, seperti"AWS::EC2::Instance".
- TagFilters
  
  Elemen ini menentukan pasangan string kunci/nilai yang dibandingkan dengan tag yang melekat pada sumber daya Anda. Mereka yang memiliki kunci tag dan nilai yang cocok dengan filter disertakan dalam grup. Setiap filter terdiri dari elemen-elemen ini:
  - "Key"— string dengan nama kunci. Hanya sumber daya yang memiliki tag dengan Nama kunci yang cocok yang cocok dengan filter dan merupakan anggota grup.
  - "Values"- string dengan daftar nilai yang dipisahkan koma untuk kunci yang ditentukan. Hanya sumber daya dengan kunci tag yang cocok dan nilai yang cocok dengan yang ada di daftar ini yang merupakan anggota grup.

Semua elemen JSON ini harus digabungkan menjadi representasi string single-line dari struktur JSON. Contohnya, pertimbangkanQuery dengan struktur contoh JSON berikut ini. Kueri ini dimaksudkan untuk mencocokkan hanya instans Amazon EC2 yang memiliki tag “Stage” dengan nilai “Test”.


{
    "ResourceTypeFilters": [ "AWS::EC2::Instance" ],
    "TagFilters": [
        {
            "Key": "Stage",
            "Values": [ "Test" ]
        }
    ]
}

JSON yang dapat direpresentasikan sebagai berikut single-line string, dan digunakan sebagai nilaiQuery elemen. Karena nilai struktur JSON harus berupa string yang dikutip ganda, Anda harus melarikan diri dari karakter kutipan ganda yang disematkan atau karakter garis miring maju dengan mendahului masing-masing dengan garis miring terbalik seperti yang ditunjukkan di sini:


"Query":"{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"

ResourceQueryString lengkap kemudian direpresentasikan seperti yang ditunjukkan di sini, sebagai parameter perintah CLI:


--resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"}'

AWS CloudFormationberbasis tumpukan

Dalam kueriAWS CloudFormation berbasis tumpukan, Anda memilihAWS CloudFormation tumpukan di akun Anda di wilayah saat ini, lalu memilih jenis sumber daya dalam tumpukan yang ingin Anda masukkan ke grup. Anda dapat mendasarkan kueri Anda hanya pada satuAWS CloudFormation tumpukan.

catatan

AWS CloudFormationTumpukan dapat berisi tumpukanAWS CloudFormation “anak” lainnya. Namun, grup sumber daya berdasarkan tumpukan “induk” tidak mendapatkan semua sumber daya tumpukan anak sebagai anggota grup. Grup sumber menambahkan tumpukan anak ke grup sumber daya tumpukan induk sebagai anggota grup tunggal dan tidak mengembangkannya.

Resource Groups mendukung kueri berdasarkanAWS CloudFormation tumpukan yang memiliki salah satu dari status-status berikut ini.

CREATE_COMPLETE
CREATE_IN_PROGRESS
DELETE_FAILED
DELETE_IN_PROGRESS
REVIEW_IN_PROGRESS

penting

Hanya sumber daya yang langsung dibuat sebagai bagian dari tumpukan dalam kueri yang disertakan dalam grup sumber daya. Sumber daya yang dibuat kemudian oleh anggotaAWS CloudFormation tumpukan tidak menjadi anggota grup. Misalnya, jika grup auto-scaling dibuatAWS CloudFormation sebagai bagian dari tumpukan, maka grup auto-scaling itu adalah anggota grup. Namun, instans Amazon EC2 yang dibuat oleh grup auto-scaling sebagai bagian dari operasinya bukanlah anggota grup sumber dayaAWS CloudFormation berbasis tumpukan.

Jika Anda membuat grup berdasarkanAWS CloudFormation tumpukan, dan status tumpukan berubah menjadi grup yang tidak lagi didukung sebagai dasar kueri grup, misalnya, grup sumber daya masih ada, tetapi tidak memiliki sumber daya anggota.DELETE_COMPLETE

Setelah membuat grup sumber daya, Anda dapat melakukan tugas pada sumber daya dalam grup.

SintaksResourceQuery parameter kelompok sumber daya CloudFormation berbasis tumpukan berisi unsur-unsur berikut:

Type

Elemen ini menunjukkan jenis query mendefinisikan kelompok sumber daya ini.

Untuk membuat grup sumber dayaAWS CloudFormation berbasis tumpukan, tentukan nilainyaCLOUDFORMATION_STACK_1_0, sebagai berikut:
```
"Type": "CLOUDFORMATION_STACK_1_0"
```
Query

Elemen ini mendefinisikan query yang sebenarnya digunakan untuk mencocokkan terhadap sumber daya. Ini berisi representasi string dari struktur JSON dengan elemen-elemen berikut:
- ResourceTypeFilters
  
  Elemen ini membatasi hasil hanya pada tipe sumber daya yang cocok dengan filter. Anda dapat menentukan salah satu nilai berikut:
  - "AWS::AllSupported"- untuk menentukan bahwa hasil dapat mencakup sumber daya dari jenis apa pun yang cocok dengan kueri.
  - "AWS::service-id::resource-type- daftar dipisahkan koma dari string spesifikasi tipe sumber daya dengan format ini:, seperti"AWS::EC2::Instance".
- StackIdentifier
  
  Elemen ini menentukan Amazon Resource Name (ARN) dariAWS CloudFormation tumpukan yang sumber daya yang ingin Anda sertakan dalam grup.

Semua elemen JSON ini harus digabungkan menjadi representasi string single-line dari struktur JSON. Contohnya, pertimbangkanQuery dengan struktur contoh JSON berikut ini. Kueri ini dimaksudkan untuk hanya mencocokkan bucket Amazon S3 yang merupakan bagian dariAWS CloudFormation tumpukan yang ditentukan.


{
    "ResourceTypeFilters": [ "AWS::S3::Bucket" ],
    "StackIdentifier": "arn:aws:cloudformation:us-west-2:123456789012:stack/MyCloudFormationStackName/fb0d5000-aba8-00e8-aa9e-50d5cEXAMPLE"
}


"Query":"{\"ResourceTypeFilters\":[\"AWS::S3::Bucket\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack\/MyCloudFormationStackName\/fb0d5000-aba8-00e8-aa9e-50d5cEXAMPLE\"

ResourceQueryString lengkap kemudian direpresentasikan seperti yang ditunjukkan di sini, sebagai parameter perintah CLI:


--resource-query '{"Type":"CLOUDFORMATION_STACK_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::S3::Bucket\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack\/MyCloudFormationStackName\/fb0d5000-aba8-00e8-aa9e-50d5cEXAMPLE\"}'

Buat kueri berbasis tag dan buat grup

Prosedur berikut menunjukkan cara membuat kueri berbasis tag dan menggunakannya untuk membuat grup sumber daya.

Console

Masuk ke konsol AWS Resource Groups tersebut.
Di panel navigasi, pilih Buat Grup Sumber Daya.
Pada halaman Buat grup berbasis kueri, di bawah Jenis grup, pilih jenis grup berbasis Tag.
Di bawah Kriteria pengelompokan, pilih jenis sumber daya yang Anda inginkan dalam grup sumber daya Anda. Anda dapat memiliki maksimum 20 jenis sumber daya dalam kueri. Untuk panduan ini, pilih AWS::EC2::Instancedan AWS::S3::Bucket.
Masih di bawah kriteria pengelompokan, untuk Tag, tentukan kunci tag, atau kunci tag dan pasangan nilai, untuk membatasi sumber daya yang cocok untuk menyertakan hanya yang ditandai dengan nilai yang Anda tentukan. Pilih Tambah atau tekan Enter setelah Anda selesai tag. Dalam contoh ini, filter sumber daya yang memiliki kunci tag Stage. Nilai tag bersifat opsional, tetapi mempersempit hasil kueri lebih lanjut. Anda dapat menambahkan beberapa nilai untuk kunci tag dengan menambahkanOR operator di antara nilai tag. Untuk menambahkan tanda, pilih Tambah. Query menetapkanAND operator untuk tag, sehingga setiap sumber daya yang cocok dengan jenis sumber daya yang ditentukan dan semua tag tertentu dikembalikan oleh query.
Masih dalam kriteria Pengelompokan, pilih Sumber daya grup pratinjau untuk mengembalikan daftar instans EC2 dan bucket S3 di akun Anda yang cocok dengan kunci atau kunci tag yang ditentukan.
Setelah Anda mendapatkan hasil yang Anda inginkan, buat grup berdasarkan kueri ini.
1. Di bawah Rincian grup, untuk Nama grup, ketik nama untuk grup sumber daya Anda.
  
  Nama grup sumber daya dapat memiliki maksimum 128 karakter, termasuk huruf, angka, tanda hubung, titik, dan garis bawah. Nama tidak dapat dimulai denganAWS atauaws. Ini tersimpan. Nama grup sumber daya harus unik di Wilayah saat ini di akun Anda.
2. (Opsional) Di Deskripsi grup, masukkan deskripsi grup Anda.
3. (Opsional) Dalam Tag grup, tambahkan kunci tag dan pasangan nilai yang hanya berlaku untuk grup sumber daya, bukan sumber daya anggota dalam grup.
  
  Tag grup berguna jika Anda berencana menjadikan grup ini anggota grup yang lebih besar. Karena menentukan setidaknya kunci tag diperlukan untuk membuat grup, pastikan untuk menambahkan setidaknya kunci tag di Tag grup ke grup yang Anda rencanakan untuk dimasukkan ke dalam grup yang lebih besar.
Setelah selesai, pilih Buat grup.

AWS CLI & AWS SDKs

Sebuah kelompok berbasis tag didasarkan pada query jenisTAG_FILTERS_1_0.

DalamAWS CLI sesi, ketik berikut ini, lalu tekan Enter, ganti nilai untuk nama grup, deskripsi, jenis sumber daya, kunci tag, dan nilai tag dengan milik Anda sendiri. Deskripsi dapat memiliki maksimum 512 karakter, termasuk huruf, angka, angka hubung, garis bawah, tanda baca, dan spasi. Anda dapat memiliki maksimum 20 jenis sumber daya dalam kueri. Nama grup sumber daya dapat memiliki maksimum 128 karakter, termasuk huruf, angka, tanda hubung, titik, dan garis bawah. Nama tidak dapat dimulai denganAWS atauaws. Ini tersimpan. Nama grup sumber daya harus unik di akun Anda.

Setidaknya satu nilai untukResourceTypeFilters diperlukan. Untuk menentukan semua jenis sumber daya, gunakanAWS::AllSupported sebagaiResourceTypeFilters nilai.
```
$ aws resource-groups create-group \
    --name resource-group-name \
    --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"resource_type1\",\"resource_type2\"],\"TagFilters\":[{\"Key\":\"Key1\",\"Values\":[\"Value1\",\"Value2\"]},{\"Key\":\"Key2\",\"Values\":[\"Value1\",\"Value2\"]}]}"}'
```
Berikut adalah contoh perintah tersebut.
```
$ aws resource-groups create-group \
    --name my-resource-group \
    --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"}'
```
Berikut adalah contoh perintah yang mencakup semua tipe sumber daya yang didukung.
```
$ aws resource-groups create-group \
    --name my-resource-group \
    --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"}'
```
Berikut ini dikembalikan dalam respons terhadap perintah.
- Deskripsi lengkap tentang grup yang telah Anda buat.
- Kueri sumber daya yang Anda gunakan untuk membuat grup.
- Tanda yang terkait dengan grup.

Membuat grupAWS CloudFormation berbasis tumpukan

Prosedur berikut menunjukkan cara membuat kueri berbasis tumpukan dan menggunakannya untuk membuat grup sumber daya.

Console

Masuk ke konsol AWS Resource Groups tersebut.
Di panel navigasi, pilih Buat Grup Sumber Daya.
Pada Buat grup berbasis kueri, di bawah Tipe grup, pilih jenis grup berbasisCloudFormation tumpukan.
Pilih tumpukan yang ingin Anda gunakan untuk grup Anda. Grup sumber daya hanya dapat didasarkan pada satu tumpukan. Untuk memfilter daftar tumpukan, mulailah mengetik nama tumpukan. Hanya tumpukan dengan status yang didukung yang muncul dalam daftar.
Pilih tipe sumber daya di tumpukan yang ingin Anda sertakan dalam grup. Untuk panduan ini, pertahankan default, Semua jenis sumber daya yang didukung. Untuk informasi selengkapnya tentang jenis sumber daya yang didukung dan dapat berada di grup, lihatJenis sumber daya yang dapat Anda gunakan dengan AWS Resource Groups dan Editor Tag.
Pilih Lihat sumber daya grup untuk mengembalikan daftar sumber daya dalamAWS CloudFormation tumpukan yang cocok dengan jenis sumber daya yang Anda pilih.
Setelah Anda mendapatkan hasil yang Anda inginkan, buat grup berdasarkan kueri ini.
1. Di bawah Rincian grup, untuk Nama grup, ketik nama untuk grup sumber daya Anda.
  
  Nama grup sumber daya dapat memiliki maksimum 128 karakter, termasuk huruf, angka, tanda hubung, titik, dan garis bawah. Nama tidak dapat dimulai denganAWS atauaws. Ini tersimpan. Nama grup sumber daya harus unik di Wilayah saat ini di akun Anda.
2. (Opsional) Di Deskripsi grup, masukkan deskripsi grup Anda.
3. (Opsional) Dalam Tag grup, tambahkan kunci tag dan pasangan nilai yang hanya berlaku untuk grup sumber daya, bukan sumber daya anggota dalam grup.
  
  Tag grup berguna jika Anda berencana menjadikan grup ini anggota grup yang lebih besar. Karena menentukan setidaknya kunci tag diperlukan untuk membuat grup, pastikan untuk menambahkan setidaknya kunci tag di Tag grup ke grup yang Anda rencanakan untuk dimasukkan ke dalam grup yang lebih besar.
Setelah selesai, pilih Buat grup.

AWS CLI & AWS SDKs

Sebuah kelompokAWS CloudFormation berbasis tumpukan didasarkan pada query jenisCLOUDFORMATION_STACK_1_0.

Jalankan perintah berikut, ganti nilai untuk nama grup, deskripsi, pengenal tumpukan, dan jenis sumber daya dengan milik Anda sendiri. Deskripsi dapat memiliki maksimum 512 karakter, termasuk huruf, angka, angka hubung, garis bawah, tanda baca, dan spasi.

Jika Anda tidak menentukan jenis sumber daya, Resource Groups menyertakan semua jenis sumber daya yang didukung di tumpukan. Anda dapat memiliki maksimum 20 jenis sumber daya dalam kueri. Nama grup sumber daya dapat memiliki maksimum 128 karakter, termasuk huruf, angka, tanda hubung, titik, dan garis bawah. Nama tidak dapat dimulai denganAWS atauaws. Ini tersimpan. Nama grup sumber daya harus unik di akun Anda.

Stack_identifier adalah tumpukan ARN, seperti yang ditunjukkan pada perintah contoh.
```
$ aws resource-groups create-group \
    --name group_name \
    --description "description" \
    --resource-query '{"Type":"CLOUDFORMATION_STACK_1_0","Query":"{\"StackIdentifier\":\"stack_identifier\",\"ResourceTypeFilters\":[\"resource_type1\",\"resource_type2\"]}"}'
```
Berikut adalah contoh perintah tersebut.
```
$ aws resource-groups create-group \
    --name My-CFN-stack-group \
    --description "My first CloudFormation stack-based group" \
    --resource-query '{"Type":"CLOUDFORMATION_STACK_1_0","Query":"{\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack\/AWStestuseraccount\/fb0d5000-aba8-00e8-aa9e-50d5cEXAMPLE\",\"ResourceTypeFilters\":[\"AWS::EC2::Instance\",\"AWS::S3::Bucket\"]}"}'
```
Berikut ini dikembalikan dalam menanggapi perintah.
- Deskripsi lengkap tentang grup yang telah Anda buat.
- Kueri sumber daya yang Anda gunakan untuk membuat grup.

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

Prasyarat

Memperbarui grup