View a markdown version of this page

Struktur bidang detail - AWS Resource Groups
Perubahan status grupPerubahan keanggotaan grup

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.

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. 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-typeNilai 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 dalamdetail.

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 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:
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. Contoh ini disertakan dalam contoh acara Buat dan Per 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 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 bernamamy-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 danunique-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-typeNilai 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"
            }
        ]
    }
}