Sign in

v1

latestOpenAPI 3.0.0Apache 2.02026-07-17524793.1 KB
Volume

Update a volume.

put/v1/{tenantId}/volumes/{id}

Request body

Descriptionstring

The volume name specified by user, - Optional

Sizeinteger

The volume size, - Optional

Typeinteger

The volume Type, - Optional

Iopsinteger

The Iops, - Optional

Metadataobject

Metadata for cloud backend specific data, - Optional

Example request

{
  "Description": "AWS Volume Update",
  "Size": 1073741824,
  "Iops": 200,
  "Tags": [
    {
      "key": "Name",
      "Value": "soda"
    }
  ],
  "Metadata": {
    "VolumeId": "vol-03deedaee2de0060f"
  }
}

Response

successful operation

Idstring

The volume ID, generated by server

CreatedAtstring

The time of creation of the volume.

UpdatedAtstring

The time at which the volume was updated.

TenantIdstring

The tenant UUID in a multi-tenancy environment.

UserIdstring

The user UUID in a multi-tenancy environment.

BackendIdstring

The backend ID

Backendstring

The backend Name.

Namestring

The volume name specified by user.

Descriptionstring

The volume description specified by user.

Typestring

The volume type.

Sizeinteger

The volume size.

Regionstring

The region for the volume.

AvailabilityZonestring

The availability zone for the volume.

Status'available' | 'creating' | 'inUse' | 'error' | 'updating' | 'deleting' | 'errorDeleting' | 'deleted'

The volume status.

SnapshotIdstring

The volume snapshot id.

Encryptedboolean

Flag for encryted volume.

EncryptedSettingsobject

Encryted volume Keys.

Example response

{
  "Id": "5ef1db51202b510001c3804c",
  "CreatedAt": "2020-06-23T16:07:05",
  "UpdatedAt": "2020-06-23T16:07:05",
  "TenantId": "94b280022d0c4401bcf3b0ea85870519",
  "UserId": "5ea809d2553b0f000116be32",
  "BackendId": "5ea809d2553b0f000116be32",
  "Backend": "backend001",
  "Name": "volume001",
  "Description": "AWS Volume",
  "Type": "gp2",
  "Size": 1073741824,
  "Region": "ap-south-1",
  "AvailabilityZone": "ap-south-1a",
  "Status": "available",
  "Tags": [
    {
      "key": "Name",
      "Value": "soda"
    }
  ],
  "SnapshotId": "5eea749a926e5300011a69d6",
  "Encrypted": true,
  "EncryptedSettings": {
    "KmsKeyId": "arn:aws:kms:ap-south-1:676589967111:key/a6e1716e-0e90-407b-b494-b8ef8de91fc"
  },
  "Metadata": {
    "fields": {
      "CreationTimeAtBackend": {
        "kind": {
          "StringValue": "2020-06-17T19:44:06Z"
        }
      },
      "StartTimeAtBackend": {
        "kind": {
          "StringValue": "2020-06-17T19:44:06Z"
        }
      },
      "VolumeId": {
        "kind": {
          "StringValue": "vol-03deedaee2de0060f"
        }
      }
    }
  }
}