腾讯云轻量服务器创建镜像免费API接口教程

接口简介

本接口由接口盒子提供用于腾讯云轻量服务器创建快照镜像，支持自动化备份操作。核心优势包括：

无需关机：在服务器运行状态下创建镜像
自动清理：默认自动删除旧镜像创建新镜像
配额友好：不占用标准镜像配额名额
操作便捷：适合配置定时任务实现自动化备份

适用于服务器数据保护、定期快照等场景，有效防止数据丢失。

接口基本信息

项目	详情
请求地址	`https://cn.apihz.cn/api/idc/txyqljx.php`
请求方式	POST/GET
每日调用上限	无限制
频率限制	每分钟限频（建议使用自有ID/KEY）

请求参数说明

参数名	必填	说明
id	是	用户中心数字ID（用户后台获取）
key	是	用户中心通讯秘钥
slid	是	服务器实例ID（腾讯云控制台获取，形如`lhins-7x0h4ld0`）
dy	是	地域代码（如上海`ap-shanghai`，代码列表）
secretid	是	腾讯云API秘钥ID（访问管理生成）
secretkey	是	腾讯云API秘钥KEY
type	否	执行策略： 1=仅删除最后镜像 2=仅创建新镜像 3=删除+创建（默认）

返回参数说明

参数名	说明
code	状态码：200=成功，400=失败
msg	错误提示信息（code=400时返回）
slid	操作的实例ID
step1	查询旧镜像的结果
step2	删除旧镜像的返回信息
step3	创建新镜像的返回信息

调用示例

PHP调用示例

php 复制代码

php
复制
<?php
$url = 'https://cn.apihz.cn/api/idc/txyqljx.php';
$params = [
    'id'        => '10000000',      // 替换为你的用户ID
    'key'       => 'your_user_key', // 替换为你的通讯秘钥
    'slid'      => 'lhins-xxxxxx',  // 替换为实例ID
    'dy'        => 'ap-shanghai',   // 替换为地域代码
    'secretid'  => 'your_secret_id',// 腾讯云SecretId
    'secretkey' => 'your_secret_key'// 腾讯云SecretKey
];

// 发起GET请求
$response = file_get_contents($url . '?' . http_build_query($params));

// 处理返回结果
$result = json_decode($response, true);
if($result['code'] == 200) {
    echo "镜像创建成功！新镜像ID: " . json_decode($result['step3'])->SnapshotId;
} else {
    echo "操作失败: " . $result['msg'];
}
?>

Python调用示例

python 复制代码

python
运行
复制
import requests

url = "https://cn.apihz.cn/api/idc/txyqljx.php"
params = {
    "id": "10000000",        # 替换为你的用户ID
    "key": "your_user_key",   # 替换为你的通讯秘钥
    "slid": "lhins-xxxxxx",  # 替换为实例ID
    "dy": "ap-shanghai",     # 替换为地域代码
    "secretid": "your_secret_id",   # 腾讯云SecretId
    "secretkey": "your_secret_key"  # 腾讯云SecretKey
}

# 发起GET请求
response = requests.get(url, params=params)
result = response.json()

if result['code'] == 200:
    import json
    step3 = json.loads(result['step3'])
    print(f"镜像创建成功！新镜像ID: {step3['SnapshotId']}")
else:
    print(f"操作失败: {result['msg']}")

注意事项

密钥安全：建议使用腾讯云子账号生成API密钥，并仅授权轻量服务器相关权限
镜像策略：首次使用前需手动创建2个镜像，确保每次操作保留最新两个备份
错误处理：
- 400状态码时检查msg字段获取具体错误
- 常见错误：密钥错误/实例ID不存在/地域代码错误
操作建议：大数据量服务器建议分步操作（先删除旧镜像，1分钟后再创建新镜像）

免费API