归档提示:当前旧文档站已停止维护, 请访问新的 Silo 文档站。

文档

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 命令 可能 仍能按文档说明工作,但此类 用法需要你自行承担风险。