调用本接口查询云服务商平台的刷新和预热任务列表。
每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见签名机制。
参数名称 | 数据类型 | 是否必选 | 参数说明 |
---|---|---|---|
Action | String | 是 | 接口名称。当前 API 的名称为 ListVendorContentTask 。 |
Version | String | 是 | 接口版本。当前 API 的版本为 2022-03-01 。 |
参数名称 | 数据类型 | 是否必选 | 参数说明 | 示例 |
---|---|---|---|---|
TaskType | String | 是 | 要查询的任务的类型。该参数有以下取值:
| refresh_dir |
CloudAccountId | String | 是 | 要使用的云服务商账号的 ID。 说明 您可以调用 ListCloudAccounts 接口查询多云CDN中所有云服务商账号的 ID。 | 62bdbc3d54f3fa9551ea**** |
VendorTaskId | String | 否 | 指定一个由云服务商平台返回的刷新或预热任务的 ID,查询该任务的信息。 | da928f3b-58e7-44f6-9d39-4deed32a150a |
StartTime | Long | 否 | 设置一个开始时间,格式是 Unix 时间戳。该参数与 说明 如果您未指定时间段或者指定了无效的时间段,则接口默认返回在过去 24 小时内创建的任务。 | 1658883449 |
EndTime | Long | 否 | 设置一个结束时间,格式是 Unix 时间戳。该参数与 说明 如果您未指定时间段或者指定了无效的时间段,则接口默认返回在过去 24 小时内创建的任务。 | 1658915851 |
ProductType | String | 否 | 指定一个云产品类型,查询该类型产品的相关数据。该参数有以下取值:
| cdn |
Pagination | Object | 否 | 对查询结果进行分页并返回特定页码上的任务。 | |
SubProduct | String | 否 | 指定一个云产品,查询该产品的相关数据。该参数有以下取值:
| cdn |
参数名称 | 数据类型 | 参数说明 | 示例 |
---|---|---|---|
Tasks | Object[] | 任务详情列表。 | |
Pagination | Object | 分页详情。 |
POST https://open.volcengineapi.com/?Action=ListVendorContentTask&Version=2022-03-01&<其他公共请求参数>=
{
"TaskType": "refresh_file",
"CloudAccountId": "62bdbc3d54f3fa9551ea****",
"Pagination": {
"PageNum": 1,
"PageSize": 20
}
}
{
"ResponseMetadata": {
"RequestID": "202207241852340102120972071193A640",
"Action": "ListVendorContentTask",
"Version": "2022-03-01",
"Service": "mcdn",
"Region": "cn-north-1"
},
"Result": {
"Tasks": [
{
"VendorTaskId": "da928f3b-58e7-44f6-9d39-4deed32a150a",
"Url": "http://www.example.com/",
"Status": "complete",
"CreatedAt": 1658639867,
"Description": ""
},
{
"VendorTaskId": "da928f3b-5867-44f6-9259-4deed3er150a",
"Url": "http://img.example.com/1.jpg",
"Status": "complete",
"CreatedAt": 1658624478,
"Description": ""
}
],
"Pagination": {
"PageSize": 20,
"PageNum": 1,
"Total": 2
}
}
}
如果响应正文的 ResponseMetadata
字段中包含 Error
字段,则表示 API 请求失败。更多关于错误码的信息,参见错误码。