最近更新时间:2021-09-13 09:59:10
本接口用于获取屏蔽URL任务进度百分比及状态,查看任务是否在全网生效。
注意:
本接口请求需要包含指定目录/2016-09-01/content/GetBlockUrlTask、公共请求header和该接口所特有的请求参数,具体请求语句参照下文请求示例。
参数名 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
StartTime | 否 | String | 获取数据起始时间点,日期格式按ISO8601表示法,北京时间,格式为:YYYY-MM-DDThh:mm+0800,例如:2016-08-01T21:14+0800。默认是一天前时间 |
EndTime | 否 | String | 结束时间需大于起始时间;获取日期格式按照ISO8601表示法,北京时间,格式为:YYYY-MM-DDThh:mm+0800,例如:2016-08-01T21:14+0800。默认是当前时间 |
TaskId | 否 | String | 支持按任务ID查询,只允许输入单个任务ID |
BlockType | 否 | String | 屏蔽类型,取值, block:屏蔽;unblock:解屏蔽。 不传,默认同时查询屏蔽和解屏蔽 |
DomainName | 否 | String | 支持按域名查询,只允许输入单个域名 |
Urls | 否 | Url[] | Url组成的数组, 支持按Url路径查询,准确匹配 |
PageSize | 否 | Long | 分页大小,取值为1-50,最大50,默认20 |
PageNumber | 否 | Long | 取得第几页,取值为:1-100000,最大100000,默认1 |
参数名 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
Url | 是 | {} | 需要查询的Url路径 |
参数名 | 类型及范围 | 说明 |
---|---|---|
StartTime | Long | 开始时间 |
EndTime | Long | 结束时间 |
PageSize | Long | 整页大小 |
PageNumber | Long | 页码 |
TotalCount | Long | Url总条数 |
Datas | UrlData[] | 任务进度百分比及状态信息 |
参数名 | 类型及范围 | 说明 |
---|---|---|
TaskId | String | 任务Id |
BlockType | String | 屏蔽类型,取值, block:屏蔽URL;unblock:解除屏蔽 |
Url | String | 屏蔽的Url地址 |
Progress | Double | 任务进度百分比数值。状态为屏蔽中时,为屏蔽的进度;状态为解除屏蔽中时,为解除屏蔽的进度;状态为刷新中时,为刷新的进度。 |
BlockUrlStatus | String | 状态信息,取值见使用须知中的枚举类型表 |
BlockTime | String | Url屏蔽/解屏蔽的操作时间 |
ExpireTime | String | 过期自动解除屏蔽的时间。当 BlockType = unblock ,为空值 |
Submitter | String | 屏蔽提交者,取值为:customer:客户提交;ksyun:金山云封禁;ISMS:信息安全管理系统封禁 |
请求示例
post方式
POST /2016-09-01/statistics/ GetBlockUrlTask
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetBlockUrlTask
x-version: 2016-09-01
Content-Type: application/json
{
"Urls":[{"Url":"http://www.zhaofang360.com/abc.txt"},{"Url":"http://www.zhaofang360.com/abc.ed"}]
}
返回示例
{
"StartTime": "2016-09-01T17:55+0800",
"EndTime": "2016-09-02T17:55+0800",
"PageSize":1,
"PageNumber":2,
"TotalCount":10,
"Datas":
[
{
"TaskId": "ad07ce4f-59a5-4c32-b857-2d8ac9a929b8",
"BlockType":"block",
"Url":"http://www.zhaofang360.com/abc.txt",
"Progress":22.0,
"BlockUrlStatus":"blocking",
"BlockTime":"2016-09-01T19:13+0800",
"ExpireTime":"2016-09-08T19:13+0800",
"Submitter":"ksyun"
},
{
"TaskId": "26ba2c41-6f00-438f-b268-30be326f131c",
"BlockType":"block",
"Url":"http://www.zhaofang360.com/abc.ed",
"Progress":22.0,
"BlockUrlStatus":"blocking",
"BlockTime":"2016-09-01T19:13+0800",
"ExpireTime":"2016-09-08T19:13+0800",
"Submitter":"ksyun"
},
]
}
文档内容是否对您有帮助?
评价建议不能为空
非常感谢您的反馈,我们会继续努力做到更好!