Querying Details of a Disk Transfer

Function

This API is used to query the details of a disk transfer, including the transfer creation time, transfer ID, and transfer name.

URI

• URI format

  GET /v3/{project_id}/os-volume-transfer/{transfer_id}

• Parameter description

  Parameter	Mandatory	Description
  project_id	Yes	Specifies the project ID. For details about how to obtain the project ID, see Obtaining a Project ID.
  transfer_id	Yes	Specifies the disk transfer ID.

Request

• Example request

  GET  https://{endpoint}/v3/{project_id}/os-volume-transfer/cac5c677-73a9-4288-bb9c-b2ebfb547377

Response

• Response parameters

  Parameter	Type	Description
  transfer	Object	The transfer details. For details, see Parameters in the transfer field.

• Parameters in the transfer field

  Parameter	Type	Description
  links	Array of Objects	The links of the transfer. See Parameters in the links field.
  created_at	String	The time when the transfer was created. Time format: UTC YYYY-MM-DDTHH:MM:SS.XXXXXX
  volume_id	String	The disk ID.
  id	String	The transfer ID.
  name	String	The transfer name.

• Parameters in the links field

  Parameter	Type	Description
  href	String	The corresponding shortcut link.
  rel	String	The shortcut link marker name. The default value is next.

• Example response

  {
      "transfer": {
          "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"
              }
          ]
      }
  }

Status Codes

• Normal

  200

Error Codes

For details, see Error Codes.