阅读1018 返回首页    go 阿里云 go 技术社区[云栖]

查询刷新操作记录__刷新预热接口_API 手册_CDN-阿里云

描述

查询刷新、预热状态，是否在全网生效。

  • 支持根据任务ID查询、URL查询
  • taskid与objectpath都不指定，默认查7天内，第一页的数据（20条）
  • Taskid与objectpath可以同时指定，逻辑与的关系
  • 只可查询7天内的数据

请求参数

参数 类型 必要 描述
Action String 是 操作接口名，系统规定参数
取值：DescribeRefreshTasks
TaskId String 否 按任务Id查询刷新状态
ObjectPath String 否 按路径查询，准确匹配
PageSize Integer 否 分页大小，默认20，最大50 取值：1~50之前的任意整数
PageNumber Integer 否 取得第几页 取值范围为：1~100000

返回参数

名称 类型 描述
Tasks Struct TaskItem组成的Task任务列表。
PageSize Integer 整页大小
PageNumber Integer 页码
TotalCount Integer 总条数

TaskItem 子节点

名称 类型 描述
TaskId String 任务Id。
ObjectPath String 刷新对象路径
Status String 状态，值分别是Complete(完成)、Refreshing(刷新中)、Failed(刷新失败)、Pending(等待刷新)
Process String 进度百分比
CreationTime DateTime 任务对象创建时间，UTC时间
Description String 刷新预热失败返回错误描述，目前包含三种错误”Internal Error” “Origin Timeout” “Origin Return StatusCode 5XX”

特定错误码

ErrorCode 错误码 Message 错误信息 HTTP 状态
Throttling Request was denied due to request throttling. 503 请求被流量控制限制
OperationDenied Your account does not open CDN service yet. 403 未开通CDN服务
OperationDenied Your CDN service is suspended. 403 CDN服务已被停止
InvalidTaskId.Malformed Specified TaskId is malformed. 400 TaskId格式错误

公共错误码请查看

示例

请求示例：

  1. https://cdn.aliyuncs.com?&Action=DescribeRefreshTasks&ObjectPath=&PageNumber=1&PageSize=10&<公共请求参数>

返回示例：

JSON格式：

  1. {
  2.     "Tasks" : {
  3.         "CDNTask" : [{
  4.                 "CreationTime" : "2014-11-27T08:23:22Z",
  5.                 "ObjectPath" : "https://news.ifeng.com/1.txt",
  6.                 "Status" : "Complete",
  7.                 "TaskId" : "704225667"
  8.             }, {
  9.                 "CreationTime" : "2014-11-27T08:18:38Z",
  10.                 "ObjectPath" : "https://news.ifeng.com/1.txt",
  11.                 "Status" : "Complete",
  12.                 "TaskId" : "704222904"
  13.             }, {
  14.                 "CreationTime" : "2014-11-27T07:58:58Z",
  15.                 "ObjectPath" : "https://news.ifeng.com/static/",
  16.                 "Status" : "Complete",
  17.                 "TaskId" : "704211692"
  18.             }, {
  19.                 "CreationTime" : "2014-11-27T07:58:31Z",
  20.                 "ObjectPath" : "https://news.ifeng.com/static/1.png",
  21.                 "Status" : "Complete",
  22.                 "TaskId" : "704211414"
  23.             }, {
  24.                 "CreationTime" : "2014-11-27T07:56:54Z",
  25.                 "ObjectPath" : "https://news.ifeng.com/static/",
  26.                 "Status" : "Complete",
  27.                 "TaskId" : "704210512"
  28.             }, {
  29.                 "CreationTime" : "2014-11-27T07:56:42Z",
  30.                 "ObjectPath" : "https://news.ifeng.com/static/1.png",
  31.                 "Status" : "Complete",
  32.                 "TaskId" : "704210368"
  33.             }, {
  34.                 "CreationTime" : "2014-11-27T07:56:11Z",
  35.                 "ObjectPath" : "https://news.ifeng.com/static/1.png",
  36.                 "Status" : "Complete",
  37.                 "TaskId" : "704210004"
  38.             }, {
  39.                 "CreationTime" : "2014-11-27T04:06:27Z",
  40.                 "ObjectPath" : "https://haitao.smzdm.com/1.txt",
  41.                 "Status" : "Complete",
  42.                 "TaskId" : "704081031"
  43.             }
  44.         ]
  45.     },
  46.     "PageNumber" : 1,
  47.     "PageSize" : 10,
  48.     "TotalCount" : 8,
  49.     "RequestId" : "174F6032-AA26-470D-B90E-36F0EB205BEE"
  50. }

