全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
CDN

查询刷新和预热状态

更新时间:2018-05-03 16:52:57

描述

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

  • 支持根据任务ID查询、URL查询。

  • taskid与objectpath都不指定,默认查3天内,第一页的数据(20条)。

  • Taskid与objectpath可以同时指定,逻辑与的关系。

  • 只可查询3天内的数据。

请求参数

参数 类型 是否必选 示例值 描述
Action String DescribeRefreshTasks

系统规定参数。取值:DescribeRefreshTasks

DomainName String www.yourdomain.com

域名。

EndTime String 2017-12-22T08:00:00:00Z

结束时间,格式例如:2017-01-01T12:12:20Z。

ObjectPath String http://aaa.com/1.txt

按路径查询,准确匹配。

ObjectType String file

任务类型。

  • file
  • path
  • preload
当指定DomainName或TaskStatus时,该项为必填。

PageNumber Integer 1

取得第几页。
取值范围:1~100000

PageSize Integer 20

分页大小。最大值:50
取值范围:1~50之前的任意整数。
默认值:20

ResourceGroupId String your resourceGroupId

资源组ID。

StartTime String 2017-12-21T08:00:00:00Z

开始时间,格式例如:2017-01-01T12:12:20Z。

Status String Complete

任务状态。

  • Complete(完成)
  • Refreshing(刷新中)
  • Failed(刷新失败)

TaskId String 1234321

按任务ID查询刷新状态。

返回参数

参数 类型 示例值 描述
Tasks

TaskItem组成的Task任务列表。

  └TaskId String 704225667

任务ID。

  └ObjectPath String http://aaa.com/1.txt

刷新对象路径。

  └Status String Complete

状态。取值:

  • Complete(完成)
  • Refreshing(刷新中)
  • Failed(刷新失败)
  • Pending(等待刷新)

  └Process String 100%

进度百分比。

  └ObjectType String file

任务类型。

  • file
  • path
  • preload

  └CreationTime String 2014-11-27T08:23:22Z

任务对象创建时间,UTC时间。

  └Description String Internal Error

刷新预热失败返回错误描述,目前包含三种错误:

  • Internal Error
  • Origin Timeout
  • Origin Return StatusCode 5XX

PageSize Long 1

整页大小。

PageNumber Long 10

页码。

TotalCount Long 2

总条数。

RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

请求ID。

示例

请求示例

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

正常返回示例

JSON 格式

  1. {
  2. "PageNumber":1,
  3. "PageSize":10,
  4. "RequestId":"174F6032-AA26-470D-B90E-36F0EB205BEE",
  5. "Tasks":{
  6. "CDNTask":[
  7. {
  8. "CreationTime":"2014-11-27T08:23:22Z",
  9. "ObjectPath":"http://aaa.com/1.txt",
  10. "ObjectType":"file",
  11. "Process":"100%",
  12. "Status":"Complete",
  13. "TaskId":"704225667"
  14. },
  15. {
  16. "CreationTime":"2014-11-27T08:18:38Z",
  17. "ObjectPath":"http://bbb.com/1.txt",
  18. "ObjectType":"file",
  19. "Process":"100%",
  20. "Status":"Complete",
  21. "TaskId":"704222904"
  22. }
  23. ]
  24. },
  25. "TotalCount":2
  26. }

异常返回示例

JSON 格式

  1. {
  2. "Code":"InternalError",
  3. "HostId":"cdn.aliyuncs.com",
  4. "Message":"The request processing has failed due to some unknown error.",
  5. "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
  6. }

错误码

查看本产品错误码

本文导读目录