このコンテンツは選択した言語では利用できません。
Chapter 12. Managing bucket notifications in Ceph Object Gateway
Learn how bucket notifications map S3 events to configured notification destinations to enable event-driven workflows.
Bucket notifications define which S3 events generate messages and where those messages should be delivered. Each rule includes the bucket name, the event types to monitor, and the notification destination that receives the events. When the specified events occur, the Object Gateway sends structured event records to the configured destination.
Bucket notifications form the dynamic part of the event-notification framework. Notification destinations define where events go, and bucket notifications define when events should be triggered.
Characteristics of bucket notifications
Bucket notifications have the following characteristics:
- Multiple notifications per bucket
- A bucket can have multiple event mappings.
- Reusability
- A notification destination can be referenced by multiple notifications.
- Granularity
- Notifications can be created for specific event types or object prefixes/suffixes.
- Dependency
- A notification destination must exist before creating a bucket notification.
How bucket notifications work
The following workflow describes how bucket notifications function:
- An administrator configures the notification in the Dashboard.
- The notification references a previously created notification destination.
- The Object Gateway tracks events that occur on the bucket.
- When an event occurs, the gateway generates an event record.
- The gateway delivers the event to the configured destination endpoint.
Use cases
Bucket notifications support several real-world use cases, including:
- Triggering pipelines when new objects are uploaded.
- Synchronizing metadata to external systems.
- Automating cleanup or archival workflows.
- Generating alerts when objects are deleted.
- Integrating bucket events with third-party analytics and processing tools.
12.1. Creating a bucket notification リンクのコピーリンクがクリップボードにコピーされました!
Create a bucket notification rule that maps S3 events to a notification destination.
Prerequisites
Make sure that you have the following prerequisites in place:
- At least one notification destination exists.
- You know the bucket name and the required event types.
Procedure
- In the Notifications tab, click Create notification.
- Enter the bucket name.
- Select the event types to monitor.
- Select the target notification destination.
- Click Save.
Results
A new bucket notification is created and associated with the selected destination.
12.2. Editing a bucket notification リンクのコピーリンクがクリップボードにコピーされました!
Modify an existing bucket notification rule.
Prerequisites
Before you begin, make sure that you have the updated event types or destination information.
Procedure
- Open the Notifications tab.
- Select the notification and click Edit.
- Update the required fields.
- Click Save.
- Verify the updates in the table.
Results
The bucket notification is updated with the new configuration.
12.3. Listing bucket notifications リンクのコピーリンクがクリップボードにコピーされました!
View the list of bucket notifications configured for an Object Gateway bucket.
Prerequisites
Before you begin, make sure that you have permission to view bucket notifications.
Procedure
- In the Ceph Dashboard, select Object Gateway > Bucket notifications.
- Click the Notifications tab.
- Review the table of existing bucket notifications.
- Optional: Apply filters or use the search field to refine the list.
Results
All configured bucket notifications are displayed.
12.4. Deleting bucket notifications リンクのコピーリンクがクリップボードにコピーされました!
Delete a bucket notification that is no longer required.
Prerequisites
Before you begin, make sure that the notification is not required by production services.
Procedure
- Go to the Notifications tab.
- Select the bucket notification that you want to delete.
- Click Delete.
- Confirm the deletion when prompted.
Results
The selected bucket notification is deleted.