接口簡介
該API用于騰訊云輕量服務器系統盤快照創建，無需關機即可自動刪除舊快照并創建新快照。特點包括：
- 不占用騰訊云快照配額
- 支持自動備份策略
- 適用于定時備份任務
- 僅支持系統盤快照（云硬盤需調用專用接口）
?請求地址?
https://cn.apihz.cn/api/idc/txyqlkz.php
?請求方式?
POST 或 GET
請求參數
| 名稱 | 參數 | 必填 | 說明 |
|---|---|---|---|
| 用戶ID | id | 是 | 用戶中心數字ID |
| 用戶KEY | key | 是 | 用戶中心通訊秘鑰 |
| 實例ID | slid | 是 | 服務器實例ID（如 lhins-7x0h4ld0） |
| 地域 | dy | 是 | 地域代碼（如 ap-shanghai） |
| 秘鑰ID | secretid | 是 | 騰訊云API訪問秘鑰ID |
| 秘鑰KEY | secretkey | 是 | 騰訊云API訪問秘鑰KEY |
| 執行策略 | type | 否 | 1:僅刪除 / 2:僅創建 / 3:刪除+創建（默認值） |
?地域代碼參考?
騰訊云地域列表文檔輕量應用服務器 公共參數_騰訊云
返回參數
| 名稱 | 參數 | 說明 |
|---|---|---|
| 狀態碼 | code | 200:成功 / 400:錯誤 |
| 消息內容 | msg | 錯誤提示信息 |
| 實例ID | slid | 操作的實例ID |
| 第一步 | step1 | 查詢舊快照結果 |
| 第二步 | step2 | 刪除舊快照結果 |
| 第三步 | step3 | 創建新快照結果 |
?執行建議?
數據量較大時，建議單獨執行刪除(type=1)，1分鐘后再執行創建(type=2)
調用示例
PHP 示例
php
復制
<?php
$url = "https://cn.apihz.cn/api/idc/txyqlkz.php";
$params = ['id' => '10000000', // 替換為您的用戶ID'key' => '15he5h15ty854j5', // 替換為您的用戶KEY'slid' => 'lhins-7x0h4ld0', // 實例ID'dy' => 'ap-shanghai', // 地域代碼'secretid' => '您的SecretId','secretkey' => '您的SecretKey','type' => 3 // 執行策略
];// GET請求
$getUrl = $url . '?' . http_build_query($params);
$response = file_get_contents($getUrl);// POST請求
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);// 處理響應
$result = json_decode($response, true);
if($result['code'] == 200) {echo "快照創建成功！\n";echo "新快照ID: " . json_decode($result['step3'])->SnapshotId;
} else {echo "錯誤: " . $result['msg'];
}
?>Python 示例
python
運行
復制
import requestsurl = "https://cn.apihz.cn/api/idc/txyqlkz.php"
params = {"id": "10000000", # 替換為您的用戶ID"key": "15he5h15ty854j5", # 替換為您的用戶KEY"slid": "lhins-7x0h4ld0", # 實例ID"dy": "ap-shanghai", # 地域代碼"secretid": "您的SecretId","secretkey": "您的SecretKey","type": 3 # 執行策略
}# GET請求
response_get = requests.get(url, params=params)
print("GET響應:", response_get.json())# POST請求
response_post = requests.post(url, data=params)
result = response_post.json()# 處理響應
if result['code'] == 200:import jsonstep3 = json.loads(result['step3'])print(f"快照創建成功!\n新快照ID: {step3['SnapshotId']}")
else:print("錯誤:", result['msg'])返回示例
json
復制
{"code": 200,"slid": "lhins-pkcy7icg","step1": "lhsnap-lt7j2hl4","step2": "{\"RequestId\":\"add56ce5-98b1-45d0-a9fe-e569bdb1f96e\"}","step3": "{\"SnapshotId\":\"lhsnap-hux1yn40\",\"RequestId\":\"697e2aa0-50d0-49b6-a31b-312db2fca2f7\"}"
}注意事項
- 使用自己的用戶ID和KEY（非示例中的88888888）
- 建議在騰訊云創建子賬號并授權輕量服務器策略
- 首次使用前手動創建兩個快照，確保始終保留最新備份
- 錯誤代碼參考：
- 400: 參數缺失或通訊秘鑰錯誤
- 其他錯誤信息詳見msg字段
?官方文檔?
更多細節請訪問：接口盒子-騰訊云快照API
通過此API，您可以輕松實現服務器自動備份，有效保障數據安全。建議結合crontab或計劃任務實現定時備份功能。
