Querying All Backups
Function
This API is used to query all backups.
URI
GET /v3/{project_id}/backups
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
checkpoint_id |
No |
String |
Restore point ID |
dec |
No |
Boolean |
Dedicated cloud tag, which only takes effect in dedicated cloud scenarios |
end_time |
No |
String |
Time when the backup ends, in %YYYY-%mm-%ddT%HH:%MM:%SSZ format. For example, 2018-02-01T12:00:00Z. |
enterprise_project_id |
No |
String |
Enterprise project ID or all_granted_eps. all_granted_eps indicates querying the IDs of all enterprise projects on which the user has permissions. |
image_type |
No |
String |
|- |
incremental |
No |
Boolean |
Whether incremental backup is used Default: false |
limit |
No |
Integer |
Number of records displayed per page. The value must be a positive integer. |
marker |
No |
String |
ID of the last record displayed on the previous page |
member_status |
No |
String |
Backup sharing status Enumeration values:
|
name |
No |
String |
Backup name |
offset |
No |
Integer |
Offset value. The value must be a positive integer. |
own_type |
No |
String |
Owning type of a backup. private backups are queried by default. Default: private Enumeration values:
|
parent_id |
No |
String |
Parent backup ID |
resource_az |
No |
String |
AZ-based filtering is supported. |
resource_id |
No |
String |
Resource ID |
resource_name |
No |
String |
Resource name |
resource_type |
No |
String |
|- |
sort |
No |
String |
A group of properties separated by commas (,) and sorting directions. The value is in the format of <key1>[:<direction>],<key2>[:<direction>], where the value of direction is asc (ascending order) or desc (descending order). If a direction is not specified, the default sorting direction is desc. The value of sort can contain a maximum of 255 characters. The key can be as follows: created_at, updated_at, name, status, protected_at, id |
start_time |
No |
String |
Time when the backup starts, in %YYYY-%mm-%ddT%HH:%MM:%SSZ format. For example, 2018-02-01T12:00:00Z. |
status |
No |
String |
Status When the API is called, multiple statuses can be transferred for filtering, for example, status=available&status=error. Enumeration values:
|
used_percent |
No |
String |
Backups are filtered based on the occupied vault capacity. The value ranges from 1 to 100. For example, if used_percent is set to 80, all backups who occupied 80% or more of the vault capacity are displayed. |
vault_id |
No |
String |
Vault ID |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
User token The token can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token. |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
backups |
Array of BackupResp objects |
Backup list |
count |
Integer |
Number of backups |
offset |
Integer |
Offset where the query starts Minimum: 0 Default: 0 |
limit |
Integer |
Number of records displayed on each page Minimum: 1 Maximum: 1000 Default: 1000 |
Parameter |
Type |
Description |
---|---|---|
checkpoint_id |
String |
Restore point ID |
created_at |
String |
Creation time, for example, 2020-02-05T10:38:34.209782 |
description |
String |
Backup description |
expired_at |
String |
Expiration time, for example, 2020-02-05T10:38:34.209782 |
extend_info |
BackupExtendInfo object |
Extended information |
id |
String |
Backup ID |
image_type |
String |
|- |
name |
String |
Backup name |
parent_id |
String |
Parent backup ID |
project_id |
String |
Project ID |
protected_at |
String |
Backup time |
resource_az |
String |
Resource availability zone |
resource_id |
String |
Resource ID |
resource_name |
String |
Resource name |
resource_size |
Integer |
Resource size, in GB |
resource_type |
String |
|- |
status |
String |
Backup status Enumeration values:
|
updated_at |
String |
Update time, for example, 2020-02-05T10:38:34.209782 |
vault_id |
String |
Vault ID |
enterprise_project_id |
String |
Enterprise project ID. Its default value is 0. |
children |
Array of BackupResp objects |
Backup list |
incremental |
Boolean |
Whether it is an incremental backup. |
Parameter |
Type |
Description |
---|---|---|
auto_trigger |
Boolean |
Whether the backup is automatically generated |
bootable |
Boolean |
Whether the backup is a system disk backup |
snapshot_id |
String |
Snapshot ID of the disk backup |
support_lld |
Boolean |
Whether to allow lazyloading for fast restoration |
supported_restore_mode |
String |
Restoration mode. Possible values are na, snapshot, and backup. snapshot indicates the backup can be used to create a full-server image. backup indicates the data is restored from backups of the EVS disks of the server. na indicates the backup can only be used to create new resources but cannot be used for restoration. Default: na Enumeration values:
|
os_images_data |
Array of ImageData objects |
ID list of images created using backups |
contain_system_disk |
Boolean |
Whether the VM backup data contains system disk data |
encrypted |
Boolean |
Whether the backup is encrypted |
system_disk |
Boolean |
Whether the disk is a system disk |
Parameter |
Type |
Description |
---|---|---|
progress |
Integer |
Replication progress |
fail_code |
String |
Error code. This field is empty if the operation is successful. |
fail_reason |
String |
Error cause |
auto_trigger |
Boolean |
Whether replication is automatically scheduled |
destinatio_vault_id |
String |
Destination vault ID |
Example Requests
Querying all backups
GET https://{endpoint}/v3/{project_id}/backups
Example Responses
Status code: 200
OK
{ "count" : 2, "backups" : [ { "provider_id" : "0daac4c5-6707-4851-97ba-169e36266b66", "checkpoint_id" : "1fced58b-2a31-4851-bcbb-96216f83ce99", "updated_at" : "2020-02-21T07:07:25.114+00:00", "vault_id" : "cca85ea5-00a4-418d-9222-bd83985bc515", "id" : "b1c4afd9-e7a6-4888-9010-c2bac3aa7910", "resource_az" : "br-iaas-odin1a", "image_type" : "backup", "resource_id" : "1a503932-ee8f-4dd5-8248-8dfb57e584c5", "resource_size" : 40, "children" : [ ], "extend_info" : { "auto_trigger" : true, "supported_restore_mode" : "backup", "contain_system_disk" : true, "support_lld" : true, "system_disk" : false }, "project_id" : "0605767b5780d5762fc5c0118072a564", "status" : "available", "resource_name" : "test001-02", "description" : "", "expired_at" : "2020-05-21T07:00:54.060+00:00", "name" : "autobk_b629", "created_at" : "2020-02-21T07:00:54.065+00:00", "resource_type" : "OS::Nova::Server" }, { "provider_id" : "d1603440-187d-4516-af25-121250c7cc97", "checkpoint_id" : "f64c351f-769f-4c04-8806-fd90a59e9b12", "updated_at" : "2020-02-21T07:09:37.767+00:00", "vault_id" : "79bd9daa-884f-4f84-b8fe-235d58cd927d", "id" : "5606aab5-2dc2-4498-8144-dc848d099af5", "resource_az" : "br-iaas-odin1a", "image_type" : "backup", "resource_id" : "54f7ccbc-072f-4ec5-a7b7-b24dabdb4539", "resource_size" : 40, "children" : [ ], "extend_info" : { "auto_trigger" : true, "snapshot_id" : "e3def9a8-e4b4-4c12-b132-f4ba8ce9a34f", "bootable" : true, "support_lld" : true, "encrypted" : false, "system_disk" : false }, "project_id" : "0605767b5780d5762fc5c0118072a564", "status" : "available", "resource_name" : "qsy_000", "description" : "", "expired_at" : "2020-03-22T07:00:34.878+00:00", "name" : "autobk_6809", "created_at" : "2020-02-21T07:00:34.882+00:00", "resource_type" : "OS::Cinder::Volume" } ] }
Status Codes
Status Code |
Description |
---|---|
200 |
OK |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot