Volumes

Perform action on a volume or multiple volumes

put/v1/volumes

Request

  • Base URL: https://api.verda.com
  • URL: https://api.verda.com/v1/volumes
  • Auth: HTTP bearer

Request body

action'attach' | 'detach' | 'delete' | 'rename' | 'resize' | 'restore' | 'clone' | 'cancel' | 'create' | 'export' | 'transfer' required

Action to perform on the volume(s)

The clone action returns its destination volume ID: {"id":"..."}. Send a cancel action with that same ID to interrupt a cross-datacenter clone.

sizenumber

New volume size in GB. Can't be lower than current size

instance_idstring

Instance ID to attach the volume to, if the action is attach

instance_idsstring[]

Array of instance IDs to attach the volume to, if the action is attach

namestring

New volume name

typestring

Target volume type

is_permanentboolean

If deleting volume(s), delete them permanently

location_codestring

Target location code if cloning the volume

Example request

{
  "action": "detach",
  "size": 100,
  "instance_id": "680255c9-4289-4e0b-b480-e2481168036b",
  "instance_ids": [
    "e3375edf-0ff9-487e-a290-a2770fdc148d",
    "a38c1600-3e37-4030-a01f-80fcb7a04eac"
  ],
  "name": "volume-name",
  "type": "NVMe",
  "is_permanent": true,
  "location_code": "FIN-01"
}

Changes

No recorded changes to this operation across all 1 revision of this API.