首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >腾讯云轻量服务器创建镜像免费API接口教程

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

原创
作者头像
用户9840656
发布2025-07-13 11:40:36
发布2025-07-13 11:40:36
1990
举报

接口简介

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

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

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


接口基本信息

项目

详情

请求地址

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调用示例
代码语言:javascript
复制
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调用示例
代码语言:javascript
复制
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']}")

注意事项

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

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

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

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

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

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 接口简介
  • 接口基本信息
  • 请求参数说明
  • 返回参数说明
  • 调用示例
    • PHP调用示例
    • Python调用示例
  • 注意事项
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档