接口简介
该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或计划任务实现定时备份功能。
