文档首页/ 内容分发网络 CDN/ API参考/ API/ 刷新预热/ 创建封禁/解禁URL任务 - CreateAccessControlTask
更新时间：2025-11-27 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建封禁/解禁URL任务 - CreateAccessControlTask

功能介绍

创建封禁/解禁URL任务，如需使用本接口，请提交工单申请。

  • 单租户调用频率：10次/s。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

POST /v1.0/cdn/content/access-control-urls/{action}

表1 路径参数

参数

是否必选

参数类型

描述

action

是

String

参数解释：

操作类型，

约束限制：

不涉及

取值范围：

  • ban：禁用

  • unban：解禁

默认取值：

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
表3 请求Body参数

参数

是否必选

参数类型

描述

access_control_urls

是

AccessControlUrls object

需要解禁或封禁的URL信息
表4 AccessControlUrls

参数

是否必选

参数类型

描述

urls

是

Array of strings

URL必须带有“http://”或“https://”，单次最多输入1000个url。

ban_duration

否

Integer

URL封禁天数，默认7天，取值范围1-30。

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

task_id

String

任务id

状态码：400

表6 响应Body参数

参数

参数类型

描述

error

ErrMsg object

用于返回具体的错误码和错误消息
表7 ErrMsg

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

POST https://cdn.myhuaweicloud.com/v1.0/cdn/content/access-control-urls/ban

{
  "access_control_urls" : {
    "urls" : [ "https://www.example.com/1.txt", "http://www.example.com/2.txt" ],
    "ban_duration" : 1
  }
}

响应示例

状态码：200

成功响应。

{
  "task_id" : "71xxxxxxxxxxxxxxxxxxxxxxxxxxxxff"
}

状态码

状态码

描述

200

成功响应。

400

失败响应。

错误码

请参见错误码。

父主题： 刷新预热

相关文档