检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 云备份所提供的接口均为CBR接口,您可以通过这些接口完整的使用云备份的所有功能。 表1 接口说明 类型 说明 任务 可以查询任务列表和单个任务的情况。 可保护性 可以查询所在区域的复制能力,本区域是否支持复制备份和存储库。 存储库 可以实现创建存储库、存储库查询、为存储库绑定策略等操作。
API 运营 文件应用备份 任务 存储库 项目 策略 备份 可保护性 备份共享 组织策略 标签 还原点 计量
查询租户信息 功能介绍 由控制台调用的内部接口,用于仅在查询共享备份时获取源project_id的域名信息,目前仅能查询当前账号下的项目信息。 URI GET /v3/domain/{source_project_id} 表1 路径参数 参数 是否必选 参数类型 描述 source_project_id
云服务器备份和云硬盘备份有什么区别? 两者的主要差异如表1所示。 表1 云服务器备份和云硬盘备份的区别 对比维度 云服务器备份 云硬盘备份 备份/恢复对象 服务器中的全部(系统盘和数据盘)或部分云硬盘 指定的单个或多个磁盘(系统盘或数据盘) 推荐场景 需要对整个云服务器进行保护
如何调用API 构造请求 认证鉴权 返回结果
项目 查询租户的项目信息 查询租户项目列表 查询租户信息 租户迁移 查询迁移 父主题: API
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 对于管理员创建IAM用户接口,您可以从接口的请求部分看到所需的请求参数及参数
权限和授权项 权限及授权项说明 CBR授权项分类
gs cbr:vaults:listProjectTags √ √ 客户端 权限 对应API接口 授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 注册客户端 POST /v3/{project_id}/agents cbr:agents:register
对应请求消息头,响应同样也有消息头,如“Content-type”。 对于管理员创建IAM用户接口,返回如图1所示的消息头,其中“X-Subject-Token”就是需要获取的用户Token。有了Token之后,您就可以使用Token认证调用其他API。 建议在配置文件或者环境变量中密文存放,使用时解密,确保安全。
账号具备所有接口的调用权限,如果使用账号下的IAM用户发起API请求时,该IAM用户必须具备调用该接口所需的权限,否则,API请求将调用失败。每个接口所需要的权限,与各个接口所对应的授权项相对应,只有发起请求的用户被授予授权项所对应的策略,该用户才能成功调用该接口。例如,用户要
由账号在IAM中创建的用户,是云服务的使用人员,具有身份凭证(密码和访问密钥)。 在我的凭证下,您可以查看账号ID和IAM用户ID。通常在调用API的鉴权过程中,您需要用到账号、用户和密码等信息。 区域(Region) 从地理位置和网络时延维度划分,同一个Region内共享弹性计算、块存储
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token,即调用获取用户Token接口时,请求body中auth.scope的取值需要选择project,如下所示。
目前TMS调用时,key下面只包含一个value,0表示默认企业项目。 sys_tags和租户标签过滤条件(tags、tags_any、not_tags、not_tags_any)不能同时使用。 无sys_tags时按照tag接口处理,无tag过滤条件时返回全量数据。 sys_tags不能为空列表 limit
请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 restore 是 BackupRestore
否 String 状态。 调用API时,支持通过传多个status值进行过滤。例如:status=available&status=error used_percent 否 String 根据存储库使用率过滤备份,取值范围 [1, 100],含1和100。例如,used_perc
装Agent时失败。 可能原因 原因1:DNS无法正常解析OBS的域名。 原因2:目标云服务器openssl版本过低。 原因1解决方法 原因1:DNS无法正常解析obs.myhuaweicloud.com安装域名。 需要手动将DNS修改为华为云内网DNS地址。如果修改DNS后仍无
BackupExtendInfo object 扩展信息 id String 备份ID image_type String 备份类型。取值为backup和replication。 name String 备份名称 parent_id String 父备份ID project_id String
获取项目ID 操作场景 在调用接口的时候,部分URL中需要填入项目ID,所以需要获取到项目ID。有如下两种获取方式: 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https:
查询存储库资源实例 批量添加删除存储库资源标签 添加存储库资源标签 删除存储库资源标签 查询存储库资源标签 查询存储库项目标签 父主题: API