BlockDomainUrl

描述

本接口用于屏蔽、解除屏蔽URL。

说明：

• 同一个 ID 设有总屏蔽条数的限制额度，默认限制额度5000条，超过上限后屏蔽失败

• 屏蔽URL：

  • 该URL后续访问都是403

• 解除屏蔽：解除屏蔽后，对该URL的访问回复正常

注意：

• 解除屏蔽时，如果该url不存在或已经解除屏蔽，返回成功。

• 每个 URL 必须以http://开头，但后台同时屏蔽http和https的访问

• 每个 URL 最大长度 1000 字符

• 每个 URL 所在的域名必须是该用户在金山云加速的域名。

• URL 如果包含中文字符，请使用urlencode方式提交。

• 单次调用URL上限为1000条

• 接口仅支持POST请求格式

请求语法

本接口请求需要包含指定目录/2019-06-01/content/BlockDomainUrl、公共请求header和该接口所特有的请求参数，具体请求语句参照下文请求示例。

请求参数

参数	类型	必要	描述
BlockType	String	是	操作接口名，系统规定参数 取值：block：屏蔽URL；unblock：解除屏蔽
Urls	Url[]	是	URL列表
BlockTime	Long	否	(仅在屏蔽URL时生效)，屏蔽的时间，以秒为单位。默认为604800（7天），最大7天，最小1小时。过期后自动解除屏蔽。

数据类型Url

参数	类型	描述
Url	String	具体的URL，以http://开头，屏蔽功能同时屏蔽http和https的访问；

返回参数

参数名	类型及范围	说明
TaskId	String	任务Id

示例

请求示例

POST方式：

POST /2019-06-01/content/BlockDomainUrl
Host: cdn.api.ksyun.com 
X-Amz-Date: date  
Authorization:authorization string 
x-action: BlockDomainUrl
x-version: 2019-06-01 
Content-Type: application/json

{
    "BlockType": "block",
    "Urls": [
        {
            "Url": "http://wcdn-20220304-1.ksc-test.com/abc.txt"
        },
        {
            "Url": "http://wcdn-20220304-1.ksc-test.com/txa.txt"
        }
    ],
    "BlockTime":3600
}

返回示例

{
    "TaskId": "f960d3f6-d075-43ad-8726-9a3e1f73ae48"
}

错误码

为了帮您快速定位问题，WCDN将错误码集中归类，请到【使用须知】查看详情。