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

调用该接口前,请您注意

  • 支持根据任务ID查询、URL查询。
  • Taskid与Objectpath都不指定,默认查3天内,第一页的数据(20条)。
  • Taskid与Objectpath可以同时指定。
  • 当指定DomainName或TaskStatus时,ObjectType该项为必填。
  • 只可查询3天内的数据。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeScdnRefreshTasks

系统规定参数,取值:DescribeRefreshTasks

DomainName String example.com

域名

EndTime String 2017-01-01T12:12:20Z

结束时间

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

按路径查询,准确匹配

ObjectType String file

任务类型。取值范围:

  • file
  • path
  • preload

当指定DomainNameTaskStatus时,该项为必填。

PageNumber Integer 1

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

PageSize Integer 30

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

ResourceGroupId String rg-acfmyuji4b6r4ry

资源组ID

StartTime String 2017-01-01T12:12:20Z

开始时间

Status String Complete

任务状态。取值:

  • Complete:完成。
  • Refreshing:刷新中。
  • Failed:刷新失败。
TaskId String 704225667

按任务ID查询刷新状态

返回数据

名称 类型 示例值 描述
PageNumber Long 1

当前页码

PageSize Long 10

分页大小

RequestId String 174F6032-AA26-470D-B90E-36F0EB205BEE

请求ID

Tasks

SCDNTask组成的任务列表

Task

SCDNTask组成的任务列表

CreationTime String 2014-11-27T08:18:38Z

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

Description String Internal Error

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

  • InternalError
  • OriginTimeout
  • OriginReturn StatusCode 5XX
ObjectPath String http://example.com/1.txt

刷新对象路径

ObjectType String file

任务类型。取值范围:

  • file
  • path
  • preload
Process String 100%

进度百分比

Status String Complete

状态。取值范围:

  • Complete:完成。
  • Refreshing:刷新中。
  • Failed:刷新失败。
  • Pending:等待刷新。
TaskId String 704225667

任务ID

TotalCount Long 2

总个数

示例

请求示例


http(s)://scdn.aliyuncs.com/?Action=DescribeScdnRefreshTasks
&<公共请求参数>

正常返回示例

XML 格式

<DescribeScdnRefreshTasksResponse>
      <Tasks>
            <SCDNTask>
                  <CreationTime>2014-11-27T08:23:22Z</CreationTime>
                  <ObjectPath>http://example.com/1.txt</ObjectPath>
                  <Status>Complete</Status>
                  <TaskId>704225667</TaskId>
                  <ObjectType>file</ObjectType>
                  <Process>100%</Process>
            </SCDNTask>
            <SCDNTask>
                  <CreationTime>2014-11-27T08:18:38Z</CreationTime>
                  <ObjectPath>http://example.com/1.txt</ObjectPath>
                  <Status>Complete</Status>
                  <TaskId>704222904</TaskId>
                  <ObjectType>file</ObjectType>
                  <Process>100%</Process>
            </SCDNTask>
      </Tasks>
      <PageNumber>1</PageNumber>
      <PageSize>10</PageSize>
      <TotalCount>2</TotalCount>
      <RequestId>174F6032-AA26-470D-B90E-36F0EB205BEE</RequestId>
</DescribeScdnRefreshTasksResponse>

JSON 格式

{
	"PageNumber":1,
	"TotalCount":2,
	"PageSize":10,
	"RequestId":"174F6032-AA26-470D-B90E-36F0EB205BEE",
	"Tasks":{
		"SCDNTask":[
			{
				"ObjectPath":"http://example.com/1.txt",
				"CreationTime":"2014-11-27T08:23:22Z",
				"Status":"Complete",
				"ObjectType":"file",
				"Process":"100%",
				"TaskId":"704225667"
			},
			{
				"ObjectPath":"http://example.com/1.txt",
				"CreationTime":"2014-11-27T08:18:38Z",
				"Status":"Complete",
				"ObjectType":"file",
				"Process":"100%",
				"TaskId":"704222904"
			}
		]
	}
}

错误码

访问错误中心查看更多错误码。