文档首页/ 云硬盘 EVS/ API参考/ Cinder API/ 云硬盘管理/ 查询单个云硬盘类型的详情
更新时间:2024-02-27 GMT+08:00

查询单个云硬盘类型的详情

功能介绍

查询单个云硬盘类型的详细信息。

调用方法

请参见如何调用API

URI

GET /v2/{project_id}/types/{type_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

获取方法请参见"获取项目ID"。

type_id

String

云硬盘类型的ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

volume_type

VolumeType object

查询请求返回的云硬盘类型。

表4 VolumeType

参数

参数类型

描述

id

String

云硬盘类型的ID。

name

String

云硬盘类型名称。

extra_specs

VolumeTypeExtraSpecs object

云硬盘类型的规格。

description

String

云硬盘类型的描述信息。

qos_specs_id

String

预留属性。

is_public

Boolean

预留属性。

表5 VolumeTypeExtraSpecs

参数

参数类型

描述

RESKEY:availability_zones

String

支持当前云硬盘类型的可用区列表,列表的元素以逗号分隔。 若没有该参数,则表示当前云硬盘类型支持所有可用区。

availability-zone

String

预留属性。

os-vendor-extended:sold_out_availability_zones

String

当前云硬盘类型已售罄的可用区列表,列表的元素以逗号分隔。

volume_backend_name

String

预留属性。

HW:availability_zone

String

预留属性。

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error

Error object

出现错误时,返回的错误信息。

表7 Error

参数

参数类型

描述

code

String

出现错误时,返回的错误码。

错误码和其对应的含义请参考错误码说明

message

String

出现错误时,返回的错误消息。

请求示例

GET https://{endpoint}/v2/{project_id}/types/{type_id}

响应示例

状态码: 200

OK

{
  "volume_type" : {
    "extra_specs" : {
      "availability-zone" : "az-dc-1",
      "volume_backend_name" : "SATA",
      "RESKEY:availability_zones" : "az-dc-1,az-dc-2",
      "os-vendor-extended:sold_out_availability_zones" : "az-dc-2"
    },
    "name" : "SATA",
    "is_public" : true,
    "id" : "ea6e3c13-aac5-46e0-b280-745ed272e662",
    "description" : null
  }
}

状态码: 400

Bad Request

{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

错误码

请参见错误码