对象存储

产品文档

对象存储

设置事件通知

OSS支持事件通知功能,您可以指定某些资源发生相关操作时及时进行回调通知。事件通知是异步进行的,不影响OSS操作。事件通知常见以下应用场景,例如:

有新数据从图片内容分享平台、音视频平台上传到OSS。

OSS上的相关内容发生了更新。

OSS上的重要文件被删除。

您可以为存储空间启用事件通知功能,以便每次发生这些事件时都向目标发送通知消息。本部分介绍如何使用 OSS 控制台启用事件通知。 有关将事件通知 REST API 的信息,请参阅事件的通知-API

事件通知支持的类型:OSS可以为以下事件类型发送通知

事件通知支持的目标:事件通知消息可以发送到的目标

控制台设置事件通知:控制台设置事件通知

事件通知支持的类型和目标

您在为存储空间配置事件通知时,必须指定要针对哪些事件类型进行通知以及希望通知发送到哪些目标。

OSS可以为以下事件类型发送通知

事件类型 描述
s3:ObjectCreated:* 创建Object的行为,包含Put Object,Post Object,Copy Object,Complete Multipart Upload
s3:ObjectCreated:Put 使用Put Object上传文件
s3:ObjectCreated:Post 使用Post Object上传文件
s3:ObjectCreated:Copy 使用Put Object-Copy复制文件
s3:ObjectCreated:CompleteMultipartUpload 完成分片上传
s3:ObjectRemoved:* 删除Object的行为,包含Delete Object
s3:ObjectRemoved:Delete 删除文件

事件通知消息可以发送到的目标:

  • HTTP(S): 按照您配置的回调URL,当Bucket中事件通知触发时,OSS会向回调URL发送指定格式的通知内容,通知方式支持HTTP(S)。

控制台设置事件通知

1.登录京东云控制台,选择对象存储->空间管理->高级设置,选择 事件通知

2.点击【创建规则】,打开创建规则页面。

事件通知

3.在 名称 框中,输入规则名称。

说明

  • 您的bucket最多可以创建100条规则。
  • 名称限制256个字节,由字母,数字,下滑线(_),中滑线(-)组成。

4.在 事件类型 下拉列表中,选择一个或多个需要进行消息通知的事件。

说明

  • 事件类型对应OSS资源的不同操作,具体类型和含义请参下文中OSS可以为以下事件类型发送通知
  • 您可以选择多个想要触发通知的事件。
  • 同样的事件不可以多次配置在同一资源上(重叠的前后缀)。
  • 同样的事件可以配置发送到不同的目标。
  • 需要特别注意的是,对于每个存储空间,单个事件不要配置多个相互重叠的前缀或后缀,事件通知服务将按序依次匹配,匹配成功则发出消息通知并终止匹配。
  • 执行顺序以服务端规则为准,与控制台展示顺序存在不一致可能。

5.在 资源描述 处,添加前缀、后缀,完成对资源的描述,达到筛选文件的效果。

说明

  • 资源描述:可以是前缀、后缀以及前后缀,请注意不同资源的描述不能有交集。
  • 前缀与后缀:设置Object的前后缀可以达到只关注bucket中部分Object的目标。 例如:
    • 要关注bucket中所有的文件,则前缀、后缀都不填。
    • 要关注bucket中目录jdcloudoss下的所有文件,则前缀填 jdcloudoss/,后缀不填。
    • 要关注bucket中所有的.jpg的图片,则前缀不填,后缀填 .jpg。
    • 要关注bucket中目录jdcloudoss下的.mp3格式的影片,则前缀填 jdcloudoss/,后缀填 .mp3。

6.在 发送到 下拉框中,选择【http(s)】,完成接收终端的设置。

说明

  • 【http(s)】 :OSS会向此地址发布消息,您可输入最多5个回调地址。必须为完整的URL,需指定http协议。了解更多请参考回调通知

7.点击【保存】。

说明

  • 发动到选择【http(s)】时,点击保存OSS会向事件通知目标发送一条测试消息,为了您服务的安全,请完成回调服务器设置签名认证,从而OSS会完成对该地址的订阅。
  • 消息通知格式参见消息通知

8.此外,您可通过控制台,编辑或者删除事件通知规则。

更新时间:2021-01-26 13:13:12
文档反馈 docs feedback