对象存储服务 OBS-设置桶的消息通知配置:请求消息元素

时间:2023-11-03 16:44:59

请求消息元素

在此请求中,需要在请求的消息体中配置桶的通知,通知的配置信息以XML格式上传。具体的配置元素如表1描述。

表1 桶的通知服务配置元素

名称

描述

是否必选

NotificationConfiguration

配置桶事件通知的根元素,如果子元素为空,说明 消息通知 功能处于关闭状态。

类型:Container

父元素:无

子元素:0个或多个FunctionStageConfiguration

FunctionStageConfiguration

配置函数服务的元素。

类型:Container

父元素:NotificationConfiguration

子元素:Id,Filter,FunctionStage,一个或多个Event

FunctionStage

函数服务中函数的URN,当OBS检测到桶中发生特定的事件后,将会发送消息至函数服务调用执行该函数。

类型:String

父元素:FunctionStageConfiguration

若添加父元素FunctionStageConfiguration,本元素是必选项

Id

每项事件通知配置的唯一标识,若是用户未指定ID,系统将自动分配一个ID。

类型:String

父元素:FunctionStageConfiguration

Filter

Object的元素,用以保存过滤对象名的一组规则。

类型:Container

父元素:FunctionStageConfiguration

子元素: Object

Object

定义过滤规则的元素,该规则用以匹配对象名前缀和后缀。

类型:Container

父元素:Filter

子元素:一个或者多个FilterRule

FilterRule

定义过滤规则键值对的元素。

类型:Container

父元素:Object

子元素:Name,Value

Name

指定规则按对象名前缀或后缀进行过滤。

类型:String

父元素:FilterRule

合法值:prefix或者suffix

Value

指定的对象名关键字,根据Name元素定义的前缀或后缀,输入需要过滤的对象的关键字信息,字符越长匹配精度越高,最大可支持1024个字符。

类型:String

父元素:FilterRule

Event

需要发布通知消息的事件类型。

说明:

在一个FunctionStageConfiguration配置项中可以添加多个事件类型。

类型:String

合法值:

上传对象操作可以取以下值:

  • ObjectCreated:Put
  • ObjectCreated:Post
  • ObjectCreated:Copy
  • ObjectCreated:CompleteMultipartUpload

或者使用通配符支持所有上传操作

  • ObjectCreated:*

删除对象操作可以取以下值:

  • ObjectRemoved:Delete
  • ObjectRemoved:DeleteMarkerCreated

或者使用通配符支持所有删除操作

  • ObjectRemoved:*

父元素:FunctionStageConfiguration

若是父元素 FunctionStageConfiguration添加后,本元素是必选项

support.huaweicloud.com/api-obs/obs_04_0039.html