• Native OpenStack API

noa
  1. Help Center
  2. Native OpenStack API
  3. API Reference
  4. OpenStack Cinder API v2
  5. EVS Disk Transfer
  6. Accepting a Disk Transfer

Accepting a Disk Transfer

Function

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

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.

    transfer_id

    Yes

    Specifies the disk transfer ID.

Constraints

  • Encrypted EVS disks cannot be transferred.
  • 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.
  • EVS disks in EVS replication pairs cannot be transferred.
NOTE:

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

Request

  • Parameter description

    Parameter

    Type

    Mandatory

    Description

    accept

    map<string, string>

    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.

  • Example request
    {
        "accept": {
            "auth_key": "9266c59563c84664"
        }
    }

Response

  • Parameter description

    Parameter

    Type

    Description

    transfer

    map<string, 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"
                }
            ]
        }
    }

Returned Values

  • Normal

    202

Error Codes

For details, see Error Codes.