检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何调用API 构造请求 认证鉴权 返回结果
起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。
状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于管理员创
与其他云服务的关系 云备份与其他云服务的关系如图1所示。 图1 云备份与其他服务的关系示意图 云备份与其他服务的关系 表1 云备份与其他服务的关系 交互功能 相关服务 位置 云备份对弹性云服务器中的云硬盘进行备份，支持将备份的数据恢复到弹性云服务器的云硬盘中，以便于在弹性云服务器
BackupService.6000 策略不存在 策略不存在 请确认策略是否存在 404 BackupService.6002 存储库和策略的绑定关系不存在 存储库和策略的绑定关系不存在 请先为存储库设置备份策略 404 BackupService.6105 存储库不存在 存储库不存在 请明确具体操作限制，使用合法的存储库参数
sh与appexample_unfreeze.sh脚本，供备份Agent调用以实现一致性备份。在备份过程中，会先调用appexample_freeze.sh脚本来冻结IO，冻结成功后，会进行磁盘的一致性快照激活，保证备份的数据是一致性的，最后再调用appexample_unfreeze.sh脚本解冻IO。
见API概览。 在调用云备份API之前，请确保已经充分了解云备份相关概念，详细信息请参见产品介绍。 调用说明 云备份提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 终端节点
使用云硬盘备份恢复数据时，需要先停止服务器，并解除服务器和云硬盘的绑定关系后再做恢复操作。恢复后，再绑定云硬盘并启动服务器。 前提条件 需要恢复的磁盘状态为“可用”。 在恢复数据前，需要先停止服务器，并解除服务器和磁盘的挂载关系后再做恢复操作。恢复后，再挂载磁盘并启动服务器。 约束与限制
查询租户的企业项目信息 接口约束 本接口仅用于开通了企业项目场景中，Console需要获取复制目标区域的project_id时使用，其它场景下调用无返回值。 URI GET /v3/region-projects 请求参数 无 响应参数 状态码： 200 表1 响应Body参数 参数
注册客户端 功能介绍 注册客户端，安装时候由Agent调用，无需手动注册。 URI POST /v3/{project_id}/agents 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID 请求参数 表2 请求Header参数 参数
查询租户信息 功能介绍 由控制台调用的内部接口，用于仅在查询共享备份时获取源project_id的域名信息，目前仅能查询当前账号下的项目信息。 URI GET /v3/domain/{source_project_id} 表1 路径参数 参数 是否必选 参数类型 描述 source_project_id
使用云硬盘备份恢复数据时，需要停止服务器吗？ 需要先停止服务器，并解除服务器和云硬盘的绑定关系后再做恢复操作。 恢复后，再绑定云硬盘并启动服务器。 具体操作请参见《云备份用户指南》“使用云硬盘备份恢复数据”章节。 父主题： 恢复类
项目id 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型
示例1：创建弹性云服务器备份 场景描述 本章节指导用户通过API创建云服务器备份。API的调用方法请参见如何调用API 。 创建备份时，支持云服务器或磁盘等资源备份。本节以云服务器为例，介绍如何创建云服务器备份。 约束限制 该接口以创建按需计费的存储库为例。 涉及接口 创建云服务
变更 功能介绍 订单更新，调用该接口更新包周期产品订单信息,返回待支付订单信息。 该接口目前属于公测阶段，部分region暂时无法使用。 URI POST /v3/{project_id}/orders/change 表1 路径参数 参数 是否必选 参数类型 描述 project_id
本节示例操作包括分页查询，接口支持过滤和排序参数，查询指定资源备份的操作，参数详情请参见查询所有备份。 涉及接口 本示例场景涉及如下接口调用： 指定的limit和offset查询所有备份列表 指定的资源类型查询所有备份列表 操作步骤 指定的limit和offset查询所有备份列表。
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET ht
变更（废弃） 功能介绍 订单更新，创建cbc订单后，调用该接口更新包周期产品订单信息。该接口已废弃。 URI PUT /v3/{project_id}/orders/{order_id} 表1 路径参数 参数 是否必选 参数类型 描述 order_id 是 String 订单ID
tags中最多包含10个key。 tags中key不允许重复。 tags中多个key之间是“与”的关系。 结果返回包含所有标签的资源列表，key之间是与的关系，key-value结构中value是或的关系。 无过滤条件时返回全量数据。 tags_any 否 Array of TagsReq objects
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
