`mc event add`

语法

The 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 资源名称 (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 命令可能按文档记录的方式工作，但任何此类使用均须自行承担风险。