• Native OpenStack API

noa
  1. Help Center
  2. Native OpenStack API
  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 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

  • 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/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.