Querying All Backups

Function

This API is used to query all backups.

URI

GET /v3/{project_id}/backups

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. Default value: N/A

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
checkpoint_id	No	String	Checkpoint ID. Default value: N/A
dec	No	Boolean	Whether it is a DeC scenario. The value can be true (DeC scenario) or false (non-DeC scenario).
end_time	No	String	Time when the backup ends, in %YYYY-%mm-%ddT%HH:%MM:%SSZ format. For example, 2018-02-01T12:00:00Z.
image_type	No	String	Backup type. The value can be backup (common backup) or replication (cross-region replication backup).
incremental	No	Boolean	Whether the backup is an incremental backup. true: incremental backup false: full backup
limit	No	Integer	Maximum number of records to be returned. The value ranges from 1 to 1000. The default value is 1000.
marker	No	String	ID of the last record displayed on the previous page
member_status	No	String	Sharing status. The value can be: pending: The sharing invitation has been sent, but the target project (or user) has not accepted or rejected the request. accepted: The target project (or user) has accepted the request and can use the backup in their vault. rejected: The target project (or user) has rejected the request.
name	No	String	Backup name. The value can contain a maximum of 255 characters, including only letters, digits, underscores (_), and hyphens (-).
offset	No	Integer	Offset. The default value is 0.
own_type	No	String	Ownership type. The default value is private. private: private backup. Only the backups owned in the current project are queried. shared: shared backup. Backups shared by other projects to the current project are queried. all_granted: all backups. All private and shared backups are queried.
parent_id	No	String	Parent backup ID, in UUID format.
resource_az	No	String	ID of the region where the backup resources are located.
resource_id	No	String	Resource ID, in UUID format.
resource_name	No	String	Resource name, which can contain a maximum of 255 characters.
resource_type	No	String	Type of the resource to be backed up: OS::Nova::Server: ECS; OS::Cinder::Volume: EVS disks; OS::Ironic::BareMetalServer: Bare Metal Servers; OS::Sfs::Turbo: SFS Turbo file systems; OS::Workspace::DesktopV2: Workspaces
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	Backup status. When the API is called, multiple status values can be transferred for filtering. Example: status=available&status=error The options are as follows: available: The backup is available. protecting: The backup is being protected. deleting: The backup is being deleted. restoring: The restoration in progress. error: The backup is abnormal. waiting_protect: The backup is waiting to be protected. waiting_delete: The backup is waiting to be deleted. waiting_restore: The backup is waiting to be restored.
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

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. You can obtain it by calling the IAM API for obtaining a user token. The user token is the value of X-Subject-Token in the response header. Default value: N/A

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
backups	Array of BackupResp objects	Backup list
count	Integer	Number of backups. Range: N/A
offset	Integer	Offset from which the query starts. The value must be greater than 0.
limit	Integer	Number of records displayed on each page. Range: 1 to 1000.

