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

接口简介

该API用于腾讯云轻量服务器系统盘快照创建,无需关机即可自动删除旧快照并创建新快照。特点包括:

  1. 不占用腾讯云快照配额
  2. 支持自动备份策略
  3. 适用于定时备份任务
  4. 仅支持系统盘快照(云硬盘需调用专用接口)

请求地址
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 requests

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请求
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 json
    step3 = 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\"}"
}
注意事项
  1. 使用自己的用户ID和KEY(非示例中的88888888)
  2. 建议在腾讯云创建子账号并授权轻量服务器策略
  3. 首次使用前手动创建两个快照,确保始终保留最新备份
  4. 错误代码参考:
    • 400: 参数缺失或通讯秘钥错误
    • 其他错误信息详见msg字段

官方文档

更多细节请访问:接口盒子-腾讯云快照API

通过此API,您可以轻松实现服务器自动备份,有效保障数据安全。建议结合crontab或计划任务实现定时备份功能。

相关推荐
BD_Marathon1 小时前
【Flink】部署模式
java·数据库·flink
csudata2 小时前
十年磨一剑,中启乘数CData数据库一体机重新定义企业级数据库解决方案
数据库·数据库开发
WSSWWWSSW2 小时前
Seaborn数据可视化实战:Seaborn数据可视化基础-从内置数据集到外部数据集的应用
python·信息可视化·数据分析·matplotlib·seaborn
Small___ming2 小时前
Matplotlib 可视化大师系列(七):专属篇 - 绘制误差线、等高线与更多特殊图表
python·信息可视化·matplotlib
TDengine (老段)3 小时前
TDengine IDMP 应用场景:工业锅炉监控
大数据·数据库·物联网·信息可视化·时序数据库·tdengine
荼蘼4 小时前
CUDA安装,pytorch库安装
人工智能·pytorch·python
dreams_dream5 小时前
Django的Settings 配置文件详解
数据库·django·sqlite
杨荧5 小时前
基于Python的农作物病虫害防治网站 Python+Django+Vue.js
大数据·前端·vue.js·爬虫·python
骑驴看星星a5 小时前
数学建模--Topsis(Python)
开发语言·python·学习·数学建模
学习3人组5 小时前
JupyterLab在线调试实验室
python