Updated on 2022-02-22 GMT+08:00

Querying All Backups

Function

This API is used to query all backups. Filtering parameters are supported.

URI

  • URI format

    GET https://{endpoint}/v1/{project_id}/checkpoint_items

  • Parameter description
    Table 1 Parameter description

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    String

    Project ID

    For details about how to obtain the project ID, see Obtaining a Project ID.

Request

  • Parameter description
    Table 2 Parameter description

    Parameter

    Mandatory

    Type

    Description

    status

    No

    String

    Query based on field status is supported.

    Value range: waiting_protect, protecting, available, waiting_restore, restoring, error, waiting_delete, deleting, and deleted

    limit

    No

    Integer

    Number of resources displayed per page. The value must be a positive integer. The value defaults to 1000.

    marker

    No

    String

    ID of the last record displayed on the previous page

    sort

    No

    String

    A group of properties separated by commas (,) and sorting directions. The value format is <key1>[:<direction>],<key2>[:<direction>], where the value of direction is asc (in ascending order) or desc (in descending order). If the parameter direction is not specified, the default sorting direction is desc. The value of sort contains a maximum of 255 characters. Enumeration values of the key are as follows: created_at, updated_at, name, status, protected_at, and id.

    all_tenants

    No

    Boolean

    Whether to query the backup of all tenants. Only administrators can query the backup of all tenants.

    name

    No

    String

    Fuzzy search based on field name is supported.

    az

    No

    String

    Filtering based on the backup AZ is supported.

    resource_id

    No

    String

    Filtering based on the backup object ID is supported.

    resource_name

    No

    String

    Fuzzy search based on the backup object name is supported.

    start_time

    No

    String

    Filtering based on the backup start time is supported.

    For example: 2017-04-18T01:21:52.701973

    end_time

    No

    String

    Filtering based on the backup end time is supported.

    For example: 2017-04-18T01:21:52.701973

    image_type

    No

    String

    Supports filtering by image type, for example, backup.

    policy_id

    No

    String

    Filtering based on policy_id is supported.

    offset

    No

    Integer

    Offset value, which is a positive integer.

    checkpoint_id

    No

    String

    Filtering based on checkpoint_id is supported.

    resource_type

    No

    String

    Type of the backup object. For example, OS::Nova::Server

  • Parameter description

    None

  • Example request
    Querying all backups:
    GET https://{endpoint}/v1/{project_id}/checkpoint_items
    Querying backups with specified parameters:
    GET https://{endpoint}/v1/{project_id}/checkpoint_items?name=backup&status=error&limit=2

