Skip to Content
云分发 UCDN获取预取任务状态 - DescribeNewUcdnPrefetchCacheTask

获取预取任务状态 - DescribeNewUcdnPrefetchCacheTask

简介

获取预取任务状态

定义

公共参数

参数名类型描述信息必填
Actionstring对应的 API 指令名称,当前 API 为 DescribeNewUcdnPrefetchCacheTaskYes
PublicKeystring用户公钥,可从 控制台 获取Yes
Signaturestring根据公钥及 API 指令生成的用户签名,参见 签名算法Yes

请求参数

参数名类型描述信息必填
ProjectIdstring项目ID。不填写为默认项目,子帐号必须填写。 请参考GetProjectList接口No
TaskId.Nstring提交任务时返回的任务IDNo
BeginTimeint查询的起始时间,格式为Unix Timestamp。如果有EndTime,BeginTime必须赋值No
EndTimeint查询的结束时间,格式为Unix Timestamp。EndTime默认为当前时间,BeginTime默认为当前时间前一天时间。No
Statusstring需要获取的内容预热的状态,枚举值:success:成功;wait:等待处理;process:正在处理;failure:失败; unknow:未知,默认选择所有状态No
Offsetint数据偏移量,默认为0,自然数No
Limitint返回数据长度,默认全部,自然数No
IsDcdnboolean是否全站加速 默认falseNo

响应字段

字段名类型描述信息必填
RetCodeint返回状态码,为 0 则为成功返回,非 0 为失败Yes
Actionstring操作指令名称Yes
Messagestring返回错误消息,当 RetCode 非 0 时提供详细的描述信息No
TotalCountint预热任务的总数No
TaskListarray[TaskInfo]预热任务信息,参考TaskInfoNo

数据模型

TaskInfo

字段名类型描述信息必填
TaskIdstring提交任务时返回的任务IDNo
UrlListsarray[UrlProgressInfo]任务url的信息列表,参考UrlProgressInfoNo
CreateTimeint刷新任务创建的时间。格式为Unix TimestampNo
Statusstring刷新任务的当前状态,枚举值:success:成功;wait:排队中;process:处理中;failure:失败; unknow:未知No

UrlProgressInfo

字段名类型描述信息必填
Urlstring刷新的单条urlNo
CreateTimeint刷新任务创建的时间。格式为Unix TimestampNo
FinishTimeint任务完成时间。格式为Unix TimestampNo
Statusstring刷新任务的当前状态,枚举值:success:成功;wait:排队中;process:处理中;failure:失败; unknow:未知No
Progressint刷新进度,单位%No

示例

请求示例

https://api.an-link.com/?Action=DescribeNewUcdnPrefetchCacheTask &ProjectId=xxxxx &TaskId.0=feTvWytY &BeginTime=2 &EndTime=3 &Status=uwNWouHX &Offset=1 &Limit=1 &IsDcdn=false

响应示例

