本文介绍在 TOS 设置事件通知规则的具体步骤。
背景信息
事件通知概述
前提条件
已基于 vefaas-golang-tos-trigger 模板,创建函数服务并发布,具体操作,请参见创建函数和发布函数。
注意
异步函数不支持接受 TOS 事件,为事件通知功能创建函数时,请勿开启异步任务。
注意事项
- 一个存储桶最多只能创建 10 条事件通知规则。
- 一个对象不能匹配多个包含了相同事件类型的规则,即同一个存储桶内,不同规则间类型+前后缀的组合范围不允许重叠。
操作步骤
登录对象存储控制台。
在左侧导航栏,单击桶列表,单击目标桶名称。
在左侧导航栏,选择基础设置 > 事件通知,在事件通知页面,单击创建规则。
在创建事件通知页面,设置如下参数。
参数 | 说明 |
---|
基础设置 | 事件名称 | 设置事件通知的名称,命名规范如下: - 同一存储桶下创建的事件名称不能重复。
- 长度不超过 255 个字符。
|
前缀 | 设置需要匹配对象的前缀信息。
例如将前缀设置为 test/,则会筛选 test 目录下的对象。 |
后缀 | 设置需要匹配对象的后缀信息。
例如将后缀设置为 .png,则会筛选所有格式为 png 的对象。 说明 如果前后缀均未设置,则会匹配存储桶内所有对象。 |
事件类型 | 事件 | 选择需要通知的事件。TOS 支持的事件列表,请参见事件列表。 注意 如果您在不同的规则中选择了相同的事件类型,则该事件类型匹配的对象范围不能重叠,即一个对象不能匹配多个包含了相同事件类型的规则。
例如您创建了规则 A,为后缀为 png 的对象设置了 PutObject 的事件通知,那么规则 B 中 PutObject 事件的匹配对象就不能包含后缀为 png 的对象,如果包含,规则将创建失败。 |
数据目标 | 函数服务 | 选择需要投递的函数服务。单击添加一行,可以选择多个函数服务,最多可以设置 5 个函数服务。 说明 - 如果您没有可选的函数服务,您可以登录函数服务控制台创建,具体步骤,请参见创建函数。
- 事件通知功能 V2 版本接口已上线,新接口将原来同一事件仅支持推送至一个目标,优化为支持推送至多个不同的目标。强烈建议您尽快切换成 V2 版本接口,否则可能会产生因版本不兼容导致的报错。详细信息,请参见对象存储事件通知功能接口变更说明。
|
单击确定。
说明
- 事件通知规则创建完成后,目标函数服务会自动创建一个与事件名称相同的触发器,您可以登录函数服务控制台,单击目标函数服务查看。
- 事件通知规则创建完成后,将在 5 分钟后生效。
其他操作
- 编辑事件通知规则:单击目标规则操作列的编辑,即可修改事件通知规则。
- 删除事件通知规则:单击目标规则操作列的删除,在弹出的对话框中单击删除,即可删除事件通知规则。