按任务ID查询任务执行状态--多云CDN-火山引擎

文档中心

立即注册

导航

按任务ID查询任务执行状态

最近更新时间：2025.03.07 14:03:53首次发布时间：2022.07.28 21:39:27

调用本接口查询通过多云CDN提交的缓存刷新、文件预热、海外文件预热任务的详细信息和执行状态。

对于缓存刷新和文件预热任务，多云CDN调用云服务商提供的刷新和预热结果查询接口，以获取 URL 执行结果。
对于海外文件预热任务，任务执行结果反映的是边缘 HTTP 或 HTTPS 请求的结果。

使用说明

每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见签名机制。
您可以通过任务 ID 指定要查询的任务。每个请求仅允许指定一个任务 ID。

使用限制

节流限制：您每秒最多可以提交 30 个 API 请求。
云服务商平台接口限制：
对于缓存刷新和文件预热任务，因以下云服务商产品未提供用于查询刷新和预热结果的接口，多云CDN无法为您提供相应信息：
- 火山引擎—DCDN
- Akamai—AMD 和 DSA
- Google Cloud—Media CDN
- Azure—CDN
- Cloudflare—CDN

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com/?Action=DescribeContentTaskByTaskId&Version=2022-03-01

请求参数

Query

参数名称	数据类型	是否必选	参数说明
Action	String	是	接口名称。当前 API 的名称为 `DescribeContentTaskByTaskId`。
Version	String	是	接口版本。当前 API 的版本为 `2022-03-01`。

Body

参数名称	数据类型	是否必选	参数说明	示例
TaskId	String	是	要查询的刷新或预热任务的 ID。说明您可以调用 ListContentTasks 接口查询所有刷新与预热任务的 ID。	`62dc99fd56139eaa6c426cbd`

返回参数

参数名称	数据类型	参数说明	示例
SubTasks	Object[]	在云服务商平台创建的刷新或预热子任务的信息列表。
VendorsMetaData	Object[]	多云CDN未能从云服务商平台获得子任务信息的情形下，所返回的原始请求信息。

请求示例

POST https://open.volcengineapi.com/?Action=DescribeContentTaskByTaskId&Version=2022-03-01&<其他公共请求参数>=
{
    "TaskId": "62dc99fd56fd9eaa6c426abd"
}

返回示例

{
    "ResponseMetadata": {
        "RequestID": "2024021911500443E250F1BE036D2845D8",
        "Action": "DescribeContentTaskByTaskId",
        "Version": "2022-03-01",
        "Service": "mcdn",
        "Region": "cn-north-1"
    },
    "Result": {
        "SubTasks": [
            {
                "VendorTaskIds": [
                    "501278034180013226"
                ],
                "Url": "https://www.example.com/1.txt",
                "Status": "executing",
                "CreatedAt": 1708314591,
                "Description": "",
                "TaskId": "62dc99fd56fd9eaa6c426abd",
                "CloudAccountId": "655372974da3635feec7****",
                "CloudAccountName": "volctest",
                "Vendor": "tencent",
                "TaskType": "preload",
                "ProductType": "cdn",
                "SubProduct": "cdn"
            }
        ],
        "VendorsMetaData": []
    }
}

错误码

如果响应正文的 ResponseMetadata 字段中包含 Error 字段，则表示 API 请求失败。更多关于错误码的信息，参见错误码。