活动

天翼云最新优惠活动,涵盖免费试用,产品折扣等,助您降本增效!
热门活动
  • 618智算钜惠季 爆款云主机2核4G限时秒杀,88元/年起!
  • 免费体验DeepSeek,上天翼云息壤 NEW 新老用户均可免费体验2500万Tokens,限时两周
  • 云上钜惠 HOT 爆款云主机全场特惠,更有万元锦鲤券等你来领!
  • 算力套餐 HOT 让算力触手可及
  • 天翼云脑AOne NEW 连接、保护、办公,All-in-One!
  • 中小企业服务商合作专区 国家云助力中小企业腾飞,高额上云补贴重磅上线
  • 出海产品促销专区 NEW 爆款云主机低至2折,高性价比,不限新老速来抢购!
  • 天翼云电脑专场 HOT 移动办公新选择,爆款4核8G畅享1年3.5折起,快来抢购!
  • 天翼云奖励推广计划 加入成为云推官,推荐新用户注册下单得现金奖励
免费活动
  • 免费试用中心 HOT 多款云产品免费试用,快来开启云上之旅
  • 天翼云用户体验官 NEW 您的洞察,重塑科技边界

智算服务

打造统一的产品能力,实现算网调度、训练推理、技术架构、资源管理一体化智算服务
智算云(DeepSeek专区)
科研助手
  • 算力商城
  • 应用商城
  • 开发机
  • 并行计算
算力互联调度平台
  • 应用市场
  • 算力市场
  • 算力调度推荐
一站式智算服务平台
  • 模型广场
  • 体验中心
  • 服务接入
智算一体机
  • 智算一体机
大模型
  • DeepSeek-R1-昇腾版(671B)
  • DeepSeek-R1-英伟达版(671B)
  • DeepSeek-V3-昇腾版(671B)
  • DeepSeek-R1-Distill-Llama-70B
  • DeepSeek-R1-Distill-Qwen-32B
  • Qwen2-72B-Instruct
  • StableDiffusion-V2.1
  • TeleChat-12B

应用商城

天翼云精选行业优秀合作伙伴及千余款商品,提供一站式云上应用服务
进入甄选商城进入云市场创新解决方案
办公协同
  • WPS云文档
  • 安全邮箱
  • EMM手机管家
  • 智能商业平台
财务管理
  • 工资条
  • 税务风控云
企业应用
  • 翼信息化运维服务
  • 翼视频云归档解决方案
工业能源
  • 智慧工厂_生产流程管理解决方案
  • 智慧工地
建站工具
  • SSL证书
  • 新域名服务
网络工具
  • 翼云加速
灾备迁移
  • 云管家2.0
  • 翼备份
资源管理
  • 全栈混合云敏捷版(软件)
  • 全栈混合云敏捷版(一体机)
行业应用
  • 翼电子教室
  • 翼智慧显示一体化解决方案

合作伙伴

天翼云携手合作伙伴,共创云上生态,合作共赢
天翼云生态合作中心
  • 天翼云生态合作中心
天翼云渠道合作伙伴
  • 天翼云代理渠道合作伙伴
天翼云服务合作伙伴
  • 天翼云集成商交付能力认证
天翼云应用合作伙伴
  • 天翼云云市场合作伙伴
  • 天翼云甄选商城合作伙伴
天翼云技术合作伙伴
  • 天翼云OpenAPI中心
  • 天翼云EasyCoding平台
天翼云培训认证
  • 天翼云学堂
  • 天翼云市场商学院
天翼云合作计划
  • 云汇计划
天翼云东升计划
  • 适配中心
  • 东升计划
  • 适配互认证

开发者

开发者相关功能入口汇聚
技术社区
  • 专栏文章
  • 互动问答
  • 技术视频
资源与工具
  • OpenAPI中心
开放能力
  • EasyCoding敏捷开发平台
培训与认证
  • 天翼云学堂
  • 天翼云认证
魔乐社区
  • 魔乐社区

支持与服务

为您提供全方位支持与服务,全流程技术保障,助您轻松上云,安全无忧
文档与工具
  • 文档中心
  • 新手上云
  • 自助服务
  • OpenAPI中心
定价
  • 价格计算器
  • 定价策略
基础服务
  • 售前咨询
  • 在线支持
  • 在线支持
  • 工单服务
  • 建议与反馈
  • 用户体验官
  • 服务保障
  • 客户公告
  • 会员中心
增值服务
  • 红心服务
  • 首保服务
  • 客户支持计划
  • 专家技术服务
  • 备案管家

了解天翼云

天翼云秉承央企使命,致力于成为数字经济主力军,投身科技强国伟大事业,为用户提供安全、普惠云服务
品牌介绍
  • 关于天翼云
  • 智算云
  • 天翼云4.0
  • 新闻资讯
  • 天翼云APP
基础设施
  • 全球基础设施
  • 信任中心
最佳实践
  • 精选案例
  • 超级探访
  • 云杂志
  • 分析师和白皮书
  • 天翼云·创新直播间
