mc event rm
语法
mc event rm 命令用于从存储桶中移除事件通知触发器。
mc event remove 命令与 mc event rm 功能等效。
以下命令会在 myminio MinIO 部署的 mydata 存储桶上,
移除指定 bucket notification target
的已配置事件通知:
mc event rm myminio/mydata arn:aws:sqs::primary:target
命令语法如下:
mc [GLOBALFLAGS] event remove \
ALIAS \
[ARN] \
[--event "string"] \
[--force] \
[--prefix "string"] \
[--suffix "string"]
方括号
[]表示可选参数。同一行中的参数彼此相互依赖。
使用管道符
|分隔的参数彼此互斥。
请先将示例复制到文本编辑器中并按需修改,再在终端 / shell 中运行命令。
mc [GLOBALFLAGS] event remove [FLAGS] ALIAS ARN
参数
- ALIAS
- Required
用于移除事件通知的 S3 服务 alias 和存储桶。 例如:
mc event rm play/mybucket
- ARN
- Required
通知目标的 Amazon Resource Name (ARN)。
MinIO 服务器在启动时会为每个已配置的通知目标输出一个 ARN。 更多信息请参见 存储桶通知。
可在存储桶上运行
mc event ls获取 ARN。
- --event
- Optional
添加事件时指定的事件类型。 这些条目**必须**与添加事件时使用的值一致。 如果没有事件与事件类型列表匹配,命令将返回
no notification configuration matched错误。使用逗号
,分隔可指定多个事件。 支持的事件类型请参见 支持的存储桶事件。默认移除
ALIAS存储桶中、与ARN通知目标关联且对所有事件类型触发的事件。可通过在存储桶上运行
mc event ls获取所使用的事件类型。 使用下表将命令输出中的事件类型转换为mc event rm命令所需的条目:mv event ls的输出要使用的事件类型
s3:objectAccessedgets3:objectCreatedputs3:objectRemoveddelete例如,如果
mc event ls返回如下内容:arn:minio:sqs::mytest:webhook s3:ObjectAccessed:*,s3:ObjectCreated:* Filter:
使用以下命令移除该事件:
mc event rm alias/bucket arn:minio:sqs::mytest:webhook --event get,put
事件类型的顺序无关紧要,只需包含与该事件中已有类型相同的条目即可。
全局标志
此命令支持 全局标志 中的任意选项。
示例
从存储桶中移除事件通知
以下命令会移除某个存储桶上的所有事件通知触发器。 该命令假设 MinIO 部署中至少配置了一个 bucket notification target:
mc event rm myminio/mydata arn:minio:sqs::primary:webhook
行为
S3 兼容性
mc 命令行工具以兼容 AWS S3 API 为目标构建,并针对 MinIO 和 AWS S3 进行了测试,以验证预期的功能与行为。
对于其他 S3 兼容服务,MinIO 不提供任何保证,因为这些服务的 S3 API 实现未知, 因此不在支持范围内。虽然 mc 命令 可能 仍能按文档说明工作,但此类 用法需要你自行承担风险。