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
mc-cmd
Required
用于移除事件通知的 S3 服务 alias 和存储桶。 例如:
mc event rm play/mybucket
ARN
mc-cmd
Required
通知目标的 Amazon Resource Name (ARN)。
MinIO 服务器在启动时会为每个已配置的通知目标输出一个 ARN。 更多信息请参见 存储桶通知。
可在存储桶上运行 mc event ls 获取 ARN。
--event
mc-cmd
Optional
添加事件时指定的事件类型。 这些条目必须与添加事件时使用的值一致。 如果没有事件与事件类型列表匹配,命令将返回 no notification configuration matched 错误。
使用逗号 , 分隔可指定多个事件。 支持的事件类型请参见 支持的存储桶事件。
默认移除 ALIAS 存储桶中、与 ARN 通知目标关联且对所有事件类型触发的事件。
可通过在存储桶上运行 mc event ls 获取所使用的事件类型。 使用下表将命令输出中的事件类型转换为 mc event rm 命令所需的条目:
mv event ls 的输出 | 要使用的事件类型 |
|---|---|
s3:objectAccessed | get |
s3:objectCreated | put |
s3:objectRemoved | delete |
例如,如果 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
事件类型的顺序无关紧要,只需包含与该事件中已有类型相同的条目即可。
--force
mc-cmd
Optional
移除 ALIAS 存储桶中与 ARN 通知目标关联的所有事件。
--prefix
mc-cmd
Optional
命令移除存储桶通知时使用的存储桶前缀。
例如,若 ALIAS 为 play/mybucket,且 --prefix 为 photos,则命令仅移除 play/mybucket/photos.
--suffix
mc-cmd
Optional
命令移除存储桶通知时使用的存储桶后缀。
例如,若 ALIAS 为 play/mybucket,且 --suffix 为 .jpg,则命令仅移除 play/mybucket/*.jpg.
全局标志
此命令支持 全局标志 中的任意选项。
示例
从存储桶中移除事件通知
以下命令会移除某个存储桶上的所有事件通知触发器。 该命令假设 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 命令 可能 仍能按文档说明工作,但此类 用法需要你自行承担风险。
本页部分内容改编自 MinIO 对象存储文档,© 2020–至今 MinIO, Inc.,依据 CC BY 4.0 授权,由 Silo 项目转换与维护。归属与署名
本页为非官方中文翻译。如与英文原文有出入,以英文原文为准。