{ "Action": "DescribeNewUcdnPrefetchCacheTaskResponse", "RetCode": 0, "TaskList": [ { "CreateTime": 4, "Status": "ySoPLGgE", "TaskId": "mEuMcQSL", "UrlLists": [ { "CreateTime": 6, "FinishTime": 1, "Progress": 3, "Status": "pmUWBVxw", "Url": "xChNHhYo" }, { "CreateTime": 3, "FinishTime": 7, "Progress": 7, "Status": "xCZMvZWZ", "Url": "lKGDMDQq" }, { "CreateTime": 6, "FinishTime": 9, "Progress": 9, "Status": "zMxmxYcf", "Url": "ptLqMQuh" }, { "CreateTime": 4, "FinishTime": 1, "Progress": 4, "Status": "OaxNseKe", "Url": "YhpEnOmI" }, { "CreateTime": 4, "FinishTime": 5, "Progress": 4, "Status": "etAmHzPP", "Url": "PEBgMeNh" } ] }, { "CreateTime": 1, "Status": "JKrNCisb", "TaskId": "mYtrUNKc", "UrlLists": [ { "CreateTime": 3, "FinishTime": 2, "Progress": 6, "Status": "XynKYAiJ", "Url": "XqHsIOtd" }, { "CreateTime": 1, "FinishTime": 6, "Progress": 3, "Status": "rCoGJtmC", "Url": "EYRxaYAM" }, { "CreateTime": 5, "FinishTime": 6, "Progress": 2, "Status": "sFsEYOgd", "Url": "ehwfbnDN" }, { "CreateTime": 8, "FinishTime": 5, "Progress": 3, "Status": "EwSSKJad", "Url": "FxacwAet" }, { "CreateTime": 8, "FinishTime": 5, "Progress": 7, "Status": "SkdViYPP", "Url": "VRJFzzlH" }, { "CreateTime": 5, "FinishTime": 3, "Progress": 5, "Status": "hcAQXhoN", "Url": "LwAewYSo" }, { "CreateTime": 7, "FinishTime": 3, "Progress": 2, "Status": "AiVaeqAx", "Url": "eJpkSqiP" } ] }, { "CreateTime": 7, "Status": "dDQVOfuA", "TaskId": "ZJazzIIh", "UrlLists": [ { "CreateTime": 8, "FinishTime": 5, "Progress": 2, "Status": "okiJCQZU", "Url": "qKIoMLtR" }, { "CreateTime": 1, "FinishTime": 9, "Progress": 6, "Status": "SXVfOLXG", "Url": "fVxMWSUL" }, { "CreateTime": 2, "FinishTime": 4, "Progress": 9, "Status": "wOXhjduh", "Url": "UtBAuUmZ" } ] }, { "CreateTime": 3, "Status": "LeqJkycM", "TaskId": "sEiKGYYr", "UrlLists": [ { "CreateTime": 6, "FinishTime": 8, "Progress": 5, "Status": "YYcZbXWw", "Url": "oEqzcgMA" }, { "CreateTime": 1, "FinishTime": 6, "Progress": 6, "Status": "HYZmwEUR", "Url": "UKXkiPDK" }, { "CreateTime": 2, "FinishTime": 2, "Progress": 3, "Status": "FBCAWBMW", "Url": "aGCnxHXv" } ] }, { "CreateTime": 1, "Status": "GVWVbBkR", "TaskId": "ByScqGMr", "UrlLists": [ { "CreateTime": 9, "FinishTime": 2, "Progress": 4, "Status": "iQguQPft", "Url": "MmoeVMJQ" }, { "CreateTime": 3, "FinishTime": 9, "Progress": 3, "Status": "CPqqNmqO", "Url": "YtzBfJQF" } ] }, { "CreateTime": 5, "Status": "RPkHZOFJ", "TaskId": "sklDNgoJ", "UrlLists": [ { "CreateTime": 5, "FinishTime": 2, "Progress": 8, "Status": "hfRtxJYA", "Url": "MPKzOnkG" }, { "CreateTime": 3, "FinishTime": 2, "Progress": 8, "Status": "NOgImUxr", "Url": "NqeqhcDn" }, { "CreateTime": 5, "FinishTime": 5, "Progress": 8, "Status": "jadthNuI", "Url": "dehdHOoC" }, { "CreateTime": 4, "FinishTime": 5, "Progress": 9, "Status": "KCTmUkpl", "Url": "UxQiBarm" } ] }, { "CreateTime": 3, "Status": "xRRNKppD", "TaskId": "YLQhYqyq", "UrlLists": [ { "CreateTime": 8, "FinishTime": 5, "Progress": 3, "Status": "qhlDmXYg", "Url": "fJbCCejm" }, { "CreateTime": 8, "FinishTime": 4, "Progress": 4, "Status": "IViYWdSq", "Url": "LkEYimIs" }, { "CreateTime": 2, "FinishTime": 1, "Progress": 7, "Status": "uCbnQqLo", "Url": "NbtQArje" }, { "CreateTime": 7, "FinishTime": 7, "Progress": 9, "Status": "SHEYNyGf", "Url": "ylzrmbHW" }, { "CreateTime": 3, "FinishTime": 9, "Progress": 8, "Status": "lgCecoFw", "Url": "cYVWknQE" }, { "CreateTime": 4, "FinishTime": 7, "Progress": 1, "Status": "JhdorWII", "Url": "OEykZxWV" }, { "CreateTime": 4, "FinishTime": 4, "Progress": 1, "Status": "GlHxqIgx", "Url": "RWWfGzMi" } ] } ], "Test": "ryEuYMgQ", "TotalCount": 4 }