Accepting a Disk Transfer

Function

This API is used to accept a disk transfer through the transfer ID and authentication key.

Constraints

• EVS disks with backups and snapshots available cannot be transferred.
• EVS disks associated with backup policies cannot be transferred.
• EVS disks used as system disks cannot be transferred.

If the disk transfer is created using one of the unsupported disks, error code 400 will be returned.

URI

• URI format

  POST /v2/{project_id}/os-volume-transfer/{transfer_id}/accept

• 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

• Parameter description

  Parameter	Type	Mandatory	Description
  accept	Object	Yes	Specifies the disk transfer acceptance marker. For details, see Parameter in the accept field.

• Parameter in the accept field

  Parameter	Type	Mandatory	Description
  auth_key	String	Yes	Specifies the authentication key of the disk transfer. Specifies the authentication key returned during the disk transfer creation.

• Example request

  {
      "accept": {
          "auth_key": "9266c59563c84664"
      }
  }

Response

• Parameter description

  Parameter	Type	Description
  transfer	Object	Specifies the disk transfer information. For details, see Parameters in the transfer field.

• Parameters in the transfer field

  Parameter	Type	Description
  volume_id	String	Specifies the disk ID.
  id	String	Specifies the disk transfer ID.
  name	String	Specifies the name of the disk transfer.
  links	List< Dict >	Specifies the links of the disk transfer.

• Example response

  {
      "transfer": {
          "id": "cac5c677-73a9-4288-bb9c-b2ebfb547377", 
          "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

  202

Error Codes

For details, see Error Codes.