• Native OpenStack API

noa
  1. Help Center
  2. Native OpenStack API
  3. API Reference
  4. OpenStack Cinder API v2
  5. EVS Disk Transfer
  6. Querying Details of All Disk Transfers

Querying Details of All Disk Transfers

Function

This API is used to query the details of all disk transfers, including the transfer creation time, transfer IDs, and transfer names.

URI

  • URI format

    GET /v2/{project_id}/os-volume-transfer/detail

  • Parameter description

    Parameter

    Mandatory

    Description

    project_id

    Yes

    Specifies the project ID.

  • Request filter parameters

    Parameter

    Type

    Mandatory

    Description

    limit

    int

    No

    Specifies the maximum number of query results that can be returned.

    The value ranges from 1 to 1000, and the default value is 1000. The returned value cannot exceed this limit.

    offset

    int

    No

    Specifies the offset. If the value is an integer greater than 0 but less than the number of the total disk transfers, the parameter queries all disk transfers after this offset.

Request

The following example shows how to query the details of disk transfers whose limit is no more than 50.

  • Example request
    GET https://{endpoint}/v2/{project_id}/os-volume-transfer/detail?limit=50

Parameter description

  • Parameters in the transfers field

    Parameter

    Type

    Description

    links

    List< Dict >

    Specifies the links of the disk transfer.

    created_at

    String

    Specifies the time when the disk transfer was created.

    Time format: UTC YYYY-MM-DDTHH:MM:SS

    volume_id

    String

    Specifies the disk ID.

    id

    String

    Specifies the disk transfer ID.

    name

    String

    Specifies the name of the disk transfer.

  • Example response
    {
        "transfers": [
            {
                "id": "cac5c677-73a9-4288-bb9c-b2ebfb547377", 
                "created_at": "2015-02-25T03:56:53.081642", 
                "name": "first volume transfer", 
                "volume_id": "894623a6-e901-4312-aa06-4275e6321cce", 
                "links": [
                    {
                        "href": "https://localhost/v2/firstproject/os-volume-transfer/1", 
                        "rel": "self"
                    }, 
                    {
                        "href": "https://localhost/firstproject/os-volume-transfer/1", 
                        "rel": "bookmark"
                    }
                ]
            }, 
            {
                "id": "f26c0dee-d20d-4e80-8dee-a8d91b9742a1", 
                "created_at": "2015-03-25T03:56:53.081642", 
                "name": "second volume transfer", 
                "volume_id": "673db275-379f-41af-8371-e1652132b4c1", 
                "links": [
                    {
                        "href": "https://localhost/v2/firstproject/os-volume-transfer/2", 
                        "rel": "self"
                    }, 
                    {
                        "href": "https://localhost/firstproject/os-volume-transfer/2", 
                        "rel": "bookmark"
                    }
                ]
            }
        ]
    }

Returned Values

  • Normal

    200

Error Codes

For details, see Error Codes.