Response

  • Parameter description
    Table 3 Parameter description

    Parameter

    Type

    Description

    checkpoint_items

    List<checkpoint_item>

    -

  • Parameter description of field checkpoint_item
    Table 4 Parameter description of field checkpoint_item

    Parameter

    Type

    Description

    checkpoint_id

    String

    Backup record ID

    created_at

    String

    Creation time, for example, 2017-04-18T01:21:52.701973

    extend_info

    Dict

    Extension information

    id

    String

    Backup ID

    name

    String

    Backup name

    resource_id

    String

    ID of the object to be backed up

    status

    String

    Backup status

    The value can be waiting_protect, protecting, available, waiting_restore, restoring, error, waiting_delete, deleting, or deleted.

    updated_at

    String

    Modification time, for example, 2017-04-18T01:21:52.701973

    backup_data

    Dict

    VM metadata

    description

    string

    Backup description

    resource_type

    String

    Type of backup objects

  • Parameter description of field extend_info
    Table 5 Parameter description of field extend_info

    Parameter

    Type

    Description

    auto_trigger

    Boolean

    Whether automatic trigger is enabled

    average_speed

    Integer

    Average rate. The unit is kb/s

    copy_from

    String

    The destination region of a backup replication. The default value is empty.

    copy_status

    String

    Backup replication status. The default value is na.

    Possible values are na, waiting_copy, copying, success, and fail.

    fail_code

    fail_code

    Error code

    fail_op

    String

    Type of the failed operation

    Enum: [backup, restore, delete]

    fail_reason

    String

    Failure cause

    image_type

    String

    Backup type, for example, backup

    incremental

    Boolean

    Whether the backup is an enhanced backup

    progress

    Integer

    Replication progress. The value is an integer ranging from 0 to 100.

    resource_az

    String

    AZ to which the backup resource belongs

    resource_name

    String

    Backup object name

    resource_type

    String

    Type of the backup object. For example, OS::Nova::Server

    size

    Integer

    Backup capacity. The unit is MB.

    space_saving_ratio

    Integer

    Space saving rate

    volume_backups

    List<volume_backup>

    Volume backup list

    finished_at

    String

    Backup completion time, for example, 2017-04-18T01:21:52.701973

    supported_restore_mode

    String

    Restoration mode. Possible values are na, snapshot, and backup.

    If the value is snapshot, the backup can be used to create a full-server image.

    backup: Data is restored from backups of the EVS disks of the server.

    na: Restoration is not supported.

    os_images_data

    List<image_data>

    Image data. This parameter has a value if an image has been created for the VM.

    support_lld

    Boolean

    Whether to allow lazyloading for fast restoration

    taskid

    String

    Job ID

    hypervisor_type

    String

    Virtualization type

    The value is fixed at QEMU.

  • Parameter description of field image_data
    Table 6 Parameter description of field image_data

    Parameter

    Type

    Description

    image_id

    String

    Image ID

  • Parameter description of field backup_data
    Table 7 Parameter description of field backup_data

    Parameter

    Type

    Description

    __openstack_region_name

    String

    Name of the AZ where the server is located. If this parameter is left blank, such information about the server has not been obtained.

    cloudservicetype

    String

    Server type

    disk

    Integer

    System disk size corresponding to the server specifications

    imagetype

    String

    Image type

    The value can be:

    gold: public image

    private: private image

    market: market image

    ram

    Integer

    Memory size of the server, in MB

    vcpus

    Integer

    CPU cores corresponding to the server

    eip

    String

    Elastic IP address of the server. If this parameter is left blank, such information about the server has not been obtained.

    private_ip

    String

    Internal IP address of the server. If this parameter is left blank, such information about the server has not been obtained.

  • Parameter description of field fail_code
    Table 8 Parameter description of field fail_code

    Parameter

    Type

    Description

    Code

    Long

    Error code

    Description

    String

    Error description

  • Parameter description of field volume_backup
    Table 9 Parameter description of field volume_backup

    Parameter

    Type

    Description

    average_speed

    Integer

    Average rate, in MB/s

    bootable

    Boolean

    Whether the disk is bootable

    The value can be true or false.

    id

    String

    Cinder backup ID

    image_type

    String

    Backup set type: backup

    Enum:[ backup]

    incremental

    Boolean

    Whether incremental backup is used

    name

    String

    EVS disk backup name

    size

    Integer

    Accumulated size (MB) of backups

    source_volume_id

    String

    Source disk ID

    source_volume_size

    Integer

    Source volume size in GB

    space_saving_ratio

    Integer

    Space saving rate

    status

    String

    Status

    source_volume_name

    String

    Source volume name

    snapshot_id

    String

    ID of the snapshot from which the backup is generated

  • Example response
    {
      "checkpoint_items" : [ {
        "status" : "available",
        "backup_data" : {
          "eip" : "",
          "cloudservicetype" : "",
          "ram" : 4096,
          "vcpus" : 4,
          "__openstack_region_name" : "",
          "private_ip" : "",
          "disk" : 0,
          "imagetype" : ""
        },
        "name" : "backup_d32c",
        "resource_id" : "f45c477a-57e5-465f-999f-d845083962db",
        "created_at" : "2017-04-15T04:20:37.277880",
        "checkpoint_id" : "f672a1bb-6912-446a-816c-72792c5263e0",
        "updated_at" : "2017-04-15T04:25:38.680638",
        "resource_type": "OS::Nova::Server",
        "extend_info" : {
          "auto_trigger" : false,
          "space_saving_ratio" : 0,
          "copy_status" : "na",
          "fail_reason" : "",
          "resource_az" : "az1.dc1",
          "image_type" : "backup",
          "finished_at" : "2017-04-15T04:25:38.675478",
          "average_speed" : 0,
          "copy_from" : "",
          "supported_restore_mode": "backup",
          "support_lld": false,
          "os_images_data": [
                {
                    "image_id": "fe84dd80-0229-4918-8d3d-cbb33154b565"
                }
           ],
          "volume_backups" : [ {
            "status" : "available",
            "space_saving_ratio" : 0,
            "name" : "manualbk_47222",
            "bootable" : true,
            "average_speed" : 0,
            "source_volume_size" : 20,
            "source_volume_id" : "ee27f809-6fb5-40ae-ac46-c932bb4ee8fe",
            "incremental" : false,
            "image_type" : "backup",
            "source_volume_name" : "karbor_xj_02",
            "id" : "70675cbc-d3a8-43a7-9f81-c8b6bc3f5d6d",
            "size" : 0,
            "snapshot_id": "36f520e1-d2ea-4907-956a-3d9cd53e2d38"
          }, {
            "status" : "available",
            "space_saving_ratio" : 0,
            "name" : "manualbk_47222",
            "bootable" : true,
            "average_speed" : 0,
            "source_volume_size" : 20,
            "source_volume_id" : "e7f48980-927c-48de-afd4-f0245d2e5100",
            "incremental" : false,
            "image_type" : "backup",
            "source_volume_name" : "karbor_01",
            "id" : "8eb98e91-8924-4d4b-b6d6-28fb7b751e9c",
            "size" : 0,
            "snapshot_id": "36f520e1-d2ea-4907-956a-3d9cd53e2d38"
          } ],
          "fail_code" : { },
          "incremental" : false,
          "taskid" : "e0a21692-2192-11e7-bf23-0242ac110007",
          "hypervisor_type" : "QEMU",
          "progress" : 100,
          "fail_op" : "",
          "resource_name" : "karbor_02",
          "size" : 0
        },
        "id" : "90c1d5fa-1b9f-4aeb-b2f4-81c806e98190"
      } ]
    }

Status Codes

  • Normal

    Status Code

    Description

    200

    OK

  • Abnormal

    Status Code

    Description

    400

    Invalid request parameters.

    401

    Authentication failed.

    403

    No operation permission.

    404

    Requested object not found.

    500

    Service internal error.

    503

    Service unavailable.

Error Codes

For details, see Error Codes.