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.

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:ObjectAccessed:Get

s3:ObjectAccessed:GetLegalHold

s3:ObjectAccessed:GetRetention

s3:ObjectAccessed:Head

s3:ObjectCreated:CompleteMultipartUpload

s3:ObjectCreated:Copy

s3:ObjectCreated:DeleteTagging

s3:ObjectCreated:Post

s3:ObjectCreated:Put

s3:ObjectCreated:PutLegalHold

s3:ObjectCreated:PutRetention

s3:ObjectCreated:PutTagging

s3:ObjectRemoved:Delete

s3:ObjectRemoved:DeleteMarkerCreated

Specify the wildcard * character to select all events related to a prefix:

s3:ObjectAccessed:*: Selects all s3:ObjectAccessed-prefixed events.

s3:ObjectCreated:*: Selects all s3:ObjectCreated-prefixed events.

s3:ObjectRemoved:*: Selects all s3:ObjectRemoved-prefixed events.

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

Specify the wildcard * character to select all s3:Replication events:

s3:Replication:*

ILM Transition Events

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

s3:ObjectRestore:Post

s3:ObjectRestore:Completed

s3:ObjectTransition:Failed

s3:ObjectTransition:Complete

Specify the wildcard * character to select all events related to a prefix:

s3:ObjectTransition:*: Selects all s3:ObjectTransition-prefixed events.

s3:ObjectRestore:*: Selects all s3:ObjectRestore-prefixed events.

Global Events

MinIO supports triggering notifications on the following global events. You can only listen to these events through the ListenNotification <https://min.io/docs/minio/linux/developers/go/API.html#listennotification-context-context-context-prefix-suffix-string-events-string-chan-notification-info> API:

s3:BucketCreated

s3:BucketRemoved