XML格式：

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <DescribeRefreshTasksResponse>
  3.   <Tasks>
  4.     <CDNTask>
  5.       <CreationTime>2014-11-27T08:23:22Z</CreationTime>
  6.       <ObjectPath>https://news.ifeng.com/1.txt</ObjectPath>
  7.       <Status>Complete</Status>
  8.       <TaskId>704225667</TaskId>
  9.     </CDNTask>
  10.     <CDNTask>
  11.       <CreationTime>2014-11-27T08:18:38Z</CreationTime>
  12.       <ObjectPath>https://news.ifeng.com/1.txt</ObjectPath>
  13.       <Status>Complete</Status>
  14.       <TaskId>704222904</TaskId>
  15.     </CDNTask>
  16.     <CDNTask>
  17.       <CreationTime>2014-11-27T07:58:58Z</CreationTime>
  18.       <ObjectPath>https://news.ifeng.com/static/</ObjectPath>
  19.       <Status>Complete</Status>
  20.       <TaskId>704211692</TaskId>
  21.     </CDNTask>
  22.     <CDNTask>
  23.       <CreationTime>2014-11-27T07:58:31Z</CreationTime>
  24.       <ObjectPath>https://news.ifeng.com/static/1.png</ObjectPath>
  25.       <Status>Complete</Status>
  26.       <TaskId>704211414</TaskId>
  27.     </CDNTask>
  28.     <CDNTask>
  29.       <CreationTime>2014-11-27T07:56:54Z</CreationTime>
  30.       <ObjectPath>https://news.ifeng.com/static/</ObjectPath>
  31.       <Status>Complete</Status>
  32.       <TaskId>704210512</TaskId>
  33.     </CDNTask>
  34.     <CDNTask>
  35.       <CreationTime>2014-11-27T07:56:42Z</CreationTime>
  36.       <ObjectPath>https://news.ifeng.com/static/1.png</ObjectPath>
  37.       <Status>Complete</Status>
  38.       <TaskId>704210368</TaskId>
  39.     </CDNTask>
  40.     <CDNTask>
  41.       <CreationTime>2014-11-27T07:56:11Z</CreationTime>
  42.       <ObjectPath>https://news.ifeng.com/static/1.png</ObjectPath>
  43.       <Status>Complete</Status>
  44.       <TaskId>704210004</TaskId>
  45.     </CDNTask>
  46.     <CDNTask>
  47.       <CreationTime>2014-11-27T04:06:27Z</CreationTime>
  48.       <ObjectPath>https://haitao.smzdm.com/1.txt</ObjectPath>
  49.       <Status>Complete</Status>
  50.       <TaskId>704081031</TaskId>
  51.     </CDNTask>
  52.   </Tasks>
  53.   <PageNumber>1</PageNumber>
  54.   <PageSize>10</PageSize>
  55.   <TotalCount>8</TotalCount>
  56.   <RequestId>13DF2E2F-FBF8-4E1C-9222-98141795443D</RequestId>
  57. </DescribeRefreshTasksResponse>

最后更新：2016-11-23 17:16:03

  上一篇：go 预热缓存__刷新预热接口_API 手册_CDN-阿里云
  下一篇：go 查询操作余量__刷新预热接口_API 手册_CDN-阿里云