• Elastic Volume Service

evs
  1. Help Center
  2. Elastic Volume Service
  3. API Reference
  4. OpenStack Cinder API v3
  5. EVS Disk Transfer
  6. Accepting an EVS Disk Transfer

Accepting an EVS Disk Transfer

Function

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

URI

  • URI format

    POST /v3/{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 EVS 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 to accept the EVS disk transfer.

  • Parameter in the accept field

    Parameter

    Type

    Mandatory

    Description

    auth_key

    String

    Yes

    Specifies the authentication key of the EVS disk transfer.

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

Response

  • Parameter description

    Parameter

    Type

    Description

    transfer

    map<string, object>

    Specifies the EVS disk transfer information.

    volume_id

    String

    Specifies the EVS disk ID.

    id

    String

    Specifies the EVS disk transfer ID.

    name

    String

    Specifies the name of the EVS disk transfer.

    links

    List< Dict >

    Specifies the links of the EVS 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/v3/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.