Show Volume Type

Overview

Show specified volume type

Classification

  • Show

API Operation Object

  • VolumeType

Synchronous / Asynchronous

  • Synchronous

Request

HTTP Request Method

  • GET

HTTP Request Path

{api_endpoint}/v1.0/{tenant_id}/volume_types/{volume_type_id}/

HTTP Request Header

Format

X-Auth-Token: <token>

HTTP Request Body

Format

  • none

Request Parameter

  • none

Response

HTTP Response Header

Response Code

Response Codes

Code

Description

Error?

Note

200

OK

No

400

Bad Request

Yes

401

Unauthorized

Yes

500

Internal Server Error

Yes

HTTP Response Body

Response Parameter

Response Parameters

Key

Value

api_error_message

Error Message

volume_types

List of VolumeType objects

extra_specs

Includes available_volume_size, and available_iops_per_gb or available_throughput

available_volume_size

List of available volume sizes for the volume_type

available_iops_per_gb

List of available IOPS/GB values for the volume_type

available_throughput

List of available throughput (MByte/s) values for the volume_type

id

ID for the volume_type

name

Name of the volume_type

Sample API Request and Response

Sample API Request

curl -s -i -X GET https://storage-jp1.ecl.api.ntt.com/v1.0/7dea34ac34a14d04b0accbfe793c74af/volume_types/bf33db2a-d13e-11e5-8949-005056ab5d30 -H 'Content-type: application/json' -H 'Accept: application/json' -H 'X-Auth-Token: 9be12ef084604271973267591455d828'

Sample API Response

HTTP/1.1 200 OK
Date: Thu, 21 Apr 2016 07:10:30 GMT
Content-Type: application/json
Content-Length: 264
Connection: keep-alive
Set-Cookie: TS0183560f=01cce65ce188c4dcd84480fd40b72c5d4218370e6986148b0724b8c9f3eef2b968e5b049f9; Path=/

{
  "api_error_message": "",
 "volume_type" : 
{
  "extra_specs": {
    "available_volume_size": [
      256,
      512
    ],
    "available_volume_throughput": [
      50,
      100,
      250,
      400
    ]
  },
  "id": "bf33db2a-d13e-11e5-8949-005056ab5d30",
  "name": "pre_nfs_na"
}
}