Welcome to the upcoming version of the MinIO Documentation! The content on this page is under active development and may change at any time. If you can't find what you're looking for, check our legacy documentation. Thank you for your patience.

Bucket Notifications

MinIO bucket notifications allow administrators to send notifications to supported external services on certain object or bucket events. MinIO supports bucket and object-level S3 events similar to the Amazon S3 Event Notifications.

MinIO bucket notifications are available only with minio server deployments. MinIO Gateway does not support bucket notifications.

Supported Notification Targets

MinIO supports publishing event notifications to the following targets:

Target

Description

AMQP (RabbitMQ)

Publish notifications to an AMQP service such as RabbitMQ.

See Publish Events to AMQP (RabbitMQ) for a tutorial.

MQTT

Publish notifications to an MQTT service.

See Publish Events to MQTT for a tutorial.

NATS

Publish notifications to a NATS service.

See Publish Events to NATS for a tutorial.

NSQ

Publish notifications to a NSQ service.

See Publish Events to NSQ for a tutorial

Elasticsearch

Publish notifications to a Elasticsearch service.

See Publish Events to Elasticsearch for a tutorial.

Kafka

Publish notifications to a Kafka service.

See Publish Events to Kafka for a tutorial.

MySQL

Publish notifications to a MySQL service.

See Publish Events to MySQL for a tutorial.

PostgreSQL

Publish notifications to a PostgreSQL service.

See Publish Events to PostgreSQL for a tutorial.

Redis

Publish notifications to a Redis service.

See Publish Events to Redis for a tutorial.

webhook

Publish notifications to a Webhook service.

See Publish Events to Webhook for a tutorial.

Supported S3 Event Types

MinIO bucket notifications are compatible with Amazon S3 Event Notifications. This section lists all supported events.

Object Events

MinIO supports triggering notifications on the following S3 object events:

s3:ObjectRemoved:DeleteMarkerCreated
s3:ObjectRemoved:Delete
s3:ObjectCreated:PutRetention
s3:ObjectCreated:PutLegalHold
s3:ObjectCreated:Put
s3:ObjectCreated:Post
s3:ObjectCreated:Copy
s3:ObjectCreated:CompleteMultipartUpload
s3:ObjectAccessed:Head
s3:ObjectAccessed:GetRetention
s3:ObjectAccessed:GetLegalHold
s3:ObjectAccessed:Get

Replication Events

MinIO supports triggering notifications on the following S3 replication events:

s3:Replication:OperationCompletedReplication
s3:Replication:OperationFailedReplication
s3:Replication:OperationMissedThreshold
s3:Replication:OperationNotTracked
s3:Replication:OperationReplicatedAfterThreshold

ILM Transition Events

MinIO supports triggering notifications on the following S3 ILM transition events:

s3:ObjectRestore:Post
s3:ObjectRestore:Completed
s3:ObjectTransition:*
s3:ObjectTransition:Failed
s3:ObjectTransition:Complete

Global Events

MinIO supports triggering notifications on the following global events. You can only listen to these events through the ListenNotification API:

s3:BucketCreated
s3:BucketRemoved