• Native OpenStack API

noa
  1. Help Center
  2. Native OpenStack API
  3. API Reference
  4. Cinder V2 Interfaces
  5. Volume transfer
  6. Accept volume transfer

Accept volume transfer

Function Description

This interface is used to accept a volume transfer.

Interface Format

Method

URI

Description

POST

/v2/{tenant_id}/os-volume-transfer/{transfer_id}/accept

Accepts a volume transfer.

Restrictions

This interface cannot be used to accept a transfer for the following types of volumes:

  • Volumes charged by period
  • Encrypted volumes
  • Volumes with backups and snapshots available.
  • Frozen volumes
  • DSS/DESS volumes
  • System volumes
  • HyperMetro volumes
  • Volumes with backup policies configured

Extension Description

N/A

Request Parameter

Parameter

Type

Mandatory

Remarks

auth_key

String

Yes

Specifies the transfer authentication key.

Response Parameter

Parameter

Type

Mandatory

Remarks

volume_id

String

Yes

Specifies the volume ID of the transfer.

id

String

Yes

Specifies the transfer ID.

name

String

Yes

Indicates the transfer name.

links

List< Dict >

Yes

Specifies the link of the volume transfer.

Request Example

POST /v2/5dd0b0056f3d47b6ab4121667d35621a/os-volume-transfer/cac5c677-73a9-4288-bb9c-b2ebfb547377/accept
{
    "accept": {
        "auth_key": "9266c59563c84664"
    }
}

Response Example

{
    "transfer": {
        "id": "cac5c677-73a9-4288-bb9c-b2ebfb547377",
        "name": "first volume transfer",
        "volume_id": "894623a6-e901-4312-aa06-4275e6321cce",
        "links": [
            {
                "href": "http://localhost/v2/firstproject/volumes/1",
                "rel": "self"
            },
            {
                "href": "http://localhost/firstproject/volumes/1",
                "rel": "bookmark"
            }
        ]
    }
}

Error Code

See section Processing Return Code.