Membuat bus

Anda membuat bus denganCreateEventBus, misalnyaaws eventsv2 create-event-bus --name orders. Nama adalah satu-satunya parameter yang diperlukan. Pada saat pembuatan, Anda juga dapat mengatur deskripsi, jumlah hari bus menyimpan peristiwa, AWS KMS kunci yang mengenkripsinya, dan tag. Panggilan kembali sekaligus dengan bus di CREATING negara bagian; publikasikan ke bus atau buat pelanggan di atasnya setelah DescribeEventBus melaporkanACTIVE.

Membuat bus dengan AWS CLI

Perintah berikut membuat bus bernama orders yang menyimpan peristiwa selama 30 hari, mengenkripsinya dengan AWS KMS kunci Anda, dan membawa satu tag.

aws eventsv2 create-event-bus \
    --name orders \
    --description "Order events from the checkout service" \
    --storage-configuration RetentionPeriodInDays=30 \
    --encryption-configuration KmsKeyIdentifier=arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab \
    --tags team=orders

Tabel berikut mencantumkan apa yang diterima setiap parameter.

Parameter	Apa yang diterimanya
--name	Diperlukan. 1 hingga 256 karakter: huruf, digit, titik, tanda hubung, dan garis bawah, dimulai dengan huruf atau digit. Nama harus unik di akun Anda di Wilayah; membuat bus kedua dengan nama yang sama gagalResourceAlreadyExistsException.
--description	Hingga 512 karakter.
--storage-configuration	RetentionPeriodInDays, dari 1 hingga 365. Hilangkan dan bus mempertahankan acara selama 1 hari. Anda dapat mengubah periode nanti denganUpdateEventBus. Lihat Memilih periode retensi.
--encryption-configuration	KmsKeyIdentifier: ID kunci, kunci ARN, nama alias, atau alias ARN dari kunci yang dikelola AWS KMS pelanggan. Hilangkan dan mengen EventBridge kripsi peristiwa dengan kunci yang AWS dimiliki. Untuk kebijakan utama kebutuhan utama, lihatMengenkripsi peristiwa pada Bus Acara Kustom.
--tags	Peta kunci tag ke nilai, misalnyateam=orders,env=prod. Untuk kontrol akses berbasis tag, lihatTindakan, sumber daya, dan kunci kondisi untuk Bus Acara Kustom.

Respons mengembalikan bus ARN, yang digunakan setiap panggilan selanjutnya di bus. ARN berakhir dengan pengenal yang EventBridge menghasilkan, jadi Anda tidak dapat membuatnya dari nama.

{
    "EventBusArn": "arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef",
    "Name": "orders",
    "Description": "Order events from the checkout service",
    "EncryptionConfiguration": {
        "KmsKeyIdentifier": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
    },
    "StorageConfiguration": {
        "RetentionPeriodInDays": 30,
        "RetentionWindowStartTime": "2026-09-21T16:00:00+00:00"
    },
    "State": "CREATING",
    "CreationTime": "2026-09-21T16:00:00+00:00"
}

Jelaskan bus dengan ARN-nya sampai State sekarangACTIVE.

aws eventsv2 describe-event-bus \
    --event-bus-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef

Untuk membuat bus dengan sebagai CloudFormation gantinya, lihatMembuat sumber daya Bus Acara Kustom dengan CloudFormation. Untuk tindakan IAM yang diperlukan untuk membuat dan mendeskripsikan bus, lihatTindakan, sumber daya, dan kunci kondisi untuk Bus Acara Kustom.

Memilih periode retensi

Bus menyimpan setiap acara yang diterimanya untuk jumlah hari masukStorageConfiguration.RetentionPeriodInDays, dari 1 hingga 365; hilangkan dan bus menyimpan acara selama 1 hari. Retensi adalah apa yang memungkinkan pelanggan memulai dari titik di masa lalu, menjeda dan melanjutkan tanpa kehilangan acara, dan membaca peristiwa lagi setelah kegagalan. Periode yang lebih lama membutuhkan lebih banyak penyimpanan. Anda dapat mengubah periode nanti denganUpdateEventBus.