市场活动
  • 2025智能云生态大会
  • 2024智算云生态大会
  • 2023云生态大会
  • 2022云生态大会
  • 天翼云中国行
天翼云
  • 活动
  • 智算服务
  • 产品
  • 解决方案
  • 应用商城
  • 合作伙伴
  • 开发者
  • 支持与服务
  • 了解天翼云
      • 文档
      • 控制中心
      • 备案
      • 管理中心
      文档中心

      云备份

      云备份

      • 云备份

      无数据

        • 产品动态
        • 产品介绍
        • 产品定义
        • 术语解释
        • 产品优势
        • 应用场景
        • 功能概览
        • 使用限制
        • 与其他云服务的关系
        • 产品能力地图
        • 计费说明
        • 计费项及计费模式
        • 备份客户端软件计费说明
        • 备份存储库计费说明
        • 备份存储库到期
        • 快速入门
        • 入门指引
        • 准备工作
        • 创建存储库
        • 安装客户端
        • 安装ECS备份客户端
        • 安装本地备份客户端
        • 安装物理机备份客户端
        • 创建备份计划
        • 创建恢复任务
        • 用户指南
        • 查看概览信息
        • 存储库管理
        • 查看存储库
        • 扩容存储库
        • 续订存储库
        • 退订存储库
        • 客户端管理
        • 升级客户端
        • 升级ECS客户端
        • 升级本地客户端
        • 升级物理机客户端
        • 卸载客户端
        • 卸载ECS客户端
        • 卸载本地客户端
        • 卸载物理机客户端
        • 备份计划管理
        • 查看备份计划
        • 编辑备份计划
        • 暂停备份计划
        • 继续备份计划
        • 立即执行备份计划
        • 删除备份计划
        • 备份副本管理
        • 查看备份副本
        • 删除备份资源
        • 备份任务管理
        • 查看备份任务详情
        • 取消备份任务
        • 恢复任务管理
        • 查看恢复任务详情
        • 取消恢复任务
        • 资源包管理
        • 购买资源包
        • 查看资源包
        • 扩容资源包
        • 续订资源包
        • 云备份监控
        • 查看云备份监控数据
        • 创建告警规则
        • API参考
        • 调用前须知
        • 概述
        • 终端节点
        • 状态码
        • 状态枚举值
        • 如何调用API
        • 认证鉴权
        • Python调用示例
        • API(公测中)
        • 开通云备份服务
        • 备份客户端
        • 安装备份客户端
        • 查询备份客户端信息
        • 卸载备份客户端
        • 通过主机id查询云备份客户端
        • 存储库
        • 订购存储库
        • 查询存储库列表
        • 扩容存储库
        • 续订存储库
        • 退订存储库
        • 备份计划
        • 创建云备份计划
        • 查询云备份计划
        • 操作云备份计划
        • 修改云备份计划
        • 删除云备份计划
        • 任务管理
        • 查询备份任务列表
        • 取消备份任务
        • 创建恢复任务
        • 查询恢复任务列表
        • 取消恢复任务
        • 备份管理
        • 查询云备份快照
        • 删除备份资源
        • 最佳实践
        • 为Palworld幻兽帕鲁存档数据进行备份
        • 常见问题
        • 通用类
        • 存储库类
        • 备份计划类
        • 备份类
        • 恢复类
        • 文档下载
        • 云备份用户使用手册
        • 相关协议
        • 云备份服务协议
          无相关产品

          本页目录

          帮助中心云备份API参考API(公测中)备份客户端通过主机id查询云备份客户端
          通过主机id查询云备份客户端
          更新时间 2024-11-14 19:15:15
          • 新浪微博
          • 微信
            扫码分享
          • 复制链接
          最近更新时间: 2024-11-14 19:15:15
          分享文章
          • 新浪微博
          • 微信
            扫码分享
          • 复制链接
          通过主机id查询云备份客户端API说明

          接口介绍

          根据主机ID查询备份客户端信息(其中包括未安装客户端),用户输入备份客户端ID或者主机ID,查询备份客户端信息。

          接口约束

          无

          URI

          GET /v4/backup/client-by-instance-backup

          路径参数

          无

          Query参数

          参数 是否必填 参数类型 说明 示例 下级对象
          regionID 是 String 资源池ID 参考请求示例
          backupSrcInstanceID 否 String 备份主机ID,可以多个主机","分割 参考请求示例
          backupClientID 否 String 备份客户端ID 参考请求示例
          pageNo 否 Integer 当前页,默认1 参考请求示例
          pageSize 否 Integer 每页最多返回,默认10,最大值为50 参考请求示例

          请求参数

          请求头header参数

          无

          请求体body参数

          无

          响应参数

          参数 是否必填 参数类型 说明 示例 下级对象
          statusCode 是 Integer 返回状态码(800为成功,900为失败) 参考响应示例
          message 是 String 成功或失败时的描述,一般为英文描述 参考响应示例
          description 是 String 成功或失败时的描述,一般为中文描述 参考响应示例
          returnObj 否 Object 成功时返回对象 returnObj 表
          errorCode 否 String 业务细分码,为product.module.code三段式码 参考状态码
          error 否 String 业务细分码,为product.module.code三段式大驼峰码 参考状态码

          表 returnObj

          参数 是否必填 参数类型 说明 示例 下级对象
          backupClientList 是 Array of Objects 列表 参考表backupClientList
          backupClientTotal 是 Integer 总数 参考响应示例
          currentCount 是 Integer 当前页记录数目 参考响应示例
          totalCount 是 Integer 总记录数 参考响应示例
          totalPage 是 Integer 总页数 参考响应示例

          表 backupClientList

          参数 是否必填 参数类型 说明 示例 下级对象
          instacneID 是 String 云主机ID 参考响应示例
          instanceName 是 String 云主机名称 参考响应示例
          instacneIps 是 Array of Strings 云主机Ips 参考响应示例
          backupClientID 是 String 备份客户端ID 参考响应示例
          backupClientVersion 是 String 备份客户端版本 参考响应示例
          backupClientStatus 是 String 备份客户端状态 参考状态枚举值
          backupClientDesc 是 String 备份客户端状态描述 参考响应示例
          backupClientUpdateNeed 是 Boolean 备份客户端是否需要升级 参考响应示例
          backupClientEnableInstall 是 Boolean 备份客户端是否可安装 参考响应示例
          imageName 是 String 云主机镜像名称 参考响应示例
          osType 是 String 主机操作系统 参考响应示例

          请求示例

          请求头header

          无

          请求体body

          {
          	"regionID":"81f7728662dd11ec810800155d307d5b",
              "backupSrcInstanceID":"34d33b5e-f401-aa13-36bb-748564cd9542"
          
          }
          

          响应示例

          {
              "httpstatus": 200,
              "httpresult": {
                  "returnObj": {
                      "currentCount": 1,
                      "totalCount": 1,
                      "totalPage": 1,
                      "backupClientList": [
                          {
                              "backupClientVersion": "-",
                              "backupClientEnableInstall": false,
                              "instacneIps": [
                                  "192.168.0.26"
                              ],
                              "backupClientID": "fc8c4fbb-5ff8-4d40-8c7c-fe5f299672bf",
                              "backupClientStatus": "InstallFail",
                              "osType": "linux",
                              "instacneID": "34d33b5e-f401-aa13-36bb-748564cd9542",
                              "imageName": "Ctyunos-2.0.1_yunyi-x86_64-221222",
                              "backupClientUpdateNeed": false,
                              "backupClientDesc": "安装失败",
                              "instanceName": "ecm-ctyun2"
                          }
                      ],
                      "backupClientTotal": 1
                  },
                  "details": "",
                  "message": "SUCCESS",
                  "description": "成功",
                  "statusCode": 800
              }
          }
          

          状态码

          状态码 描述
          800 表示请求成功。

          错误码

          请参考状态码

          error description http status code message
          Openapi.Implementation.Error 实现错误 200 implmentation error
          Openapi.RequestParse.EopInvalidRejection 请求来源非法 200 injected request not expected
          Openapi.RequestParse.AccessKeyInvalid 非OpenAPI准入的系统access_key 200 access key invalid
          Openapi.RequestParse.JsonExpected 请求格式非法 400 request should be http POSTed json
          Openapi.RequestParse.EmptyRequest 请求为空 400 request should not be empty
          Openapi.Common.500 内部错误 200 internal error
          Backup.Admin.AccessFailed 系统错误 200 access internal service failed
          Backup.Workorder.AccessFailed 系统错误 200 access internal service failed
          Backup.RegionInfo.Empty 查询资源池信息为空或资源池不存在,请确认资源池ID是否有效 200 region info empty
          Backup.RegionInfo.AccessFailed 查询资源池失败,请重试。如果多次尝试失败,请提交工单 200 querying region failed
          Backup.RegionInfo.DataDamaged 查询资源池信息不符预期,请重试。如果多次尝试失败,请提交工单 200 region info data damaged
          Backup.Common.ServiceStatusError 云备份服务状态异常 200 backup service error
          Backup.Common.ClientAccessError 云备份客户端信息获取异常: xxx 200 backup client info access failed
          Backup.Parameter.Xxx 请求参数错误:xxx 200 request param error
          文档反馈

          建议您登录后反馈,可在建议与反馈里查看问题处理进度

          鼠标选中文档,精准反馈问题

          选中存在疑惑的内容,即可快速反馈问题,我们会跟进处理

          知道了

          上一篇 :  卸载备份客户端
          下一篇 :  存储库
          搜索 关闭
          ©2025 天翼云科技有限公司版权所有 增值电信业务经营许可证A2.B1.B2-20090001
          公司地址:北京市东城区青龙胡同甲1号、3号2幢2层205-32室
          备案 京公网安备11010802043424号 京ICP备 2021034386号
          ©2025天翼云科技有限公司版权所有
          京ICP备 2021034386号
          备案 京公网安备11010802043424号
          增值电信业务经营许可证A2.B1.B2-20090001
          用户协议 隐私政策 法律声明