`mc event add`

語法

mc event add 命令會將事件通知觸發器新增至儲存桶。

MinIO 會自動將觸發的事件傳送至已設定的通知目標。

範例

以下命令會為 myminio MinIO 部署上的 mydata 儲存桶建立所有 PUT 和 DELETE 作業的新事件通知觸發器

mc event add --event "put,delete" myminio/mydata arn:aws:sqs::primary:target

指定的 ARN 對應於 myminio 部署上已設定的儲存桶通知目標。

語法

此命令具有以下語法：

mc [GLOBALFLAGS] event add \
                 [--event "string"]  \
                 [--ignore-existing] \
                 [--prefix "string"] \
                 [--suffix "string"] \
                 ALIAS               \
                 ARN

中括號 [] 表示選用參數。
在同一行中的參數是相互依賴的。
使用管道符號 | 分隔的參數是互斥的。

將範例複製到文字編輯器，並在終端機/Shell 中執行命令之前，根據需要進行修改。

參數

ALIAS

必填

MinIO 別名和要新增事件通知的儲存桶。例如：

mc event add play/mybucket

ARN

必填

通知目標的 Amazon Resource Name (ARN)。

MinIO 伺服器會在伺服器啟動時為每個已設定的通知目標輸出一個 ARN。請參閱儲存桶通知以取得更多資訊。

--event

選用

MinIO 為其產生儲存桶通知的事件。

支援以下值：

put
get
delete

使用逗號 , 分隔符號指定多個值。值之間不要加入任何空白字元。

如果未指定，則預設為 put,delete,get。

請參閱支援的儲存桶事件，以取得與每個支援值相關聯的 S3 事件的詳細清單。

ignore-existing, p: 選用
如果已存在相符的觸發器，則指示 MinIO 忽略指定的事件觸發器。

--prefix

選用

指定的 --event 可以觸發儲存桶通知的儲存桶前綴。

例如，假設 ALIAS 為 play/mybucket，而 --prefix 為 photos，則只有 play/mybucket/photos 中的事件會觸發儲存桶通知。

省略此項則會觸發儲存桶中所有前綴和物件的事件。

--suffix

選用

指定的 --event 可以觸發儲存桶通知的儲存桶後綴。

例如，假設 ALIAS 為 play/mybucket，而 --suffix 為 .jpg，則只有 play/mybucket/*.jpg 中的事件會觸發儲存桶通知。

省略此項則會觸發所有物件的事件，無論後綴為何。

全域標誌

此命令支援任何全域標誌。

範例

將事件通知新增至儲存桶

範例

以下命令會為儲存桶上的所有 S3 PUT、GET 和 DELETE 操作新增一個新的事件通知觸發器。該命令假設 MinIO 部署至少有一個已設定的儲存桶通知目標

mc event add myminio/mydata arn:minio:sqs::primary:webhook

語法

mc event add ALIAS ARN

將 ALIAS 取代為 MinIO 部署的別名，以及要在其上新增儲存桶通知事件的儲存桶。例如：

myminio/mydata
將 ARN 取代為通知目標 ARN。

行為

支援的儲存桶事件

下表列出支援的 mc event add 值及其對應的 S3 事件

支援的值	對應的 S3 事件
`put`	`s3:ObjectCreated:CompleteMultipartUpload` `s3:ObjectCreated:Copy` `s3:ObjectCreated:DeleteTagging` `s3:ObjectCreated:Post` `s3:ObjectCreated:Put` `s3:ObjectCreated:PutLegalHold` `s3:ObjectCreated:PutRetention` `s3:ObjectCreated:PutTagging`
`get`	`s3:ObjectAccessed:Head` `s3:ObjectAccessed:Get` `s3:ObjectAccessed:GetRetention` `s3:ObjectAccessed:GetLegalHold`
`delete`	`s3:ObjectRemoved:Delete` `s3:ObjectRemoved:DeleteMarkerCreated`
`replica`	`s3:Replication:OperationCompletedReplication` `s3:Replication:OperationFailedReplication` `s3:Replication:OperationMissedThreshold` `s3:Replication:OperationNotTracked` `s3:Replication:OperationReplicatedAfterThreshold`
`ilm`	`s3:ObjectTransition:Failed` `s3:ObjectTransition:Complete` `s3:ObjectRestore:Post` `s3:ObjectRestore:Completed`
`scanner`	`s3:Scanner:ManyVersions` `s3:Scanner:BigPrefix`

如需有關所列 S3 事件的更完整文件，請參閱 S3 支援的事件類型。

S3 相容性

mc 命令列工具是為與 AWS S3 API 相容而建置，並已使用 MinIO 和 AWS S3 進行測試，以確保預期的功能和行為。

MinIO 不保證其他 S3 相容服務的適用性，因為它們的 S3 API 實作方式不明，因此不受支援。雖然 mc 命令可能會如文件所述正常運作，但任何此類使用行為都將由您自行承擔風險。