`mc event add`

语法

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

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

EXAMPLE

以下命令为所有事件创建新的事件通知触发器PUT和DELETE操作mydata桶上的myminioMinIO 部署：

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

Brackets[]表示可选参数。
共享同一行的参数是相互依赖的。
使用竖线分隔的参数|操作符是互斥的。

将示例复制到文本编辑器中，根据需要修改，然后在终端/Shell中运行命令。

参数

ALIAS

必需

MinIO别名以及命令添加新事件通知的目标存储桶。例如：

mc event add play/mybucket

ARN

必需

TheAmazon Resource Name (ARN)通知目标。

MinIO 服务器在启动时会为每个已配置的通知目标输出一个 ARN。请参阅存储桶通知欲了解更多信息。

--event

可选

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

支持以下值：

put
get
delete

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

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

看支持的存储桶事件有关与每个受支持值关联的 S3 事件的详细列表。

忽略已存在的， p: 可选
如果存在匹配的触发器，则指示 MinIO 忽略指定的事件触发器。

--prefix

可选

指定的存储桶前缀中--event可以触发存储桶通知。

例如，给定一个ALIAS of play/mybucket和一个--prefix of photos, only events inplay/mybucket/photos触发存储桶通知。

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

--suffix

可选

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

例如，给定一个ALIAS of play/mybucket和一个--suffix of .jpg, only events inplay/mybucket/*.jpg触发存储桶通知。

省略此项，则无论后缀如何，都会为所有对象触发事件。

全局标志

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

示例

为存储桶添加事件通知

Example

以下命令为所有 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 Compatibility

Themc命令行工具专为兼容 AWS S3 API 而构建，并已通过 MinIO 和 AWS S3 测试，确保功能与行为符合预期。

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