Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Struktur `bidang` detail
**catatan**
AWS Fitur Group Lifecycle Events (GLE) AWS Resource Groups tidak lagi terbuka untuk pelanggan baru. Untuk kemampuan yang mirip dengan Group Lifecycle Events (GLE), lihat EventBridge-based alternatif yang disarankan. Untuk informasi selengkapnya, lihat [Fitur Acara Siklus Hidup Grup dari AWS Resource Groups perubahan ketersediaan](resource-groups-gle-availability-change.md).
Bid `detail` ang ini mencakup semua detail khusus layanan Grup Sumber Daya tentang perubahan tertentu. Bid `detail` ang 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 oleh 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 berbeda yang kemudian dibuat dengan nama yang sama. Kami menyarankan Anda memperlakukan penggabungan ARN dan id unik sebagai kunci untuk grup dalam program Anda yang berinteraksi dengan peristiwa ini.
## Perubahan status grup
`"detail-type": "ResourceGroups Group State Change"`
`detail-type`Nilai ini menunjukkan bahwa status 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 `detail-type` ini ditentukan termasuk bidang yang dijelaskan dalam tabel berikut.
| Nama bidang | Tipe | Deskripsi |
| --- | --- | --- |
| event-sequence | Ganda | Angka yang meningkat secara monoton yang menentukan urutan peristiwa untuk kelompok tertentu. Nomor diatur 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 keadaan yang terjadi. Dapat berupa salah satu dari nilai-nilai berikut:+ [`create`](#monitor-groups-syntax-detail-state-change-create)
+ [`update`](#monitor-groups-syntax-detail-state-change-update)
+ [`delete`](#monitor-groups-syntax-detail-state-change-delete) |
| 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. |
Ob `group` jek JSON berisi elemen yang dijelaskan dalam tabel berikut.
| Nama bidang | Tipe | Deskripsi |
| --- | --- | --- |
| arn | String | ARN kelompok. |
| name | String | Nama ramah kelompok. |
| unique-id | GUIDE | Nilai GUID unik yang membedakan antara grup yang dihapus dan grup berbeda yang kemudian dibuat dengan nama dan ARN yang sama. Gunakan penggabungan ARN dan nilai ini sebagai kunci unik untuk grup saat mengonsumsi peristiwa ini dalam kode Anda. |
Ob `GroupState` jek JSON berisi elemen yang dijelaskan dalam tabel berikut.
| Nama bidang | Tipe | Deskripsi |
| --- | --- | --- |
| description | String | Deskripsi grup sumber daya yang disediakan pelanggan. |
| resource-query | Objek JSON ResourceQuery | Representasi JSON dari query yang mendefinisikan anggota grup. Bidang ini hanya ada 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 disertakan dalam contoh [ acara [ Buat ](#monitor-groups-syntax-detail-state-change-create) dan Per ](#monitor-groups-syntax-detail-state-change-update) barui. |
| group-configuration | Objek JSON Configuration | Representasi JSON dari parameter konfigurasi yang terkait dengan grup terkait layanan. Untuk informasi selengkapnya, lihat Konfigurasi [ layanan untuk grup sumber daya ](https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html) di Refer AWS Resource Groups ensi API. |
Masing-masing contoh kode berikut menggambarkan isi `detail` bidang untuk setiap `state-change` jenis.
### Buat
`"state-change": "create"`
Acara 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 null 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"`
Peristiwa ini menunjukkan bahwa grup yang ada telah dimodifikasi dalam beberapa cara. Acara hanya membawa properti yang berubah dari keadaan sebelumnya. Properti yang belum berubah tidak ditampilkan di badan acara.
Peristiwa contoh berikut menunjukkan bahwa kueri berbasis tag dalam 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"`
Peristiwa menunjukkan bahwa grup yang ada telah dihapus. Bidang detail tidak menyertakan metadata tentang grup selain identifikasinya. Bid `event-sequence` ang diatur ulang setelah peristiwa ini karena, 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 ke atau dihapus dari grup. Ketika ini `detail-type` ditentukan, `resources` bidang tingkat atas mencakup ARN grup yang keanggotaannya diubah dan ARN dari sumber daya apa pun yang ditambahkan ke atau dihapus dari grup.
Informasi yang disertakan dalam `details` bagian ketika `detail-type` ini ditentukan termasuk bidang yang dijelaskan dalam tabel berikut.
| Nama bidang | Tipe | Deskripsi |
| --- | --- | --- |
| event-sequence | Ganda | Angka yang meningkat secara monoton yang menunjukkan urutan peristiwa untuk kelompok tertentu. Nomor diatur 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 | Array sumber daya yang keanggotaan grupnya telah berubah.
Ob `ResourceChange` jek ini berisi bidang berikut untuk setiap sumber daya:+ `membership-change`— Nilai adalah salah satu `"add"` atau`"remove"`.
+ `arn`— ARN sumber daya ditambahkan atau dihapus.
+ `resource-type`— Jenis sumber daya ditambahkan atau dihapus. |
Contoh kode berikut menggambarkan isi acara untuk jenis perubahan keanggotaan yang khas. Contoh ini menunjukkan satu sumber daya 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"
}
]
}
}
```