首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >腾讯云轻量云硬盘免费快照API接口使用指南

腾讯云轻量云硬盘免费快照API接口使用指南

原创
作者头像
用户9840656
发布2025-07-13 12:54:48
发布2025-07-13 12:54:48
3300
举报

接口简介

腾讯云轻量云硬盘快照创建API由接口盒子提供,支持免关机自动备份数据,并自动删除旧快照以释放配额,特别适合定时备份场景。关键特性:

  • 无需停机​:创建快照不影响服务器运行
  • 配额无忧​:自动删除旧快照不占用快照配额
  • 灵活策略​:支持三种快照管理策略
  • 免费使用​:每日调用无上限(需自备API密钥)

请求参数说明

参数名

必填

说明

id

用户中心的数字ID(在apihz.cn获取)

key

用户中心通讯秘钥

slid

云硬盘ID(以lhdisk开头,在腾讯云控制台查看)

secretid

腾讯云API密钥ID(建议使用子账号密钥)

secretkey

腾讯云API密钥KEY(与secretid配对)

dy

地域代码(如ap-shanghai)地域代码表

name

自定义快照名称(默认自动生成)

type

执行策略(1=仅删除/2=仅创建/3=删除+创建,默认3)


响应参数说明

代码语言:javascript
复制
json复制{
  "code": 200,          // 状态码(200成功/400失败)
  "msg": "",            // 错误信息(code=400时返回)
  "slid": "lhdisk-xxx", // 云硬盘ID
  "step1": "...",       // 查询旧备份点结果
  "step2": "...",       // 删除旧备份点结果
  "step3": "..."        // 创建新备份点结果
}

调用示例(PHP)

代码语言:javascript
复制
php复制<?php
$apiUrl = "https://cn.apihz.cn/api/idc/txyqlyp.php";
$params = [
    'id' => '10000000',                  // 替换为您的用户ID
    'key' => '15he5h15ty854j5sr152hs2',  // 替换为您的通讯秘钥
    'slid' => 'lhdisk-kgzut06j',         // 替换为云硬盘ID
    'secretid' => 'AA485H41R156JYKU551RS51',
    'secretkey' => 'AA485H41R156JYKU551RS51',
    'dy' => 'ap-shanghai',
    'name' => '凌晨自动备份',
    'type' => '3'
];

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

// 发送POST请求
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));
?>

调用示例(Python)

代码语言:javascript
复制
python运行复制import requests

api_url = "https://cn.apihz.cn/api/idc/txyqlyp.php"
params = {
    "id": "10000000",                   # 替换为您的用户ID
    "key": "15he5h15ty854j5sr152hs2",   # 替换为您的通讯秘钥
    "slid": "lhdisk-kgzut06j",          # 替换为云硬盘ID
    "secretid": "AA485H41R156JYKU551RS51",
    "secretkey": "AA485H41R156JYKU551RS51",
    "dy": "ap-shanghai",
    "name": "凌晨自动备份",
    "type": "3"
}

# GET请求示例
get_response = requests.get(api_url, params=params)
print("GET响应:", get_response.json())

# POST请求示例
post_response = requests.post(api_url, data=params)
print("POST响应:", post_response.json())

使用建议

  1. 密钥安全​:始终使用腾讯云子账号API密钥,并仅授权轻量服务器相关权限
  2. 备份策略​:数据量较大时,建议分步操作(先执行type=1删除,1分钟后再执行type=2创建)
  3. 首次配置​:手动创建两个初始快照,确保每次自动备份后保留两个最新备份点
  4. 错误处理​:检查code字段,非200状态时通过msg定位错误

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 接口简介
  • 请求参数说明
  • 响应参数说明
  • 调用示例(PHP)
  • 调用示例(Python)
  • 使用建议
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档