Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# 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"
}
]
}
}
```