调用DescribeDcdnRefreshTaskById查询刷新或预热是否在全网生效。
说明
- 支持查询3天内(包含3天)的数据。
- 单用户调用频率为30次/秒。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeDcdnRefreshTaskById |
系统规定参数。取值:DescribeDcdnRefreshTaskById。 |
TaskId | String | 是 | 113681** |
待查询的任务ID。具体如下:
说明 每次调用最多可以传入10个任务ID,多个任务ID用英文逗号(,)分隔。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | E0C2EF95-B1EC-4C93-855E-2059A7DA2B7B |
请求ID。 |
Tasks | Array of CDNTask |
刷新或预热任务列表。 |
|
CreationTime | String | 2021-05-10T08:54:23Z |
任务创建时间。使用UTC时间表示,格式为yyyy-MM-ddTHH:mm:ssZ。 |
Description | String | Internal Error |
刷新或预热失败后返回的错误描述。取值:
|
ObjectPath | String | http://example.com/image_01.png |
刷新或预热对象的路径。 |
ObjectType | String | file |
刷新或预热任务类型。取值:
|
Process | String | 100% |
任务完成进度百分比。 |
Status | String | Complete |
任务状态。取值:
|
TaskId | String | 113681** |
查询到的任务ID。 |
TotalCount | Long | 2 |
任务总个数。 |
示例
请求示例
http(s)://dcdn.aliyuncs.com/?Action=DescribeDcdnRefreshTaskById
&TaskId=113681**
&<公共请求参数>
正常返回示例
XML
格式
<DescribeDcdnRefreshTaskByIdResponse>
<RequestId>E0C2EF95-B1EC-4C93-855E-2059A7DA2B7B</RequestId>
<Tasks>
<CreationTime>2021-05-10T08:54:23Z</CreationTime>
<Description></Description>
<ObjectPath>http://example.com/image_01.png</ObjectPath>
<ObjectType>file</ObjectType>
<Process>100%</Process>
<Status>Complete</Status>
<TaskId>113681**</TaskId>
</Tasks>
<Tasks>
<CreationTime>2021-05-10T09:12:44Z</CreationTime>
<Description></Description>
<ObjectPath>http://example.com/image_02.png</ObjectPath>
<ObjectType>file</ObjectType>
<Process>99.37%</Process>
<Status>Refreshing</Status>
<TaskId>287367**</TaskId>
</Tasks>
<TotalCount>2</TotalCount>
</DescribeDcdnRefreshTaskByIdResponse>
JSON
格式
{
"RequestId": "E0C2EF95-B1EC-4C93-855E-2059A7DA2B7B",
"Tasks": [
{
"CreationTime": "2021-05-10T08:54:23Z",
"Description": "",
"ObjectPath": "http://example.com/image_01.png",
"ObjectType": "file",
"Process": "100%",
"Status": "Complete",
"TaskId": "113681**"
},
{
"CreationTime": "2021-05-10T09:12:44Z",
"Description": "",
"ObjectPath": "http://example.com/image_02.png",
"ObjectType": "file",
"Process": "99.37%",
"Status": "Refreshing",
"TaskId": "287367**"
}
],
"TotalCount": 2
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidParameters | The specified parameters are invalid. | 参数非法。 |
400 | InvalidTaskId.Malformed | The specified TaskId is invalid. | TaskId错误,请填写正确的TaskId。 |
400 | InvalidTaskId | The maximum number of taskIds is 10. | taskIds个数不能超过10. |
400 | InvalidTime | The query time cannot exceed the last 3 days. | 查询时间不能超过最近3天。 |
429 | TooManyRequests | The server is busy. Please try again later. | 服务器忙,请稍后再试 |
访问错误中心查看更多错误码。