Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Peristiwa siklus hidup grup: Memantau grup sumber daya untuk mendeteksi perubahan
Setelah Anda menggunakan AWS Resource Groups untuk mengatur sumber daya Anda ke dalam grup, Anda dapat memantau grup tersebut untuk perubahan yang diekspos kepada Anda sebagai *acara*. Anda dapat menerima pemberitahuan tentang acara grup sebagai sinyal bagi Anda untuk mengambil semacam tindakan. Misalnya, Anda dapat mengonfigurasi notifikasi yang dikirim setiap kali keanggotaan grup berubah. Anda dapat menggunakan acara dari menambahkan anggota grup baru untuk memicu fungsi Lambda yang meninjau perubahan secara terprogram untuk memastikan bahwa anggota grup baru memenuhi persyaratan kepatuhan yang ditetapkan oleh organisasi Anda. Fungsi Lambda semacam itu dapat melakukan remediasi otomatis untuk setiap anggota grup baru yang gagal memenuhi persyaratan tersebut. Peristiwa yang disebabkan oleh penghapusan anggota grup dapat memicu fungsi Lambda yang melakukan pembersihan yang diperlukan, seperti menghapus sumber daya yang ditautkan.
Dengan mengaktifkan peristiwa siklus hidup grup untuk grup sumber daya Anda, Anda mengizinkan peristiwa tentang perubahan pada grup Anda ditangkap oleh Amazon EventBridge dan tersedia untuk semua berbagai layanan target yang EventBridge didukung. Anda kemudian dapat mengonfigurasi layanan target tersebut untuk secara otomatis mengambil tindakan apa pun yang diperlukan skenario Anda. Target ini mencakup berbagai AWS layanan seperti Amazon Simple Notification Service (Amazon SNS), Amazon Simple Queue Service (Amazon SQS), dan. AWS Lambda Dengan layanan seperti Lambda, acara Anda dapat memicu respons *terprogram* yang menggunakan kode untuk melakukan tindakan apa pun yang Anda butuhkan. Untuk daftar AWS layanan yang dapat Anda targetkan EventBridge, lihat [ EventBridge Target Amazon](https://docs.aws.amazon.com//eventbridge/latest/userguide/eventbridge-targets.html) di *Panduan EventBridge Pengguna Amazon*.
Saat Anda mengaktifkan acara siklus hidup grup, AWS Resource Groups buat item berikut:
+ Peran terkait layanan AWS Identity and Access Management (IAM) yang memiliki izin untuk memantau sumber daya Anda untuk setiap perubahan pada tag mereka dan CloudFormation tumpukan Anda untuk setiap perubahan pada sumber daya yang merupakan bagian dari tumpukan.
+ EventBridge Aturan terkelola Resource Groups yang menangkap detail perubahan tag atau tumpukan apa pun pada sumber daya Anda. EventBridge menggunakan aturan ini untuk memberi tahu Resource Groups tentang perubahan tersebut. Kemudian, Resource Groups menghasilkan acara keanggotaan EventBridge untuk dikirim ke aturan kustom Anda untuk diproses.
Peran terkait layanan *hanya* dapat diasumsikan oleh layanan Resource Groups. Untuk informasi selengkapnya tentang peran terkait layanan yang digunakan oleh Resource Groups untuk fitur ini, lihat. [Menggunakan peran terkait layanan untuk Resource Groups](security_iam_service-linked-roles.md)
Saat fitur ini diaktifkan, Resource Groups akan menghasilkan peristiwa saat Anda membuat salah satu perubahan berikut pada grup sumber daya:
+ Buat grup sumber daya baru.
+ Perbarui kueri yang mendefinisikan keanggotaan grup sumber daya [berbasis kueri](gettingstarted-query.md).
+ Perbarui konfigurasi [grup sumber daya terkait layanan](https://docs.aws.amazon.com//ARG/latest/APIReference/about-slg.html).
+ Perbarui deskripsi grup sumber daya.
+ Hapus grup sumber daya.
+ Ubah keanggotaan grup sumber daya dengan menambahkan atau menghapus sumber daya dari grup. Perubahan keanggotaan juga dapat terjadi ketika tag berubah, atau ketika CloudFormation tumpukan berubah.
**penting**
Agar berhasil menerima dan menanggapi acara grup, Anda harus membuat perubahan pada Resource Groups dan EventBridge. Anda dapat melakukan perubahan dalam urutan apa pun, tetapi tidak ada acara grup yang dipublikasikan ke EventBridge target sampai setelah Anda membuat perubahan pada kedua layanan.
Perubahan grup sumber daya tidak menyertakan perubahan pada tag apa pun yang dilampirkan ke grup sumber daya itu sendiri. Untuk menghasilkan peristiwa berdasarkan perubahan tag pada grup Anda, Anda harus menggunakan EventBridge aturan yang menggunakan `aws.tag` sumber, bukan `aws.resource-groups` sumber. Untuk informasi selengkapnya, lihat [Peristiwa perubahan tag pada AWS Sumber Daya](https://docs.aws.amazon.com//eventbridge/latest/userguide/event-types.html#tag-event-types) di *Panduan EventBridge Pengguna Amazon*.
**Topics**
+ [Mengaktifkan peristiwa siklus hidup grup di Resource Groups](monitor-groups-turn-on.md)
+ [Membuat EventBridge aturan untuk menangkap peristiwa siklus hidup grup dan mempublikasikan pemberitahuan](monitor-groups-create-rule.md)
+ [Mematikan acara siklus hidup grup](monitor-groups-turn-off.md)
+ [Struktur dan sintaks peristiwa siklus hidup Resource Groups](monitor-groups-syntax.md)
# Mengaktifkan peristiwa siklus hidup grup di Resource Groups
Untuk menerima pemberitahuan tentang perubahan siklus hidup pada grup sumber daya, Anda dapat mengaktifkan peristiwa siklus hidup grup. Resource Groups kemudian memberikan informasi tentang perubahan grup Anda ke Amazon EventBridge. Di EventBridge, Anda dapat mengevaluasi dan menindaklanjuti perubahan menggunakan [aturan yang Anda tetapkan dalam EventBridge layanan](monitor-groups-create-rule.md).
**Izin minimum**
Untuk mengaktifkan peristiwa siklus hidup grup di Anda Akun AWS, Anda harus masuk sebagai prinsipal AWS Identity and Access Management (IAM) dengan izin berikut:
`resource-groups:UpdateAccountSettings`
`iam:CreateServiceLinkedRole`
`events:PutRule`
`events:PutTargets`
`events:DescribeRule`
`events:ListTargetsByRule`
`cloudformation:DescribeStacks`
`cloudformation:ListStackResources`
`tag:GetResources`
Saat Anda mengaktifkan peristiwa siklus hidup grup pada awalnya Akun AWS, Resource Groups akan membuat peran [terkait layanan](security_iam_service-linked-roles.md) bernama. `AWSServiceRoleForResourceGroups` Peran terkelola ini memiliki izin untuk menggunakan EventBridge aturan terkelola Resource Groups. Aturan memantau tag yang dilampirkan ke sumber daya Anda dan CloudFormation tumpukan di akun Anda untuk setiap perubahan. Resource Groups kemudian menerbitkan perubahan tersebut ke bus acara default di Amazon EventBridge. Layanan ini juga membuat aturan EventBridge terkelola bernama`[Managed.ResourceGroups.TagChangeEvents](https://console.aws.amazon.com/events/home#/eventbus/default/rules/Managed.ResourceGroups.TagChangeEvents)`. Aturan ini menangkap detail perubahan tag sumber daya Anda. Ini memungkinkan Resource Groups menghasilkan acara keanggotaan EventBridge untuk dikirim ke aturan kustom Anda untuk diproses. EventBridge Aturan Anda kemudian dapat merespons peristiwa dengan mengirimkan pemberitahuan ke target yang dikonfigurasi aturan.
Setelah Anda menyelesaikan langkah-langkah ini, aturan yang mencari acara ini akan mulai menerimanya dalam beberapa menit.
Anda dapat mengaktifkan peristiwa siklus hidup grup dengan menggunakan Konsol Manajemen AWS atau dengan menggunakan perintah dari AWS CLI atau salah satu SDK. APIs
**catatan**
Anda tidak dapat mengaktifkan peristiwa siklus hidup grup jika kuota grup sumber daya Anda terlalu tinggi. Untuk informasi lebih lanjut, tinjau [Melihat kuota layanan](https://docs.aws.amazon.com/servicequotas/latest/userguide/gs-request-quota).
------
#### [ Konsol Manajemen AWS ]
**Untuk mengaktifkan peristiwa siklus hidup grup di konsol Resource Groups**
1. Buka halaman **[Pengaturan](https://console.aws.amazon.com/resource-groups/groups/settings)** di konsol Resource Groups.
1. Di bagian **Acara siklus hidup grup**, pilih sakelar di samping **Pemberitahuan dimatikan**.
1. Pada dialog konfirmasi, pilih **Aktifkan notifikasi**.
Sakelar fitur menampilkan **Pemberitahuan diaktifkan**.
Itu melengkapi bagian pertama dari proses. Setelah mengaktifkan notifikasi acara, Anda dapat [membuat aturan di Amazon EventBridge](monitor-groups-create-rule.md) yang menangkap peristiwa dan mengirimkannya ke spesifik Layanan AWS untuk diproses.
------
#### [ AWS CLI ]
**Untuk mengaktifkan peristiwa siklus hidup grup dengan menggunakan atau AWS CLI AWS SDKs**
Contoh berikut menunjukkan cara menggunakan AWS CLI untuk mengaktifkan peristiwa siklus hidup grup di Resource Groups. Masukkan perintah dengan parameter utama layanan persis seperti yang ditunjukkan. Output menunjukkan status saat ini dan status fitur yang diinginkan.
```
$ aws resource-groups update-account-settings \
--group-lifecycle-events-desired-status ACTIVE
{
"AccountSettings": {
"GroupLifecycleEventsDesiredStatus": "ACTIVE",
"GroupLifecycleEventsStatus": "IN_PROGRESS"
}
}
```
Anda dapat mengonfirmasi bahwa fitur diaktifkan dengan menjalankan perintah contoh berikut. Ketika kedua bidang status menunjukkan nilai yang sama, maka operasi selesai.
```
$ aws resource-groups get-account-settings
{
"AccountSettings": {
"GroupLifecycleEventsDesiredStatus": "ACTIVE",
"GroupLifecycleEventsStatus": "ACTIVE"
}
}
```
Untuk informasi selengkapnya, lihat sumber daya berikut:
+ AWS CLI [— grup [sumber daya aws dan grup sumber daya update-account-settings](https://docs.aws.amazon.com//cli/latest/reference/resource-groups/update-account-settings.html) aws get-account-settings](https://docs.aws.amazon.com//cli/latest/reference/resource-groups/get-account-settings.html)
+ API — [UpdateAccountSettings](https://docs.aws.amazon.com//ARG/latest/APIReference/API_UpdateAccountSettings.html)dan [GetAccountSettings](https://docs.aws.amazon.com//ARG/latest/APIReference/API_GetAccountSettings.html)
------
# Membuat EventBridge aturan untuk menangkap peristiwa siklus hidup grup dan mempublikasikan pemberitahuan
Anda dapat [mengaktifkan peristiwa siklus hidup grup untuk grup sumber daya Anda untuk](monitor-groups-turn-on.md) mempublikasikan peristiwa AWS Resource Groups ke Amazon. EventBridge Kemudian, Anda dapat membuat EventBridge aturan yang menanggapi peristiwa tersebut dengan mengirimkannya ke yang lain Layanan AWS untuk diproses lebih lanjut.
------
#### [ AWS CLI ]
Proses untuk membuat aturan EventBridge yang menangkap peristiwa dan mengirimkannya ke layanan target yang Anda inginkan membutuhkan dua perintah CLI terpisah:
1. [Buat EventBridge aturan untuk menangkap peristiwa yang Anda inginkan](#monitor-cli-create-rule)
1. [Lampirkan target yang dapat memproses peristiwa ke EventBridge aturan](#monitor-cli-attach-target)
Langkah 1: Buat EventBridge aturan untuk menangkap peristiwa
Perintah AWS CLI `[put-rule](https://docs.aws.amazon.com//cli/latest/reference/events/put-rule.html)` contoh berikut membuat EventBridge aturan yang menangkap ***semua*** perubahan peristiwa siklus hidup Resource Groups.
```
$ aws events put-rule \
--name "CatchAllResourceGroupEvents" \
--event-pattern '{"source":["aws.resource-groups"]}'
{
"RuleArn": "arn:aws:events:us-east-1:123456789012:rule/CatchAllResourceGroupEvents"
}
```
Outputnya mencakup Nama Sumber Daya Amazon (ARN) dari aturan baru.
Nilai parameter yang menyertakan string yang dikutip memiliki aturan pemformatan yang berbeda berdasarkan sistem operasi dan shell yang Anda gunakan. Untuk contoh dalam panduan ini, kami menunjukkan perintah yang bekerja pada shell Linux BASH. *Untuk petunjuk tentang memformat string dengan tanda kutip tertanam untuk sistem operasi lain, seperti prompt perintah Windows, lihat [Menggunakan tanda kutip di dalam string di Panduan Pengguna.](https://docs.aws.amazon.com//cli/latest/userguide/cli-usage-parameters-quoting-strings.html#cli-usage-parameters-quoting-strings-containing)AWS Command Line Interface *
Karena string parameter menjadi lebih kompleks, akan lebih mudah dan lebih sedikit rawan kesalahan untuk [menerima nilai parameter dari file teks](https://docs.aws.amazon.com//cli/latest/userguide/cli-usage-parameters-file.html) alih-alih mengetiknya langsung pada baris perintah.
Pola peristiwa berikut membatasi peristiwa hanya untuk yang terkait dengan grup tertentu, yang diidentifikasi oleh ARN-nya. Pola acara ini adalah string JSON kompleks yang jauh lebih tidak dapat dibaca ketika dikompresi menjadi string JSON satu baris, lolos dengan benar. Anda dapat menyimpannya dalam file sebagai gantinya.
Menyimpan pola acara JSON string dalam file. Dalam contoh kode berikut, file tersebut adalah`eventpattern.txt`.
```
{
"source": [ "aws.resource-groups" ],
"detail": {
"group": {
"arn": [ "my-resource-group-arn" ]
}
}
}
```
Kemudian, keluarkan perintah berikut untuk membuat aturan, mengambil pola acara khusus dari file.
```
$ aws events put-rule \
--name "CatchResourceGroupEventsForMyGroup" \
--event-pattern file://eventpattern.txt
{
"RuleArn": "arn:aws:events:us-east-1:123456789012:rule/CatchResourceGroupEventsForMyGroup"
}
```
Untuk menangkap jenis acara Resource Groups lainnya, ganti `--event-pattern` string dengan filter seperti yang disajikan di bagian[Contoh pola acara EventBridge khusus untuk kasus penggunaan yang berbeda](monitor-groups-example-eventbridge-filters.md).
Langkah 2: Lampirkan target yang dapat memproses peristiwa ke EventBridge aturan
Sekarang setelah Anda memiliki aturan yang menangkap peristiwa yang menarik bagi Anda, Anda dapat melampirkan satu atau lebih target untuk melakukan beberapa jenis pemrosesan pada acara tersebut.
AWS CLI `[put-targets](https://docs.aws.amazon.com//cli/latest/reference/events/put-targets.html)`Perintah berikut melampirkan topik Amazon Simple Notification Service (Amazon SNS) bernama `my-sns-topic` ke aturan yang Anda buat pada contoh sebelumnya. Semua pelanggan ke topik menerima pemberitahuan ketika perubahan terjadi pada grup yang ditentukan dalam aturan.
```
$ aws events put-targets \
--rule CatchResourceGroupEventsForMyGroup \
--targets Id=1,Arn=arn:aws:sns:us-east-1:123456789012:my-sns-topic
{
"FailedEntryCount": 0,
"FailedEntries": []
}
```
Pada titik ini, setiap perubahan grup yang cocok dengan pola acara dalam aturan Anda secara otomatis dikirim ke target atau target yang dikonfigurasi. Jika, seperti pada contoh sebelumnya, targetnya adalah topik Amazon SNS, maka semua pelanggan topik menerima pesan yang berisi acara seperti yang dijelaskan dalam. [Struktur dan sintaks peristiwa siklus hidup Resource Groups](monitor-groups-syntax.md)
Untuk informasi selengkapnya, lihat sumber daya berikut:
+ AWS CLI — [aws events put-rule](https://docs.aws.amazon.com//cli/latest/reference/events/put-rule.html) dan [aws](https://docs.aws.amazon.com//cli/latest/reference/events/put-targets.html) events put-target
+ API — [PutRule](https://docs.aws.amazon.com//eventbridge/latest/APIReference/API_PutRule.html)dan [PutTargets](https://docs.aws.amazon.com//eventbridge/latest/APIReference/API_PutTargets.html)
------
## Membuat aturan untuk menangkap hanya jenis peristiwa siklus hidup grup tertentu
Anda dapat membuat aturan dengan pola acara khusus yang hanya menangkap peristiwa yang Anda minati. Untuk detail selengkapnya tentang cara memfilter peristiwa masuk menggunakan pola peristiwa khusus, lihat [ EventBridge peristiwa Amazon](https://docs.aws.amazon.com//eventbridge/latest/userguide/eventbridge-and-event-patterns.html) di *Panduan EventBridge Pengguna Amazon*.
Misalnya, Anda ingin aturan hanya memproses pemberitahuan Resource Groups yang menunjukkan pembuatan grup sumber daya baru. Anda dapat menggunakan pola acara khusus yang mirip dengan contoh berikut.
```
{
"source": [ "aws.resource-groups" ],
"detail-type": [ "ResourceGroups Group State Change" ],
"detail": {
"state-change": "create"
}
}
```
Filter itu hanya menangkap peristiwa yang memiliki nilai persis di bidang yang ditentukan. Untuk daftar lengkap bidang yang tersedia untuk Anda cocokkan, lihat[Struktur dan sintaks peristiwa siklus hidup Resource Groups](monitor-groups-syntax.md).
# Mematikan acara siklus hidup grup
Anda dapat menonaktifkan peristiwa siklus hidup grup agar tidak memancarkan AWS Resource Groups peristiwa ke Amazon. EventBridge Anda dapat melakukan ini dengan menggunakan salah satu Konsol Manajemen AWS atau dengan menggunakan perintah dari AWS CLI atau salah satu SDK APIs.
**catatan**
Mematikan peristiwa siklus hidup grup akan menghapus EventBridge aturan terkelola Resource Groups yang digunakan untuk memindai tag sumber daya dan CloudFormation tumpukan untuk perubahan. Resource Groups tidak dapat lagi meneruskan perubahan tersebut EventBridge. Aturan apa pun EventBridge yang Anda tentukan saat mencari peristiwa Resource Groups berhenti menerima peristiwa untuk diproses. Jika Anda ingin mengaktifkan peristiwa siklus hidup grup lagi di masa mendatang, Anda dapat menonaktifkan aturan. Jika Anda tidak berniat menggunakan aturan itu lagi, Anda dapat menghapusnya. Untuk informasi selengkapnya, lihat [Menonaktifkan atau menghapus EventBridge aturan di Panduan](https://docs.aws.amazon.com//eventbridge/latest/userguide/delete-or-disable-rule.html) Pengguna *Amazon EventBridge *.
Mematikan peristiwa siklus hidup grup ***tidak akan menghapus peran*** terkait layanan. Anda dapat [menghapus peran terkait layanan secara manual](security_iam_service-linked-roles.md#delete-service-linked-role) jika Anda ingin menggunakan IAM. Jika nanti Anda perlu mengaktifkan peristiwa siklus hidup grup lagi dan peran terkait layanan tidak ada, Resource Groups akan membuatnya ulang secara otomatis.
**Izin minimum**
Untuk menonaktifkan peristiwa siklus hidup grup di saat ini Akun AWS, Anda harus masuk sebagai prinsipal AWS Identity and Access Management (IAM) dengan izin berikut:
`resource-groups:UpdateAccountSettings`
`events:DeleteRule`
`events:RemoveTargets`
`events:DescribeRule`
`events:ListTargetsByRule`
------
#### [ Konsol Manajemen AWS ]
**Untuk menonaktifkan pemberitahuan acara siklus hidup grup ke EventBridge**
1. Buka halaman **[Pengaturan](https://console.aws.amazon.com/resource-groups/groups/settings)** di konsol Resource Groups.
1. Di bagian **Acara siklus hidup grup**, pilih sakelar di samping **Pemberitahuan diaktifkan**.
1. Pada dialog konfirmasi, pilih **Matikan notifikasi**.
Sakelar fitur ditampilkan: **Pemberitahuan acara dimatikan**.
Pada titik ini, Resource Groups tidak lagi mengirimkan peristiwa ke bus acara EventBridge default, dan aturan apa pun yang Anda tidak lagi menerima acara pemberitahuan grup untuk diproses. Anda dapat menghapus aturan tersebut secara opsional untuk menyelesaikan pembersihan.
------
#### [ AWS CLI ]
**Untuk menonaktifkan pemberitahuan acara siklus hidup grup ke EventBridge**
Contoh berikut menunjukkan cara menggunakan AWS CLI untuk mematikan peristiwa siklus hidup grup di Resource Groups.
```
$ aws resource-groups update-account-settings \
----group-lifecycle-events-desired-status INACTIVE
{
"AccountSettings": {
"GroupLifecycleEventsDesiredStatus": "INACTIVE",
"GroupLifecycleEventsStatus": "INACTIVE"
}
}
```
------
Untuk informasi selengkapnya, lihat sumber daya berikut:
+ AWS CLI [— grup [sumber daya aws dan grup sumber daya update-account-settings](https://docs.aws.amazon.com//cli/latest/reference/resource-groups/update-account-settings.html) aws get-account-settings](https://docs.aws.amazon.com//cli/latest/reference/resource-groups/get-account-settings.html)
+ API — [UpdateAccountSettings](https://docs.aws.amazon.com//ARG/latest/APIReference/API_UpdateAccountSettings.html)dan [GetAccountSettings](https://docs.aws.amazon.com//ARG/latest/APIReference/API_GetAccountSettings.html)
# Struktur dan sintaks peristiwa siklus hidup Resource Groups
**Topics**
+ [Struktur `detail` lapangan](monitor-groups-syntax-detail.md)
+ [Contoh pola acara EventBridge khusus untuk kasus penggunaan yang berbeda](monitor-groups-example-eventbridge-filters.md)
Peristiwa siklus hidup untuk AWS Resource Groups mengambil bentuk string objek [JSON](https://json.org) dalam format umum berikut.
```
{
"version": "0",
"id": "08f00e24-2e30-ec44-b824-8acddf1ac868",
"detail-type": "ResourceGroups Group ... Change",
"source": "aws.resource-groups",
"account": "123456789012",
"time": "2020-09-29T09:59:01Z",
"region": "us-east-1",
"resources": [
"arn:aws:resource-groups:us-east-1:123456789012:group/MyGroupName"
],
"detail": {
...
}
}
```
Untuk detail tentang bidang yang umum untuk semua EventBridge acara Amazon, lihat [ EventBridge peristiwa Amazon](https://docs.aws.amazon.com//eventbridge/latest/userguide/aws-events.html) di *Panduan EventBridge Pengguna Amazon*. Detail yang spesifik untuk Resource Groups dijelaskan dalam tabel berikut.
| Nama bidang | Tipe | Deskripsi |
| --- | --- | --- |
| detail-type | String | Untuk Resource Groups, `detail-type` bidang selalu merupakan salah satu dari nilai berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ARG/latest/userguide/monitor-groups-syntax.html) |
| source | String | Untuk Resource Groups, nilai ini selalu"aws.resource-groups". |
| resources | Array Nama Sumber Daya Amazon (ARNs) | Bidang ini selalu menyertakan [nama sumber daya Amazon (ARN)](https://docs.aws.amazon.com//general/latest/gr/aws-arns-and-namespaces.html) grup dengan perubahan yang memicu peristiwa ini. Bidang ARNs ini juga dapat menyertakan sumber daya apa pun yang ditambahkan atau dihapus dari grup, jika berlaku. |
| `detail` | String objek JSON | Ini adalah muatan acara. Isi detail bidang bervariasi berdasarkan nilaidetail-type. [Lihat bagian selanjutnya untuk informasi lebih lanjut.](monitor-groups-syntax-detail.md) |
# Struktur `detail` lapangan
`detail`Bidang ini mencakup semua detail spesifik layanan Resource Groups tentang perubahan tertentu. `detail`Bidang dapat mengambil salah satu dari dua bentuk, perubahan status grup atau perubahan keanggotaan, berdasarkan nilai `detail-type` bidang yang dijelaskan di bagian sebelumnya.
**penting**
[Grup sumber daya dalam peristiwa ini diidentifikasi dengan kombinasi ARN grup dan `"unique-id"` bidang yang berisi UUID.](https://wikipedia.org/wiki/Universally_unique_identifier) Dengan menyertakan UUID sebagai bagian dari identitas grup sumber daya, Anda dapat membedakan antara grup yang dihapus dan grup lain yang kemudian dibuat dengan nama yang sama. Kami menyarankan Anda memperlakukan rangkaian ARN dan id unik sebagai kunci untuk grup dalam program Anda yang berinteraksi dengan acara ini.
## Perubahan status grup
`"detail-type": "ResourceGroups Group State Change"`
`detail-type`Nilai ini menunjukkan bahwa keadaan grup itu sendiri, termasuk metadatanya, telah berubah. Perubahan ini terjadi ketika grup dibuat, diperbarui, atau dihapus, seperti yang ditunjukkan oleh `"change"` bidang di dalam`detail`.
Informasi yang disertakan dalam `details` bagian ketika ini `detail-type` ditentukan termasuk bidang yang dijelaskan dalam tabel berikut.
| Nama bidang | Tipe | Deskripsi |
| --- | --- | --- |
| event-sequence | Ganda | Jumlah yang meningkat secara monoton yang menentukan urutan peristiwa untuk kelompok tertentu. Nomor akan disetel ulang saat Anda menghapus grup dan membuat grup lain dengan nama yang sama. |
| group | Objek JSON [`Group`](#monitor-groups-syntax-detail-group-object) | Objek grup yang terkait dengan acara dengan ARN, nama, dan ID uniknya. |
| state-change | String | Jenis perubahan negara yang terjadi. Dapat berupa salah satu dari nilai-nilai berikut:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ARG/latest/userguide/monitor-groups-syntax-detail.html) |
| old-state | Objek JSON GroupState | Keadaan kelompok sebelum perubahan. Objek hanya mencakup nilai-nilai properti yang berubah. |
| `new-state` | Objek JSON GroupState | Keadaan grup setelah perubahan. Objek hanya mencakup nilai-nilai properti yang berubah. |
Objek `group` JSON berisi unsur-unsur yang dijelaskan dalam tabel berikut.
| Nama bidang | Tipe | Deskripsi |
| --- | --- | --- |
| arn | String | ARN dari grup. |
| name | String | Nama grup yang ramah. |
| unique-id | PANDUAN | Nilai GUID unik yang membedakan antara grup yang dihapus dan grup berbeda yang kemudian dibuat dengan nama dan ARN yang sama. Gunakan rangkaian ARN dan nilai ini sebagai kunci unik untuk grup saat menggunakan peristiwa ini dalam kode Anda. |
Objek `GroupState` JSON berisi unsur-unsur yang dijelaskan dalam tabel berikut.
| Nama bidang | Tipe | Deskripsi |
| --- | --- | --- |
| description | String | Deskripsi kelompok sumber daya yang disediakan pelanggan. |
| resource-query | Objek JSON ResourceQuery | Sebuah representasi JSON dari query yang mendefinisikan anggota grup. Bidang ini hadir hanya untuk grup berdasarkan kueri. Sintaks bidang ini ditentukan oleh [tipe data ResourceQuery API](https://docs.aws.amazon.com//organizations/latest/APIReference/API_ResourceQuery.html). Contoh ini termasuk dalam contoh acara [Buat](#monitor-groups-syntax-detail-state-change-create) dan [Perbarui](#monitor-groups-syntax-detail-state-change-update). |
| group-configuration | Objek JSON Configuration | Representasi JSON dari parameter konfigurasi yang terkait dengan grup yang ditautkan layanan. Untuk informasi selengkapnya, lihat [Konfigurasi layanan untuk grup sumber daya](https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html) di Referensi AWS Resource Groups API. |
Masing-masing contoh kode berikut menggambarkan isi `detail` bidang untuk setiap `state-change` jenis.
### Buat
`"state-change": "create"`
Acara ini menunjukkan bahwa grup baru telah dibuat. Acara ini membawa semua properti metadata grup yang ditetapkan selama pembuatan grup. Acara ini biasanya diikuti oleh salah satu acara keanggotaan grup lainnya kecuali grup tersebut kosong. Properti yang memiliki nilai nol tidak ditampilkan di badan acara.
Contoh peristiwa berikut menunjukkan grup sumber daya yang baru dibuat bernama`my-service-group`. Dalam contoh ini, grup menggunakan kueri berbasis tag yang hanya cocok dengan instans Amazon Elastic Compute Cloud (Amazon EC2) yang memiliki tag. `"project"="my-service"`
```
{
"version": "0",
"id": "08f00e24-2e30-ec44-b824-8acddf1ac868",
"detail-type": "ResourceGroups Group State Change",
"source": "aws.resource-groups",
"account": "123456789012",
"time": "2020-09-29T09:59:01Z",
"region": "us-east-1",
"resources": [
"arn:aws:resource-groups:us-east-1:123456789012:group/my-service-group"
],
"detail": {
"event-sequence": 1.0,
"state-change": "create",
"group": {
"arn": "arn:aws:resource-groups:us-east-1:123456789012:group/my-service-group",
"name": "my-service-group",
"unique-id": "3dd07ab7-3228-4410-8cdc-6c4a10fcceea"
},
"new-state": {
"resource-query": {
"type": "TAG_FILTERS_1_0",
"query": "{
\"ResourceTypeFilters\": [\"AWS::EC2::Instance\"],
\"TagFilters\": [{\"Key\":\"project\", \"Values\":[\"my-service\"}]
}"
}
}
}
}
```
### Perbarui
`"state-change": "update"`
Acara ini menunjukkan bahwa grup yang ada telah dimodifikasi dalam beberapa cara. Acara ini hanya membawa properti yang berubah dari keadaan sebelumnya. Properti yang belum berubah tidak ditampilkan di badan acara.
Contoh peristiwa berikut menunjukkan bahwa kueri berbasis tag di grup sumber daya contoh sebelumnya telah dimodifikasi untuk juga menyertakan sumber daya volume Amazon EC2 dalam grup.
```
{
"version": "0",
"id": "08f00e24-2e30-ec44-b824-8acddf1ac868",
"detail-type": "ResourceGroups Group State Change",
"source": "aws.resource-groups",
"account": "123456789012",
"time": "2020-09-29T09:59:01Z",
"region": "us-east-1",
"resources": [
"arn:aws:resource-groups:us-east-1:123456789012:group/my-service-group"
],
"detail": {
"event-sequence": 3.0,
"state-change": "update",
"group": {
"arn": "arn:aws:resource-groups:us-east-1:123456789012:group/my-service-group",
"name": "my-service",
"unique-id": "3dd07ab7-3228-4410-8cdc-6c4a10fcceea"
},
"new-state": {
"resource-query": {
"type": "TAG_FILTERS_1_0",
"query": "{
\"ResourceTypeFilters\": [\"AWS::EC2::Instance\", \"AWS::EC2::Volume\"],
\"TagFilters\": [{\"Key\":\"project\", \"Values\":[\"my-service\"}]
}"
}
},
"old-state": {
"resource-query": {
"type": "TAG_FILTERS_1_0",
"query": "{
\"ResourceTypeFilters\": [\"AWS::EC2::Instance\"],
\"TagFilters\": [{\"Key\":\"Project\", \"Values\":[\"my-service\"}]
}"
}
}
}
}
```
### Delete
`"state-change": "delete"`
Acara menunjukkan bahwa grup yang ada telah dihapus. Bidang detail tidak mencakup metadata tentang grup selain identifikasinya. `event-sequence`Bidang diatur ulang setelah acara ini seperti, menurut definisi, peristiwa terakhir untuk ini `arn` dan`unique-id`.
```
{
"version": "0",
"id": "08f00e24-2e30-ec44-b824-8acddf1ac868",
"detail-type": "ResourceGroups Group State Change",
"source": "aws.resource-groups",
"account": "123456789012",
"time": "2020-09-29T09:59:01Z",
"region": "us-east-1",
"resources": [
"arn:aws:resource-groups:us-east-1:123456789012:group/my-service"
],
"detail": {
"event-sequence": 4.0,
"state-change": "delete",
"group": {
"arn": "arn:aws:resource-groups:us-east-1:123456789012:group/my-service",
"name": "my-service",
"unique-id": "3dd07ab7-3228-4410-8cdc-6c4a10fcceea"
}
}
}
```
## Perubahan keanggotaan grup
`"detail-type": "ResourceGroups Group Membership Change"`
`detail-type`Nilai ini menunjukkan bahwa keanggotaan grup diubah oleh sumber daya yang ditambahkan atau dihapus dari grup. Ketika ini `detail-type` ditentukan, `resources` bidang tingkat atas mencakup ARN grup yang keanggotaannya diubah dan ARNs sumber daya apa pun yang ditambahkan atau dihapus dari grup.
Informasi yang disertakan dalam `details` bagian ketika ini `detail-type` ditentukan termasuk bidang yang dijelaskan dalam tabel berikut.
| Nama bidang | Tipe | Deskripsi |
| --- | --- | --- |
| event-sequence | Ganda | Jumlah yang meningkat secara monoton yang menunjukkan urutan peristiwa untuk kelompok tertentu. Nomor disetel ulang saat grup dihapus dan ID uniknya berubah. |
| group | Objek JSON Group | Mengidentifikasi objek grup yang terkait dengan acara dengan ARN, nama, dan ID uniknya. |
| `resources` | Array objek ResourceChange JSON | Berbagai sumber daya yang keanggotaan grupnya telah berubah. `ResourceChange`Objek ini berisi bidang berikut untuk setiap sumber daya: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ARG/latest/userguide/monitor-groups-syntax-detail.html) |
Contoh kode berikut mengilustrasikan isi acara untuk jenis perubahan keanggotaan yang khas. Contoh ini menunjukkan satu sumber daya yang ditambahkan ke grup, dan satu sumber daya dihapus dari grup.
```
{
"version": "0",
"id": "08f00e24-2e30-ec44-b824-8acddf1ac868",
"detail-type": "ResourceGroups Group Membership Change",
"source": "aws.resource-groups",
"account": "123456789012",
"time": "2020-09-29T09:59:01Z",
"region": "us-east-1",
"resources": [
"arn:aws:resource-groups:us-east-1:123456789012:group/my-service",
"arn:aws:ec2:us-east-1:123456789012:instance/i-abcd1111",
"arn:aws:ec2:us-east-1:123456789012:instance/i-efef2222"
],
"detail": {
"event-sequence": 2.0,
"group": {
"arn": "arn:aws:resource-groups:us-east-1:123456789012:group/my-service",
"name": "my-service",
"unique-id": "3dd07ab7-3228-4410-8cdc-6c4a10fcceea"
},
"resources": [
{
"membership-change": "add",
"arn": "arn:aws:ec2:us-east-1:123456789012:instance/i-abcd1111",
"resource-type": "AWS::EC2::Instance"
},
{
"membership-change": "remove",
"arn": "arn:aws:ec2:us-east-1:123456789012:instance/i-efef2222",
"resource-type": "AWS::EC2::Instance"
}
]
}
}
```
# Contoh pola acara EventBridge khusus untuk kasus penggunaan yang berbeda
Contoh pola peristiwa EventBridge kustom berikut memfilter peristiwa yang dihasilkan oleh Resource Groups hanya untuk yang Anda minati untuk aturan dan target acara tertentu.
Dalam contoh kode berikut, jika kelompok atau sumber daya tertentu diperlukan, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri.
Semua acara Resource Groups
```
{
"source": [ "aws.resource-groups" ]
}
```
Status grup atau acara perubahan keanggotaan
Contoh kode berikut adalah untuk semua perubahan *status* grup.
```
{
"source": [ "aws.resource-groups" ],
"detail-type": [ "ResourceGroups Group State Change " ]
}
```
Contoh kode berikut adalah untuk semua perubahan *keanggotaan* grup.
```
{
"source": [ "aws.resource-groups" ],
"detail-type": [ "ResourceGroups Group Membership Change" ]
}
```
Acara untuk grup tertentu
```
{
"source": [ "aws.resource-groups" ],
"detail": {
"group": {
"arn": [ "my-group-arn" ]
}
}
}
```
Contoh sebelumnya menangkap perubahan pada grup yang ditentukan. Contoh berikut melakukan hal yang sama dan juga menangkap perubahan ketika grup adalah sumber daya anggota grup lain.
```
{
"source": [ "aws.resource-groups" ],
"resources": [ "my-group-arn" ]
}
```
Acara untuk sumber daya tertentu
Anda hanya dapat memfilter acara perubahan keanggotaan grup untuk sumber daya anggota tertentu.
```
{
"source": [ "aws.resource-groups" ],
"detail-type": [ "ResourceGroups Group Membership Change " ],
"resources": [ "arn:aws:ec2:us-east-1:123456789012:instance/i-b188560f" ]
}
```
Acara untuk jenis sumber daya tertentu
Anda dapat menggunakan awalan yang cocok dengan ARNs untuk mencocokkan peristiwa untuk jenis sumber daya tertentu.
```
{
"source": [ "aws.resource-groups" ],
"resources": [
{ "prefix": "arn:aws:ec2:us-east-1:123456789012:instance" }
]
}
```
Atau, Anda dapat menggunakan pencocokan tepat dengan menggunakan `resource-type` pengidentifikasi, yang berpotensi cocok pada lebih dari satu jenis secara ringkas. Tidak seperti contoh sebelumnya, contoh berikut hanya cocok dengan peristiwa perubahan keanggotaan grup karena peristiwa perubahan status grup tidak menyertakan `resources` bidang di `detail` bidangnya.
```
{
"source": [ "aws.resource-groups" ],
"detail": {
"resources": {
"resource-type": [ "AWS::EC2::Instance", "AWS::EC2::Volume" ]
}
}
}
```
Semua acara penghapusan sumber daya
```
{
"source": [ "aws.resource-groups" ],
"detail-type": [ "ResourceGroups Group Membership Change" ],
"detail": {
"resources": {
"membership-change": [ "remove" ]
}
}
}
```
Semua peristiwa penghapusan sumber daya untuk sumber daya tertentu
```
{
"source": [ "aws.resource-groups" ],
"detail-type": [ "ResourceGroups Group Membership Change" ],
"detail": {
"resources": {
"membership-change": [ "remove" ],
"arn": [ "arn:aws:ec2:us-east-1:123456789012:instance/i-b188560f" ]
}
}
}
```
Anda tidak dapat menggunakan `resources` array **tingkat atas** yang digunakan dalam contoh pertama di bagian ini untuk jenis pemfilteran peristiwa ini. Itu karena sumber daya di `resources` elemen tingkat atas mungkin merupakan sumber daya yang ditambahkan ke grup dan acara tersebut akan tetap cocok. Dengan kata lain, contoh kode berikut mungkin mengembalikan peristiwa yang tidak terduga. Sebagai gantinya, gunakan sintaks yang ditunjukkan pada contoh sebelumnya.
```
{
"source": [ "aws.resource-groups" ],
"detail-type": [ "ResourceGroups Group Membership Change" ],
"resources": [ "arn:aws:ec2:us-east-1:123456789012:instance/i-b188560f" ],
"detail": {
"resources": {
"membership-change": [ "remove" ]
}
}
}
```