配置DIS通知
本节介绍如何在OBS控制台配置DIS通知。
背景知识
请参见DIS通知简介。
约束与限制
- 一个桶中最多同时配置10条DIS通知规则。
- 一个桶的多条DIS通知规则不允许重复，即任意对象在发生任意事件时都不能同时匹配两条以上的DIS通知规则，重复规则会创建失败。
针对同一事件，如果配置了一条前后缀都为空的规则，则不允许再配置第二条规则。前后缀都为空表示对所有对象生效。
例如：针对Put事件，已存在一条规则A，定义的前缀是“abcd”，后缀是“.txt”。如果要创建另外一条针对Put事件的规则B，则规则B配置不同前后缀的结果如表1所示。
前提条件
- 已创建DIS通道。
- 已创建IAM委托，委托要求OBS在DIS通道所在项目拥有DIS Administrator或者DIS User权限。创建委托的方法请参见委托其他云服务管理资源。
操作步骤
- 在OBS管理控制台桶列表中，单击待操作的桶，进入“概览”页面。
- 在页面右侧“基础配置”区域下，单击“事件通知”卡片，系统跳转至“事件通知”界面。
或您可以直接在左侧导航栏单击“基础配置>事件通知”，进入“事件通知”界面。
- 选择“DIS通知”页签。
- 单击“创建”，系统弹出“创建DIS通知”对话框，如图1所示。
- 配置DIS通知参数，参数说明如表2所示。
表2 DIS通知参数说明 参数
说明
DIS通知名称
新增DIS通知的名称，由用户自定义。
名称只允许由大写或小写的英文字母、数字、下划线和连字符组成，且长度不超过256个字符。
事件
事件类型。目前，OBS支持对以下事件类型发送DIS通知。
- ObjectCreated：表示所有创建对象的操作，包含Put、Post、Copy对象以及合并段。
- Put：使用Put方法上传对象。
- Post：使用Post方法上传对象。
- Copy：使用copy方法复制对象。
- CompleteMultipartUpload：表示合并分段任务。
- ObjectRemoved：表示所有删除对象的操作。
- Delete：指定对象版本号删除对象。
- DeleteMarkerCreated：不指定对象版本号删除对象。
多个事件类型可以作用于同一个目标对象，例如：同时选择“事件类型”复选框中的Put、Copy、Delete等方法作用于某目标对象，则用户往该桶中上传、复制、删除符合前后缀规则的目标对象时，均会发送事件通知给用户。ObjectCreated包含了Put、Post、Copy和CompleteMultipartUpload，如果选择了ObjectCreated，则不能再选择Put、Post、Copy或CompleteMultipartUpload。同理如果选择了ObjectRemoved，则不能再选择Delete或DeleteMarkerCreated。
前缀
指定事件作用的目标对象的前缀。
说明：- 当前缀和后缀都不配置时，DIS通知规则将作用于桶中所有对象。
- 前缀可以为空，最大长度不超过1024个字符，且同一条规则中前缀和后缀长度相加也不能超过1024个字符。
- 同一桶的多条DIS规则间，前后缀不能重复和包含，详情参见约束与限制。
后缀
指定事件作用的目标对象的后缀。
说明：- 当前缀和后缀都不配置时，DIS通知规则将作用于桶中所有对象。
- 后缀可以为空，最大长度不超过1024个字符，且同一条规则中前缀和后缀长度相加也不能超过1024个字符。
- 文件夹是以“/”结尾的，“/”前的字符为文件夹名称。对文件夹的相关操作配置DIS通知规则时，若要匹配后缀，后缀必须以“/”结尾。
- 同一桶的多条DIS规则间，前后缀不能重复和包含，详情参见约束与限制。
DIS通道
项目：选择DIS通道所在的项目。
项目用于管理和分类所有的云资源，包括DIS通道。创建DIS通道时，会要求指定通道所在项目。项目不同，对应的DIS通道也不相同，请先选择项目再选择DIS通道。
通道：选择事件通知需要发送到的DIS通道。DIS通道在DIS服务的控制台创建。
IAM委托
需要把DIS相关的权限委托给OBS，OBS才能向DIS发送通知。
此处需要选择一个云服务委托，委托要求OBS在DIS通道所在项目拥有DIS Administrator或者DIS User权限。
创建委托的方法请参见委托其他云服务管理资源。
- 单击“确定”。
相关操作
您可以单击待操作的DIS通知后面的“编辑”，修改DIS通知规则；单击“删除”，删除DIS通知。
若您要批量删除DIS通知，选中待删除的DIS通知，单击列表上方的“删除”，完成批量删除。