**Table 5** BackupResp
Parameter	Type	Description
checkpoint_id	String	Checkpoint ID.
created_at	String	Creation time, for example, 2020-02-05T10:38:34.209782.
description	String	Backup description. Range: N/A
expired_at	String	Expiration time, for example, 2020-02-05T10:38:34.209782.
extend_info	BackupExtendInfo object	Extended information. Range: N/A
id	String	Backup ID. Range: N/A
image_type	String	Backup type. The value can be backup (common backup) or replication (cross-region replication backup).
name	String	Backup name. The value can contain a maximum of 64 characters, including digits, uppercase letters, lowercase letters, underscores (_), and hyphens (-).
parent_id	String	Parent backup ID. Range: N/A
project_id	String	Project ID. Range: N/A
protected_at	String	Backup time. Range: N/A
resource_az	String	Resource AZ. Range: N/A
resource_id	String	Resource ID, in UUID format. You can query the resource status based on the type of the resource to be backed up.
resource_name	String	Name of the resource to be backed up. The value can contain a maximum of 255 characters.
resource_size	Integer	Resource size, in GB. Range: N/A
resource_type	String	Type of the resource to be backed up: OS::Nova::Server: ECS; OS::Cinder::Volume: EVS disks; OS::Ironic::BareMetalServer: Bare Metal Servers; OS::Sfs::Turbo: SFS Turbo file systems
status	String	Backup status. The value can be: available: The backup is available. protecting: The backup is being protected. deleting: The backup is being deleted. restoring: The restoration in progress. error: The backup is abnormal. waiting_protect: The backup is waiting to be protected. waiting_delete: The backup is waiting to be deleted. waiting_restore: The backup is waiting to be restored.
updated_at	String	Update time, for example, 2020-02-05T10:38:34.209782.
vault_id	String	Vault ID. Range: N/A
replication_records	Array of ReplicationRecordGet objects	Replication record. Range: N/A
enterprise_project_id	String	Enterprise project ID.
provider_id	String	Backup provider ID, which is used to distinguish backup objects. The value can be as follows: 0daac4c5-6707-4851-97ba-169e36266b66 indicates that backup objects are cloud servers; d1603440-187d-4516-af25-121250c7cc97 indicates that backup objects are cloud disks; 3f3c3220-245c-4805-b811-758870015881 indicates that backup objects are SFS Turbo file systems; a13639de-00be-4e94-af30-26912d75e4a2 indicates that backup objects are hybrid cloud VMware backups.
children	Array of BackupResp objects	Backup list
incremental	Boolean	Whether it is an incremental backup. true: incremental backup. false: full backup.
version	Integer	Replica snapshot type. Range: N/A

**Table 6** BackupExtendInfo
Parameter	Type	Description
auto_trigger	Boolean	Whether the backup is automatically generated. Default value: N/A true: The backup is automatically generated. false: The backup is not automatically generated. The value can be:
bootable	Boolean	Whether the backup is a system disk backup. Default value: N/A The value can be: true: The backup is a system disk backup. false: The backup is not a system disk backup.
snapshot_id	String	Snapshot ID of the disk backup
support_lld	Boolean	Whether to allow lazy loading for fast restoration. Default value: N/A The value can be: true: Allow lazy loading for fast restoration. false: Do not allow lazy loading for fast restoration.
supported_restore_mode	String	Whether the backup can be directly used for restoration. Default value: N/A The value can be: na: The backup cannot be directly used for restoration. It can only be used to create resources. backup: Cloud disk backups can be used for restoration. snapshot: Backups can be used to create full-server images.
os_images_data	Array of ImageData objects	ID list of images created using backups
contain_system_disk	Boolean	Whether the VM backup contains system disk data. Default value: N/A The value can be: true: The VM backup contains system disk data. false: The VM backup does not contain system disk data.
encrypted	Boolean	Whether the backup is encrypted. Default value: N/A true: The backup is encrypted. false: The backup is not encrypted.
system_disk	Boolean	Whether it is a system disk. Default value: N/A The value can be: true: system disk false: non-system disk

**Table 7** ImageData
Parameter	Type	Description
image_id	String	Image ID

**Table 8** ReplicationRecordGet
Parameter	Type	Description
created_at	String	Start time of the replication
destination_backup_id	String	ID of the backup in the destination region. Default value: N/A
destination_checkpoint_id	String	Record ID of the destination backup used for replication
destination_project_id	String	Project ID of the destination region. Default value: N/A
destination_region	String	Target region. Default value: N/A
destination_vault_id	String	ID of the destination vault. Default value: N/A
extra_info	ReplicationRecordsExtraInfo object	Additional information of the replication
id	String	Replication record ID
source_backup_id	String	ID of the project in the source region. Default value: N/A
source_checkpoint_id	String	ID of the source backup record used for replication
source_project_id	String	ID of the project in the source region. Default value: N/A
source_region	String	Source region. Default value: N/A
status	String	Replication status
vault_id	String	ID of the vault where the backup resides

**Table 9** ReplicationRecordsExtraInfo
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 the task is automatically triggered. Default value: false. true: The task is automatically triggered. false: The task is not automatically triggered.
destination_vault_id	String	Destination vault ID.

Example Requests

Querying all backups

GET https://{endpoint}/v3/{project_id}/backups

Example Responses

Status code: 200

{
  "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.

Parent topic: Backups

Previous topic: Querying a Specified Backup

Next topic: Deleting a Backup

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.

The system is busy. Please try again later.