Creating a Disk (Discarded)

Function

This API is used to create a disk.

This API has been discarded. Use the EVS API "Creating EVS Disks (OpenStack Cinder API v2)".

URI

POST /v2/{project_id}/os-volumes

POST /v2.1/{project_id}/os-volumes

Table 1 describes the parameters in the URI.

Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

Request

Table 2 describes the request parameters.

Table 2 Request parameters

Parameter

Mandatory

Type

Description

availability_zone

No

String

Specifies the AZ to which the volume to be created belongs.

If the specified AZ does not exist, creating the volume failed, and the volume is in error state.

The AZ to which the volume to be created belongs must be specified in the cloud service system.

display_description

No

String

Specifies the volume description.

snapshot_id

No

String

Specifies the snapshot ID.

If this parameter is specified, the volume is to be created from a snapshot.

size

Yes (If the volume is created from a snapshot, this parameter is optional.)

Integer

Specifies the volume size.

Unit: GB

display_name

No

String

Specifies the volume name.

volume_type

No

String

Specifies the volume type.

Currently, the value can be SSD, SAS, SATA, co-p1, or uh-l1.

  • SSD: specifies the ultra-I/O disk type.

  • SAS: specifies the high I/O disk type.

  • SATA: specifies the common I/O disk type.

  • co-p1: specifies the high I/O (performance-optimized I) disk type.

  • uh-l1: specifies the ultra-high I/O (latency-optimized) disk type.

    Note

    EVS disks of the co-p1 and uh-l1 types are used exclusively for high performance computing (HPC) and SAP HANA ECSs.

metadata

No

Object

Specifies the volume metadata.

Response

Table 3 describes the response parameters.

Table 3 Response parameters

Parameter

Type

Description

id

String

Specifies the disk ID in UUID format.

displayName

String

Specifies the volume name.

status

String

Specifies the volume status.

attachments

Array of objects

Specifies the volume attachment information.

availabilityZone

String

Specifies the AZ to which the volume belongs.

createdAt

String

Specifies the time when the volume was created.

displayDescription

String

Specifies the volume description.

volumeType

String

Specifies the volume type.

snapshotId

String

Specifies the snapshot ID.

metadata

Object

Specifies the volume metadata.

size

Integer

Specifies the size of the volume.

Example Request

POST https://{endpoint}/v2/b84c367e4d1047fc9b54f28b400ddbc2/os-volumes
POST https://{endpoint}/v2.1/b84c367e4d1047fc9b54f28b400ddbc2/os-volumes
{
    "volume": {
        "availability_zone": "az1-dc1",
        "display_description": "test1",
        "snapshot_id": null,
        "size": 1,
        "display_name": "test",
        "volume_type": "SSD",
        "metadata": {
            "testkey": "testvalue"
        }
    }
}

Example Response

{
  "volume": {
    "displayDescription": "test1",
    "volumeType": "SATA",
    "createdAt": "2018-05-18T01:17:03.871808",
    "metadata": {
      "testkey": "testvalue",
      "resourceSpecCode": "SATA"
    },
    "attachments": [
      {}
    ],
    "snapshotId": null,
    "size": 1,
    "displayName": "test",
    "id": "b4fb891c-c665-4478-92b0-8a7fa65a57cd",
    "availabilityZone": "az1.dc1",
    "status": "creating"
  }
}

Returned Values

See Returned Values for General Requests.