CDN

屏蔽URL进度查询接口

最近更新时间:2019-01-14 19:10:57

GetBlockUrlTask

描述

本接口用于获取屏蔽URL任务进度百分比及状态,查看任务是否在全网生效。

  • 支持根据任务ID、URL获取数据
  • 支持按指定的起止时间查询,两者需要同时指定
  • 所有参数都不指定,默认查第1页20条数据
  • 起止时间、TaskId、Url可以同时指定,逻辑与的关系 *最多可获取1年内的数据

注意:

  • 接口仅支持POST请求格式
  • 该接口仅返回当前正在屏蔽的生命周期的URL,已解除的不返回

请求语法

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

请求参数

参数名 必选 类型及范围 说明
Urls Url[] Url组成的数组, 支持按Url路径查询,准确匹配
PageSize Long 分页大小,取值为1-50,最大50,默认20
PageNumber Long 取得第几页,取值为:1-100000,最大100000,默认1

Url

参数名 必选 类型及范围 说明
Url String 需要查询的Url路径

返回参数

参数名 类型及范围 说明
PageSize Long 整页大小
PageNumber Long 页码
TotalCount Long Url总条数
Datas UrlData[] 任务进度百分比及状态信息
Url String 屏蔽的Url地址
Progress Double 任务进度百分比数值。状态为屏蔽中时,为屏蔽的进度;状态为解除屏蔽中时,为解除屏蔽的进度;状态为刷新中时,为刷新的进度。
BlockUrlStatus String 状态信息,取值见附录
BlockTime String URL开始屏蔽的时间
xpireTime String 过期自动解除屏蔽的时间
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"}]
}

返回示例

{
"PageSize":1,
"PageNumber":2,
"TotalCount":10,
"Datas":
[
{
"Url":"http://www.test.com/a",
"Progress":22.0,
"BlockUrlStatus":"blocking",
"BlockTime":"2017-08-17T19:13+0800",
"ExpireTime":"2017-08-18T19:13+0800",
"Submitter":"customer"}
]
}

UrlData

BlockUrlStatus结构体

屏蔽URL状态BlockUrlStatus包括:

  • 屏蔽中 - blocking
  • 屏蔽完成 - block_success
  • 屏蔽失败 - block_fail
  • 解除屏蔽中 - unblocking
  • 解除屏蔽完成(该API不返回)- unblock_success
  • 解除屏蔽失败 - ublock_fail
  • 刷新中 - refreshing
  • 刷新完成(该API不返回) - refresh_success
  • 刷新失败 - refresh_fail

金山云,开启您的云计算之旅

立即注册