文档中心

对象存储

请输入

事件通知

设置事件通知推送至 Kafka

为了实时掌握 TOS 内资源变动，您可以配置事件通知监控存储桶内资源变动，当发生指定事件时，系统会自动向消息队列 KafKa 发送通知。本文介绍设置事件通知推送至 Kafka 的前提条件、操作步骤等内容。

背景信息

消息队列 Kafka 版是一款基于 Apache Kafka 构建的分布式消息中间件服务。对象存储 TOS 支持将事件通知消息推送到消息队列 Kafka 版。如果您在消息队列 Kafka 配置了消费者，消息队列 Kafka 版接收到消息后会传递给下游的消费者，消费者在接收到消息后，会按照预定义的业务逻辑执行相关操作。

前提条件

已创建 Kafka 实例，具体操作，请参见创建实例。

已创建 Kafka Topic，具体操作，请参见创建 Topic。

已创建 SASL 用户，且该用户的密码类型必须为 PLAIN，并具备 Kafka Topic 写入权限（即已开启用户 All Permitted 功能），具体操作，请参见创建 SASL 用户。

注意事项

一个存储桶最多只能创建 30 条事件通知规则。

一个对象不能匹配多个包含了相同事件类型的规则，即同一个存储桶内，不同规则间类型+前后缀的组合范围不允许重叠。

一个存储桶中所有事件通知规则的 JSON 描述总大小不能超过 20 KB。

Kafka 实例不建议配置 IP 白名单。TOS 事件通知采用服务端推送方式，推送源 IP 不固定，因此无法提供固定 IP 列表。配置 IP 白名单会导致事件推送失败、消息丢失。安全管控请使用 PLAIN 账号密码权限机制。

创建事件通知规则

登录对象存储控制台。

在左侧导航栏，单击桶列表，在桶列表页面单击目标桶名称。

在左侧导航栏，选择基础设置 > 事件通知。

在事件通知页面，单击创建规则。

在创建事件通知页面，设置如下参数。

参数			说明
基础设置	事件名称	设置事件通知的名称，命名规范如下：同一存储桶下创建的事件名称不能重复。长度不超过 255 个字符。
		前缀	设置需要匹配对象的前缀信息。例如将前缀设置为 test/，则会筛选 test 目录下的对象。
		后缀	设置需要匹配对象的后缀信息。例如将后缀设置为 .png，则会筛选所有格式为 png 的对象。说明如果前后缀均未设置，则会匹配存储桶内所有对象。
事件类型	事件	选择需要通知的事件。TOS 支持的事件列表，请参见事件列表。注意如果您在不同的规则中选择了相同的事件类型，则该事件类型匹配的对象范围不能重叠，即一个对象不能匹配多个包含了相同事件类型的规则。例如您创建了规则 A，后缀为 png 的对象设置了 PutObject 的事件通知，那么规则 B 中 PutObject 事件的匹配对象就不能包含后缀为 png 的对象，如果包含，规则将创建失败。
数据目标	目标类型	选择 Kafka，单击添加一行，可以选择，最多可以设置 5 个 Kafka。
		角色	单击点击授权，TOS 会自动创建 TOSNotiKafkaRole 角色，用于授权 TOS 访问 Kafka 服务。
		实例 ID	选择 Kafka 实例。说明如果您没有可选的 Kafka 实例，您可以登录消息队列 Kafka 版控制台创建实例，具体步骤，请参见创建实例。
		Topic	选择 Kafka Topic。
		用户名	选择 Kafka SASL 用户。

完成配置后，单击确定。

说明

事件通知规则创建完成后，将在 5 分钟后生效。

查看事件通知消息

您可以在消息队列 Kafka 版控制台查看事件通知消息，具体操作如下：

登录消息队列 Kafka版控制台。

在顶部菜单栏中，选择实例所在的地域。

在实例列表页面，单击绑定事件通知规则的 Kafka 实例名称。

在实例详情页面，单击消息查询页签。

选择按时间查询、Topic，设置分区为全部，指定查询的时间范围，单击查询。

页面展示符合筛选条件的消息列表，其中包括 Topic 名称、分区、位点、Key、Value、消息大小和存储时间。您可以在 Value 列获取事件通知的具体内容，关于事件通知参数详细介绍，请参见事件通知格式。

最近更新时间：2026.09.08 14:42:47

这个页面对您有帮助吗？

有用

无用