Este conteúdo não está disponível no idioma selecionado.

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

  1. In the Notifications tab, click Create notification.
  2. Enter the bucket name.
  3. Select the event types to monitor.
  4. Select the target notification destination.
  5. 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

  1. Open the Notifications tab.
  2. Select the notification and click Edit.
  3. Update the required fields.
  4. Click Save.
  5. 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

  1. In the Ceph Dashboard, select Object Gateway > Bucket notifications.
  2. Click the Notifications tab.
  3. Review the table of existing bucket notifications.
  4. 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

  1. Go to the Notifications tab.
  2. Select the bucket notification that you want to delete.
  3. Click Delete.
  4. Confirm the deletion when prompted.

Results

The selected bucket notification is deleted.

Red Hat logoGithubredditYoutubeTwitter

Aprender

Experimente, compre e venda

Comunidades

Sobre a documentação da Red Hat

Ajudamos os usuários da Red Hat a inovar e atingir seus objetivos com nossos produtos e serviços com conteúdo em que podem confiar. Explore nossas atualizações recentes.

Tornando o open source mais inclusivo

A Red Hat está comprometida em substituir a linguagem problemática em nosso código, documentação e propriedades da web. Para mais detalhes veja o Blog da Red Hat.

Sobre a Red Hat

Fornecemos soluções robustas que facilitam o trabalho das empresas em plataformas e ambientes, desde o data center principal até a borda da rede.

Theme

© 2026 Red Hat
Voltar ao topo