全部文档
当前文档
最近更新时间：2022-03-17 17:10:28
本接口用于屏蔽、解除屏蔽URL。
说明：
同一个 ID 设有总屏蔽条数的限制额度，默认限制额度5000条，超过上限后屏蔽失败
屏蔽URL：
解除屏蔽：解除屏蔽后，对该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 | 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将错误码集中归类，请到【使用须知】查看详情。
纯净模式