aws eventsv2 create-event-bus \
    --name orders \
    --storage-configuration RetentionPeriodInDays=30

DescribeEventBuspengembalianRetentionWindowStartTime, titik paling awal yang dapat dibaca pelanggan. Untuk mengirimkan acara yang disimpan ke pelanggan, lihatMemutar ulang peristiwa yang disimpan ke pelanggan.

Status bus dan apa yang masing-masing memungkinkan

Membuat, memperbarui, dan menghapus bus tidak sinkron. Setiap negara bagian selain ACTIVE menolak beberapa operasi, dan tiga negara bagian yang gagal membawa tanda StateReason yang memberi tahu Anda alasannya. Tabel berikut mencantumkan negara bagian yang dilalui bus dan apa yang dapat Anda lakukan di masing-masing.

Status	Bagaimana bus sampai di sana	Yang dapat Anda lakukan
CREATING	CreateEventBusKembali dan bus sedang disiapkan.	Jelaskan dan tunggu. Anda tidak dapat mempublikasikan, memperbarui, atau menghapus bus, atau membuat pelanggan atau sumber acara di dalamnya.
ACTIVE	Pembuatan atau pembaruan selesai.	Semuanya: publikasikan, buat pelanggan dan sumber acara, perbarui, bagikan, hapus.
CREATE_FAILED	Pembuatan gagal, yang terjadi ketika EventBridge tidak dapat menggunakan AWS KMS kunci yang Anda beri nama.	Hapus busnya. Tidak ada lagi yang diterima. BacaStateReason, perbaiki kunci atau kebijakannya, dan buat bus lagi.
UPDATING	UpdateEventBussedang mengubah konfigurasi enkripsi. Pembaruan lain tidak melewati status ini.	Publikasikan dan kirimkan seperti biasa. Anda tidak dapat memperbarui atau menghapus bus sampai kembali keACTIVE.
UPDATE_FAILED	Pembaruan enkripsi gagal, sekali lagi karena tidak EventBridge dapat menggunakan kunci.	Bus terus berjalan dengan konfigurasi sebelumnya. Coba lagi pembaruan setelah Anda memperbaiki penyebabnya, atau menghapus bus.
DELETING	DeleteEventBuskembali.	Tunggu. Anda tidak dapat membuat pelanggan atau sumber peristiwa di bus yang sedang dihapus.
DELETE_FAILED	Penghapusan menemukan pelanggan atau sumber peristiwa yang tidak dicabut.	Hapus bus lagi setelah pelanggan dan sumber acara dihapus atau dicabut. Tidak ada lagi yang diterima.

Menghapus bus yang memiliki pelanggan

DeleteEventBusberhasil hanya ketika setiap pelanggan dan sumber peristiwa di bus dihapus atau dicabut. Pelanggan yang dibuat akun lain diperhitungkan. Anda tidak dapat menghapus pelanggan akun itu sendiri, jadi mintalah pemilik untuk menghapusnya atau mencabutnya denganRevokeResource; lihatMencabut pelanggan atau sumber acara. Jika pelanggan dibuat antara cek Anda dan penghapusan, bus mendaratDELETE_FAILED; berurusan dengan pelanggan baru dan hapus lagi.

Memulihkan dari perubahan kunci yang gagal

Keduanya yang gagal menyatakan bahwa bus yang sedang berjalan dapat dijangkau berasal dari AWS KMS kunci. Jika pembaruan ke kunci baru gagal, coba lagi UpdateEventBus setelah Anda memperbaiki kebijakan atau pemberian kunci tersebut. Jika kunci baru itu sendiri tidak dapat digunakan, coba ulang dapat memberi nama kunci yang berbeda, karena EventBridge tidak mengadopsi kunci yang gagal. Jangan menonaktifkan, menghapus, atau menghapus EventBridge akses ke kunci sebelumnya sampai DescribeEventBus menunjukkan bus ACTIVE dengan kunci baru; bus yang kehilangan kunci lamanya sebagian melalui perubahan hanya dapat diperbaiki dengan mengembalikan kunci itu, atau dihapus. Untuk izin utama, lihatMengenkripsi peristiwa pada Bus Acara Kustom.