一、用到的 API
- 接口名：DescribePushTasks
- 作用：查詢 CDN 緩存預(yù)熱任務(wù)列表、狀態(tài)、進(jìn)度、失敗原因
二、準(zhǔn)備工作
- 去騰訊云 → 訪問管理 → API 密鑰管理，拿到：
- 安裝騰訊云 Python SDK
pip install tencentcloud-sdk-python
三、最簡可運(yùn)行代碼（Python）
直接復(fù)制，只改 密鑰、時(shí)間 即可：
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. 構(gòu)造查詢條件
req = models.DescribePushTasksRequest()
req.StartTime = "2026-02-13 00:00:00" # 開始時(shí)間
req.EndTime = "2026-02-13 23:59:59" # 結(jié)束時(shí)間
# req.Status = "success" # 可選：只查成功 / fail / running / canceled
# req.TaskId = "任務(wù)ID" # 可選：精確查某一個(gè)預(yù)熱任務(wù)
# 4. 發(fā)起查詢
resp = client.DescribePushTasks(req)
# 5. 打印結(jié)果
print("任務(wù)總數(shù)：", resp.TotalCount)
for task in resp.Tasks:
print("="*50)
print("任務(wù)ID：", task.TaskId)
print("預(yù)熱URL：", task.Url)
print("狀態(tài)：", task.Status) # success/fail/running
print("進(jìn)度：", task.Progress) # 100=完成
print("失敗原因：", task.FailReason)
四、返回狀態(tài)說明
| Status |
含義 |
| success |
預(yù)熱成功 |
| running |
正在預(yù)熱 |
| fail |
預(yù)熱失敗 |
| canceled |
已取消 |
五、常用篩選（直接加進(jìn)代碼）
# 只查失敗的
req.Status = "fail"
# 只查某個(gè)具體任務(wù)
req.TaskId = "123456789"
|
咨詢服務(wù)熱線：400-099-8848
