`mc event add`

语法

mc event add 命令用于向存储桶添加事件通知触发器。

MinIO 会自动将触发的事件发送到配置的通知目标。

EXAMPLE

以下命令为 myminio MinIO部署上的 mydata 存储桶创建一个新的事件通知触发器，用于所有 PUT 和 DELETE 操作：

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

指定的ARN对应于 myminio 部署上配置的存储桶通知目标。

SYNTAX

该命令具有以下语法：

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

方括号 [] 表示可选参数。
参数在同一行表示它们是相互依赖的。
使用管道 | 运算符分隔的参数是相互排斥的。

在终端/壳中运行命令之前，将示例复制到文本编辑器中并按需进行修改。

参数

ALIAS

Required

该命令将向其添加新事件通知的 MinIO alias 和存储桶。例如：

mc event add play/mybucket

ARN

Required

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

MinIO 服务器在启动时为每个配置的通知目标输出一个 ARN。有关更多信息，请参阅 Bucket Notifications 。

--event

Optional

MinIO 生成存储桶通知的事件。

支持以下值：

put
get
delete

使用逗号 , 分隔符指定多个值。不要在值之间添加任何空格。

如果未指定，则默认为 put,delete,get 。

请参阅支持的存储桶事件以获取与每个支持值相关的 S3 事件的详细列表。

ignore-existing, p: Optional
如果匹配的触发器已经存在，则指示 MinIO 忽略指定的事件触发器。

--prefix

Optional

指定 :mc-command:`~mc event add --event` 可以触发存储桶通知的存储桶前缀。

例如，给定 play/mybucket 的 ALIAS 和 photos 的 --prefix，则只有 play/mybucket/photos 中的事件才会触发存储桶通知。

省略此选项将导致事件对存储桶中的所有前缀和对象触发。

--suffix

Optional

指定 --event 可触发存储桶通知的存储桶后缀。

例如，给定一个 ALIAS 为 play/mybucket 和一个 --suffix 为 .jpg ，则只有 play/mybucket/*.jpg 中的事件才会触发存储桶通知。

省略此选项将导致事件对存储桶中的所有对象触发，无论它们的后缀是什么。

全局标记

此命令支持任何全局标志。

示例

将事件通知添加到存储桶

Example

以下命令为所有事件添加新的事件通知触发器 S3 对存储桶进行 PUT 、 GET 和 DELETE 操作。命令假设 MinIO 部署至少配置了一项存储桶通知目标:

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

Syntax

mc event add ALIAS ARN

将 ALIAS 替换为 MinIO 部署的 alias 以及要添加桶通知事件的存储桶。例如：

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 Supported Event Types。

S3兼容性

mc 命令行工具是为了与 AWS S3 API 兼容而构建的，并且已经过测试，以确保在与 MinIO 和 AWS S3 配合使用时，功能和行为符合预期。

MinIO 不对其他 S3 兼容服务提供任何保证，因为它们的 S3 API 实现是未知的，因此不受支持。尽管 mc 命令可能如文档中所述工作，但任何此类使用都是您自己的风险。

商业支持购买咨询