oyd
/
minio
6
1
Fork 0
Code Issues Pull Requests Releases Wiki Activity

docs: fix missing event types in notifications (#10944)

Browse Source
master
Harshavardhana 4 years ago committed by GitHub
parent 73e308079a
commit 9263be8cca
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 31 additions and 13 deletions
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Show Stats Download Patch File Download Diff File
  1. 44
      docs/bucket/notifications/README.md

44
docs/bucket/notifications/README.md
Unescape View File

@ -1,18 +1,36 @@
# MinIO Bucket Notification Guide [![Slack](https://slack.min.io/slack?type=svg)](https://slack.min.io)
Events occurring on objects in a bucket can be monitored using bucket event notifications.
NOTE: gateway mode does not support bucket notifications (except NAS gateway).
Event types supported by MinIO server are
| Supported Event Types | | |
| :---------------------- | ------------------------------------------ | ------------------------------------- |
| `s3:ObjectCreated:Put` | `s3:ObjectCreated:CompleteMultipartUpload` | `s3:ObjectAccessed:Head` | |
| `s3:ObjectCreated:Post` | `s3:ObjectRemoved:Delete` | `s3:ObjectRemoved:DeleteMarkerCreated` | |
| `s3:ObjectCreated:Copy` | `s3:ObjectAccessed:Get` | `s3:ObjectAccessed:GetLegalHold` | |
| `s3:ObjectCreated:PutRetention` | `s3:ObjectAccessed:Get` | `s3:ObjectCreated:PutLegalHold` | `s3:ObjectAccessed:GetRetention` |
| `s3:Replication:OperationFailedReplication` | `s3:BucketCreated` | `s3:BucketRemoved` | |
Events occurring on objects in a bucket can be monitored using bucket event notifications.
> NOTE: Gateway mode does not support bucket notifications (except NAS gateway).
Various event types supported by MinIO server are
| Supported Object Event Types | | |
| :---------------------- | ------------------------------------------ | ------------------------------------- |
| `s3:ObjectCreated:Put` | `s3:ObjectCreated:CompleteMultipartUpload` | `s3:ObjectAccessed:Head` |
| `s3:ObjectCreated:Post` | `s3:ObjectRemoved:Delete` | `s3:ObjectRemoved:DeleteMarkerCreated` |
| `s3:ObjectCreated:Copy` | `s3:ObjectAccessed:Get` | |
| `s3:ObjectCreated:PutRetention` | `s3:ObjectCreated:PutLegalHold` | |
| `s3:ObjectAccessed:GetRetention` | `s3:ObjectAccessed:GetLegalHold` | |
| Supported Replication Event Types |
| :------------ |
| `s3:Replication:OperationFailedReplication` |
| `s3:Replication:OperationCompletedReplication` |
| `s3:Replication:OperationNotTracked` |
| `s3:Replication:OperationMissedThreshold` |
| `s3:Replication:OperationReplicatedAfterThreshold` |
| Supported ILM Transition Event Types |
| :----- |
| `s3:ObjectRestore:Post` |
| `s3:ObjectRestore:Completed` |
| Supported Global Event Types (Only supported through ListenNotification API) |
| :----- |
| `s3:BucketCreated` |
| `s3:BucketRemoved` |
Use client tools like `mc` to set and listen for event notifications using the [`event` sub-command](https://docs.min.io/docs/minio-client-complete-guide#events). MinIO SDK's [`BucketNotification` APIs](https://docs.min.io/docs/golang-client-api-reference#SetBucketNotification) can also be used. The notification message MinIO sends to publish an event is a JSON message with the following [structure](https://docs.aws.amazon.com/AmazonS3/latest/dev/notification-content-structure.html).

Write Preview
Loading…
Cancel
Save