文档

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: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
Optional

移除 ALIAS 存储桶中与 ARN 通知目标关联的所有事件。

--prefix
Optional

命令移除存储桶通知时使用的存储桶前缀。

例如,若 ALIASplay/mybucket,且 --prefixphotos,则命令仅移除 play/mybucket/photos.

--suffix
Optional

命令移除存储桶通知时使用的存储桶后缀。

例如,若 ALIASplay/mybucket,且 --suffix.jpg,则命令仅移除 play/mybucket/*.jpg.

全局标志

此命令支持 全局标志 中的任意选项。

示例

从存储桶中移除事件通知

以下命令会移除某个存储桶上的所有事件通知触发器。 该命令假设 MinIO 部署中至少配置了一个 bucket notification target:

mc event rm myminio/mydata arn:minio:sqs::primary:webhook
mc event rm ALIAS ARN
  • ALIAS 替换为要在其上添加存储桶通知事件的 MinIO 部署 alias。例如:

    myminio/mydata

  • ARN 替换为通知目标 ARN.

行为

S3 兼容性

mc 命令行工具以兼容 AWS S3 API 为目标构建,并针对 MinIO 和 AWS S3 进行了测试,以验证预期的功能与行为。

对于其他 S3 兼容服务,MinIO 不提供任何保证,因为这些服务的 S3 API 实现未知, 因此不在支持范围内。虽然 mc 命令 可能 仍能按文档说明工作,但此类 用法需要你自行承担风险。