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 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

2. Lampirkan target yang dapat memproses peristiwa ke EventBridge aturan

Langkah 1: Buat EventBridge aturan untuk menangkap peristiwa

Perintah AWS CLI put-rule 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.

catatan

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. 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 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 adalaheventpattern.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 bagianContoh pola acara EventBridge khusus untuk kasus penggunaan yang berbeda.

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 CLIput-targetsPerintah 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

Untuk informasi selengkapnya, lihat sumber daya berikut:

• AWS CLI— aws events put-rule dan aws events put-target

• API — PutRuledan PutTargets

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 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, lihatStruktur dan sintaks peristiwa siklus hidup Resource Groups.