功能介绍
根据指定id查询单个副本。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v3/{project_id}/backups/{backup_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
backup_id |
是 |
String |
备份ID |
|
project_id |
是 |
String |
项目ID |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
checkpoint_id |
String |
还原点ID |
|
created_at |
String |
创建时间，例如:"2020-02-05T10:38:34.209782" |
|
description |
String |
备份描述 |
|
expired_at |
String |
过期时间，例如:"2020-02-05T10:38:34.209782" |
|
extend_info |
扩展信息 |
|
|
id |
String |
备份ID |
|
image_type |
String |
备份类型。取值为backup和replication。 |
|
name |
String |
备份名称 |
|
parent_id |
String |
父备份ID |
|
project_id |
String |
项目ID |
|
protected_at |
String |
备份时间 |
|
resource_az |
String |
资源可用区 |
|
resource_id |
String |
资源ID |
|
resource_name |
String |
资源名称 |
|
resource_size |
Integer |
资源大小，单位为GB |
|
resource_type |
String |
资源类型: OS::Nova::Server, OS::Cinder::Volume, OS::Ironic::BareMetalServer, OS::Native::Server, OS::Sfs::Turbo, OS:: Workspace ::DesktopV2 |
|
status |
String |
备份状态 枚举值：
|
|
updated_at |
String |
更新时间，例如:"2020-02-05T10:38:34.209782" |
|
vault_id |
String |
存储库ID |
|
replication_records |
复制记录 |
|
|
ent erp rise_project_id |
String |
企业项目id,默认为‘0’。 |
|
provider_id |
String |
备份提供商ID，用于区分备份对象。当前取值包含： 0daac4c5-6707-4851-97ba-169e36266b66，该值代表备份对象为 云服务器 。d1603440-187d-4516-af25-121250c7cc97，该值代表备份对象为 云硬盘 。3f3c3220-245c-4805-b811-758870015881， 该值代表备份对象为 SFS Turbo。a13639de-00be-4e94-af30-26912d75e4a2，该值代表备份对象为混合云VMware备份。 |
|
children |
子副本列表 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
auto_trigger |
Boolean |
是否是自动生成的备份副本 |
|
bootable |
Boolean |
是否系统盘备份 |
|
incremental |
Boolean |
是否是增备 |
|
snapshot_id |
String |
卷备份副本的快照id |
|
support_lld |
Boolean |
是否支持lazyloading快速恢复 |
|
supported_restore_mode |
String |
备份支持恢复的方式，当前取值包含na,snapshot和backup。如果该字段取值为snapshot，代表备份此时已经支持创建整机 镜像 ；如果该字段取值为backup，备份支持通过 云服务 器上硬盘的备份进行恢复；如果该字段取值为na，备份不支持直接恢复，只支持备份创建新资源等操作。 缺省值：na 枚举值：
|
|
os_images_data |
备份注册镜像ID列表 |
|
|
contain_system_disk |
Boolean |
整机备份是否包含系统盘 |
|
encrypted |
Boolean |
是否加密 |
|
system_disk |
Boolean |
是否是系统盘 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
created_at |
String |
复制的开始时间 |
|
destination_backup_id |
String |
复制的目的备份ID |
|
destination_checkpoint_id |
String |
复制的目的备份记录ID |
|
destination_project_id |
String |
复制的目标项目ID |
|
destination_region |
String |
复制的目标区域 |
|
destination_vault_id |
String |
目标存储库ID |
|
extra_info |
复制附加信息 |
|
|
id |
String |
复制记录ID |
|
source_backup_id |
String |
复制的源备份ID |
|
source_checkpoint_id |
String |
复制的源备份记录ID |
|
source_project_id |
String |
复制的源项目ID |
|
source_region |
String |
复制的源区域 |
|
status |
String |
复制的状态 枚举值：
|
|
vault_id |
String |
备份所在的存储库ID |
请求示例
查询单个备份副本。
GET https://{endpoint}/v3/{project_id}/backups/{backup_id}
响应示例
状态码： 200
OK
{
"backup" : {
"provider_id" : "0daac4c5-6707-4851-97ba-169e36266b66",
"checkpoint_id" : "8b0851a8-adf3-4f4c-a914-dead08bf9664",
"enterprise_project_id" : "0",
"updated_at" : null,
"vault_id" : "3b5816b5-f29c-4172-9d9a-76c719a659ce",
"id" : "6df2b54c-dd62-4059-a07c-1b8f24f2725d",
"resource_az" : "az1.dc1",
"image_type" : "backup",
"resource_id" : "94eba8b2-acc9-4d82-badc-127144cc5526",
"resource_size" : 40,
"children" : [ {
"provider_id" : "0daac4c5-6707-4851-97ba-169e36266b66",
"checkpoint_id" : "8b0851a8-adf3-4f4c-a914-dead08bf9664",
"updated_at" : null,
"vault_id" : "3b5816b5-f29c-4172-9d9a-76c719a659ce",
"id" : "5d822633-2bbf-4af8-a16e-5ab1c7705235",
"resource_az" : null,
"image_type" : "backup",
"resource_id" : "eccbcfdd-f843-4bbb-b2c0-a5ce861f9376",
"resource_size" : 40,
"children" : [ ],
"parent_id" : "6df2b54c-dd62-4059-a07c-1b8f24f2725d",
"extend_info" : {
"auto_trigger" : true,
"supported_restore_mode" : null,
"os_images_data" : null,
"snapshot_id" : "5230a977-1a94-4092-8edd-519303a44cda",
"bootable" : true,
"support_lld" : null,
"encrypted" : true
},
"project_id" : "4229d7a45436489f8c3dc2b1d35d4987",
"status" : "available",
"resource_name" : "ecs-1f0f-0002",
"description" : null,
"expired_at" : null,
"name" : "autobk_a843_ecs-1f0f-0002",
"created_at" : "2019-05-10T07:59:59.450700",
"protected_at" : null,
"resource_type" : "OS::Cinder::Volume"
} ],
"parent_id" : null,
"extend_info" : {
"auto_trigger" : true,
"supported_restore_mode" : "backup",
"os_images_data" : null,
"contain_system_disk" : true,
"snapshot_id" : null,
"bootable" : null,
"support_lld" : true
},
"project_id" : "4229d7a45436489f8c3dc2b1d35d4987",
"status" : "available",
"resource_name" : "ecs-1f0f-0002",
"description" : "backup_description",
"expired_at" : null,
"name" : "backup_name",
"created_at" : "2019-05-10T07:59:12.084695",
"protected_at" : null,
"resource_type" : "OS::Nova::Server"
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
错误码
请参见错误码。
