配置DIS通知

约束与限制

• 一个桶中最多同时配置10条DIS通知规则。
• 一个桶的多条DIS通知规则不允许重复，即任意对象在发生任意事件时都不能同时匹配两条以上的DIS通知规则，重复规则会创建失败。
  

  针对同一事件，如果配置了一条前后缀都为空的规则，则不允许再配置第二条规则。前后缀都为空表示对所有对象生效。

  例如：针对Put事件，已存在一条规则A，定义的前缀是“abcd”，后缀是“.txt”。如果要创建另外一条针对Put事件的规则B，则规则B配置不同前后缀的结果如表1所示。

  表1 规则B前后缀配置场景及结果

  规则A前后缀配置	规则B前后缀配置	规则B创建结果	原因
  前缀：abcd 后缀：.txt	前缀：abcd 后缀：.txt	失败	前后缀相同
  	前缀：abcd 后缀：空	失败	前缀相同，后缀B包含A
  	前缀：ab 后缀：xt	失败	前缀B包含A，后缀B包含A
  	前缀：abef 后缀：.txt	成功	前缀不同，后缀相同
  	前缀：abcd 后缀：.mp4	成功	前缀相同，后缀不同

前提条件

• 已创建DIS通道。创建通道的方法请参见《数据接入服务用户指南》。
• 已创建IAM委托，委托要求OBS在DIS通道所在项目拥有DIS Administrator或者DIS User权限。创建委托的方法请参见委托其他云服务管理资源。

新建DIS通知规则

1. 在OBS管理控制台左侧导航栏选择“桶列表”。
2. 在OBS管理控制台桶列表中，单击待操作的桶，进入“对象”页面。
3. 在左侧导航栏单击“基础配置>事件通知”，进入“DIS通知”界面。
4. 单击“创建”，系统弹出“创建DIS通知”对话框，如图1所示。
   图1 创建DIS通知
   

5. 配置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服务的控制台创建。 创建DIS通道的方法请参见《数据接入服务用户指南》。
   IAM委托	需要把DIS相关的权限委托给OBS，OBS才能向DIS发送通知。 此处需要选择一个云服务委托，委托要求OBS在DIS通道所在项目拥有DIS Administrator或者DIS User权限。 创建委托的方法请参见委托其他云服务管理资源。

6. 单击“确定”。

复制DIS通知规则

1. 在OBS管理控制台左侧导航栏选择“桶列表”。
2. 在OBS管理控制台桶列表中，单击待操作的桶，进入“对象”页面。
3. 在左侧导航栏单击“基础配置>事件通知”，进入“DIS通知”界面。
4. 单击“复制”。
5. 选择复制源，即DIS通知规则所在的源桶。
   

   • 从源桶复制DIS通知规则的操作为增量复制，不会删除当前桶已存在的DIS通知规则，与已存在的DIS通知规则冲突的规则不会复制。
   • 源桶和目标桶的桶版本号都必须是3.0。
   • 同源和目标桶必须在同一区域。
   • 您可以按需移除不需要复制的DIS通知规则。

6. 单击“确定”，将源桶的DIS通知规则复制到当前桶。

相关操作

您可以单击待操作的DIS通知后面的“编辑”，修改DIS通知规则；单击“删除”，删除DIS通知。

如果您要批量删除DIS通知，选中待删除的DIS通知，单击列表上方的“删除”，完成批量删除。