# 为桶的CDN加速域名配置自动刷新策略 #### 使用场景 CDN加速功能将存储在OBS中的数据缓存到终端用户附近的CDN节点上，让身处各地的终端用户都可以快速访问存储在OBS中的数据。当用户需要更新OBS中存储的数据时，CDN中缓存的过时数据也需要进行更新，可以使用CDN自动刷新功能来自动通知CDN去更新数据。因此，通过配置自动刷新策略，可以保证CDN节点上的缓存数据和源站（OBS）的数据一致。 #### 约束与限制 - 已开启或开启后暂停多版本功能的桶不支持该功能。 - 不支持自动刷新文件夹缓存。 - 不支持跨租户的CDN自动刷新。 - 不支持联邦身份认证的账号的CDN自动刷新。 - 如果配置的CDN域名变成非加速域名（停止加速），5分钟内同一个非加速域名触发消息超过10 次，则取消自动刷新订阅。 - CDN加速域名异常的情况下，会取消自动刷新订阅；加速域名恢复正常后，再次配置正常的自动刷新策略，可重新订阅自动刷新。 - 为桶的CDN加速域名配置自动刷新策略需要拥有Tenant Administrator权限，建议使用IAM服务对用户进行授权，如何授权参见[通过IAM授予使用OBS的权限](https://support.huaweicloud.com/usermanual-obs/obs_03_0122.html#ZH-CN_TOPIC_0000001904384853)。 #### 前提条件 已在OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)配置加速域名（域名已开启加速）。 #### 操作步骤 OBS支持通过[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)方式为桶的加速域名配置CDN自动刷新策略，分为以下步骤： #### 步骤一：创建用于自动刷新CDN缓存的委托 如果要正常使用CDN自动刷新功能，需要使用IAM委托功能创建委托，用于给OBS授予**查看加速域名信息权限** 和**刷新缓存权限**，以委托OBS处理您的数据。如果您已有合适的委托，可跳过该步骤。 1. 登录控制台"[统一身份认证服务](https://console.huaweicloud.com/iam/?agencyId=037a96c8ee16453098ec7ab325a129ba#/iam/users)"页面。 2. 在统一身份认证服务的左侧导航栏中，选择"委托"页面，单击右上方的"创建委托"。 图1创建委托 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002162521242.png) 3. 设置用于自动刷新CDN缓存的委托相关的参数，其他参数保持默认。 表1参数说明 | 参数名称 | 说明 | |:---|:---| | 委托名称 | 创建的委托名称。 委托名称不能为空。 | | 委托类型 | 选择将账号内资源的操作权限委托给其他账号或云服务。 **创建用于自动刷新CDN缓存的委托，此处选择"云服务"。** | | 云服务 | 选择将账号内资源的操作权限委托给某个云服务。当"委托类型"选择"云服务"时，需配置该参数。 **创建用于自动刷新CDN缓存的委托，此处选择"对象存储服务 OBS"。** | 4. 单击"完成"，并在"创建成功"弹窗单击"暂不授权"。在委托列表页面可以看到新创建的委托，即表示委托创建成功。 5. 创建自定义策略，用来给委托授予CDN相关权限。 1. 在[IAM控制台](https://console.huaweicloud.com/iam/?locale=zh-cn#/iam/users)左侧导航栏选择"权限管理 \> 权限"。 2. 在权限页面右上角单击"创建自定义策略"。 3. 在创建自定义策略页面，按照如下设置参数内容，其他参数保持默认。 图2自定义策略设置 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002342814870.png "点击放大") - 策略名称：根据需要设置简单易于记忆的名称。 - 云服务：选择"CDN (CDN)"。 - 操作：在"只读"类操作中选择查看加速域名信息权限"cdn:configuration:queryDomains"，在"写"类操作中选择刷新缓存权限"cdn:configuration:refreshCache"。 - 资源：目前仅支持选择"所有资源"。 4. 单击"确定"，在权限列表页面可以看到新创建的自定义策略，即表示创建成功。 6. 给创建的委托授予CDN相关权限。 1. 在[IAM控制台](https://console.huaweicloud.com/iam/?locale=zh-cn#/iam/users)左侧导航栏选择"委托"。 2. 单击[2]创建的委托操作列的"授权"。 3. 在"选择策略"页面，选择[5]创建的自定义策略，单击"下一步"。 4. 在"设置最小权限范围"页面选择"所有资源"，单击"确定"。 ![](https://support.huaweicloud.com/usermanual-obs/public_sys-resources/note_3.0-zh-cn.png) 如果要正常使用该功能，授权范围方案仅支持选择"所有资源"，在此处表示，OBS可以根据权限使用账号中所有资源，包括企业项目、区域项目和全局服务资源。 5. 在"权限生效时间提醒"弹窗，单击"知道了"。 6. 在"完成"页面，单击"完成"。 #### 步骤二：创建刷新策略 配置完加速域名且CNAME域名解析生效后，需要配置CDN自动刷新策略，来自动刷新缓存数据，保证CDN节点上的缓存数据和源站（OBS）的数据一致。 1. 登录OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)。 2. 单击待操作的桶，进入"对象"页面。 3. 在左侧导航栏选择"基础配置\>域名管理"，进入"域名管理"界面。 4. 在域名管理列表，找到需要创建自动刷新缓存的域名卡片，在"自动刷新缓存"的右侧单击"配置"，弹出"自动刷新缓存"弹窗。 图3自动刷新缓存 ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002342974690.png "点击放大") 5. 在"自动刷新缓存"弹窗，配置相关参数。 表2事件触发器参数说明 | 参数 | 说明 | |:---|:---| | 自动刷新缓存 | 选择是否启用自动刷新缓存。 此处打开开关，表示启用自动刷新缓存。 | | 事件 | 自动刷新策略生效的事件类型。目前，OBS支持以下事件类型： - **ObjectCreated** **：** 表示所有创建对象的操作，包含Put、Post、Copy对象以及合并段。 - **ObjectCreated** :**Put**：Put上传对象事件。 - **ObjectCreated** :**Post**：Post上传对象事件。 - **ObjectCreated** :**Copy**：使用Copy方法复制对象事件。 - **ObjectCreated** :**CompleteMultipartUpload**：表示合并分段任务。 - **ObjectRemoved** **：** 表示删除对象的操作。 **ObjectRemoved** :**Delete**：删除对象事件。 | | 前缀 | 自动刷新策略生效的对象范围（指定前缀的对象），即指定前缀的对象更新后，会触发自动刷新策略执行，保证CDN节点上的该对象和OBS桶中的对象一致。 - 配置前缀，表示自动刷新策略对指定前缀的对象生效。例如： 前缀配置为"abc"，表示自动刷新策略对桶中对象名称以"abc"开头的所有对象生效。如abcdef.txt、abc/def.txt、abc/def/test.txt等。 - 未配置前缀和后缀，表示自动刷新策略对桶中的所有对象生效。 - 不支持配置多个前缀。 | | 后缀 | 自动刷新策略生效的对象范围（指定后缀的对象），即指定后缀的对象更新后，会触发自动刷新策略执行，保证CDN节点上的该对象和OBS桶中的对象一致。 - 配置后缀，表示自动刷新策略对指定后缀的对象生效。例如： 后缀配置为"abc.txt"，表示自动刷新策略对桶中对象名称以"abc.txt"结尾的所有对象生效。如123abc.txt、test/123abc.txt、test/test02/abc.txt等。 - 未配置前缀和后缀，表示自动刷新策略对桶中的所有对象生效。 - 不支持配置多个后缀。 | | IAM委托 | 如果要正常使用CDN自动刷新功能，需要使用IAM委托功能创建委托，用于给OBS授予**查看加速域名信息权限** 和**刷新缓存权限** ，以委托OBS处理您的数据。详情请参见[步骤一：创建用于自动刷新CDN缓存的委托](https://support.huaweicloud.com/usermanual-obs/obs_03_0097.html#ZH-CN_TOPIC_0000002001868997__zh-cn_topic_0000001951258337_section9917958195011)。 | ![](https://support.huaweicloud.com/usermanual-obs/public_sys-resources/note_3.0-zh-cn.png) 如果配置了自动刷新缓存，在CNAME域名状态变为"已开启"后，还需要等待最长约5分钟，自动刷新缓存配置才生效。 #### 关闭自动刷新缓存 当您需要为域名停止加速时，请先关闭自动刷新缓存。 1. 登录OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)。 2. 单击待操作的桶，进入"对象"页面。 3. 在左侧导航栏选择"基础配置\>域名管理"，进入"域名管理"界面。 4. 在域名管理列表，找到需要关闭自动刷新缓存的域名卡片，在"自动刷新缓存"的右侧单击"更改配置"，弹出"自动刷新缓存"弹窗。 5. 在"自动刷新缓存"弹窗，关闭自动刷新缓存按钮。 在域名列表对应卡片中不再显示"自动刷新缓存"，即表示关闭成功。