对象存储服务 OBS-设置桶的消息通知配置:请求消息元素
请求消息元素
在此请求中,需要在请求的消息体中配置桶的通知,通知的配置信息以XML格式上传。具体的配置元素如表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 合法值: 上传对象操作可以取以下值:
或者使用通配符支持所有上传操作
删除对象操作可以取以下值:
或者使用通配符支持所有删除操作
父元素:FunctionStageConfiguration |
若是父元素 FunctionStageConfiguration添加后,本元素是必选项 |