mc event rm
语法
mc event rm 命令用于从存储桶中移除事件通知触发器。
mc event remove 命令与 mc event rm 功能等效。
以下命令会在 myminio MinIO 部署的 mydata 存储桶上, 移除指定 bucket notification target 的已配置事件通知:
命令语法如下:
- 方括号
[]表示可选参数。 - 同一行中的参数彼此相互依赖。
- 使用管道符
|分隔的参数彼此互斥。
请先将示例复制到文本编辑器中并按需修改,再在终端 / shell 中运行命令。
参数
ALIAS
mc-cmd
Required
用于移除事件通知的 S3 服务 alias 和存储桶。 例如:
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 返回如下内容:
使用以下命令移除该事件:
事件类型的顺序无关紧要,只需包含与该事件中已有类型相同的条目即可。
--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:
行为
S3 兼容性
mc 命令行工具以兼容 AWS S3 API 为目标构建,并针对 MinIO 和 AWS S3 进行了测试,以验证预期的功能与行为。
对于其他 S3 兼容服务,MinIO 不提供任何保证,因为这些服务的 S3 API 实现未知, 因此不在支持范围内。虽然 mc 命令 可能 仍能按文档说明工作,但此类 用法需要你自行承担风险。