欢迎来到合肥浪讯网络科技有限公司官网
  咨询服务热线:400-099-8848

如何通过API接口查询腾讯云CDN缓存预热任务的状态?

发布时间:2026-03-14 文章来源:本站  浏览次数:22

一、用到的 API

  • 接口名:DescribePushTasks
  • 作用:查询 CDN 缓存预热任务列表、状态、进度、失败原因

二、准备工作

  1. 去腾讯云 → 访问管理 → API 密钥管理,拿到:
    • SecretId
    • SecretKey
  2. 安装腾讯云 Python SDK
bash
运行
pip install tencentcloud-sdk-python

三、最简可运行代码(Python)

直接复制,只改 密钥、时间 即可:
python
运行
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.cdn.v20180606 import cdn_client, models

# 1. 填入你的密钥
secret_id = "你的SecretId"
secret_key = "你的SecretKey"

# 2. 初始化客户端
cred = credential.Credential(secret_id, secret_key)
client = cdn_client.CdnClient(cred, "")

# 3. 构造查询条件
req = models.DescribePushTasksRequest()
req.StartTime = "2026-02-13 00:00:00"  # 开始时间
req.EndTime = "2026-02-13 23:59:59"    # 结束时间
# req.Status = "success"  # 可选:只查成功 / fail / running / canceled
# req.TaskId = "任务ID"    # 可选:精确查某一个预热任务

# 4. 发起查询
resp = client.DescribePushTasks(req)

# 5. 打印结果
print("任务总数:", resp.TotalCount)
for task in resp.Tasks:
    print("="*50)
    print("任务ID:", task.TaskId)
    print("预热URL:", task.Url)
    print("状态:", task.Status)       # success/fail/running
    print("进度:", task.Progress)     # 100=完成
    print("失败原因:", task.FailReason)

四、返回状态说明

表格
Status 含义
success 预热成功
running 正在预热
fail 预热失败
canceled 已取消

五、常用筛选(直接加进代码)

python
运行
# 只查失败的
req.Status = "fail"

# 只查某个具体任务
req.TaskId = "123456789"


下一条:腾讯云CDN缓存预热有哪...