華為云計算 云知識 查詢云硬盤類型列表CinderListVolumeTypes
查詢云硬盤類型列表CinderListVolumeTypes

 

功能介紹

查詢 云硬盤 類型列表。

URI

GET /v2/{project_id}/types

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項目ID。獲取方法請參見"獲取項目ID"。

請求參數(shù)

表2 請求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。 通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲?。憫?yīng)消息頭中X-Subject-Token的值)。

響應(yīng)參數(shù)

狀態(tài)碼: 200

表3 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

volume_types

Array of VolumeType objects

查詢請求返回的云硬盤類型列表。

表4 VolumeType

參數(shù)

參數(shù)類型

描述

id

String

云硬盤類型的ID。

name

String

云硬盤類型名稱。

extra_specs

VolumeTypeExtraSpecs object

云硬盤類型的規(guī)格。

description

String

云硬盤類型的描述信息。

qos_specs_id

String

預(yù)留屬性。

is_public

Boolean

預(yù)留屬性。

表5 VolumeTypeExtraSpecs

參數(shù)

參數(shù)類型

描述

RESKEY:availability_zones

String

支持當前云硬盤類型的可用區(qū)列表,列表的元素以逗號分隔。 若沒有該參數(shù),則表示當前云硬盤類型支持所有可用區(qū)。

availability-zone

String

云硬盤所屬的AZ信息。

os-vendor-extended:sold_out_availability_zones

String

當前云硬盤類型已售罄的可用區(qū)列表,列表的元素以逗號分隔。

volume_backend_name

String

預(yù)留屬性。

HW:availability_zone

String

預(yù)留屬性。

狀態(tài)碼: 400

表6 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

出現(xiàn)錯誤時,返回的錯誤信息。

表7 Error

參數(shù)

參數(shù)類型

描述

code

String

出現(xiàn)錯誤時,返回的錯誤碼。錯誤碼和其對應(yīng)的含義請參考錯誤碼說明

message

String

出現(xiàn)錯誤時,返回的錯誤消息。

請求示例

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

響應(yīng)示例

狀態(tài)碼: 200

OK

{
  "volume_types" : [ {
    "extra_specs" : {
      "volume_backend_name" : "SAS",
      "availability-zone" : "az-dc-1",
      "RESKEY:availability_zones" : "az-dc-1,az-dc-2",
      "os-vendor-extended:sold_out_availability_zones" : "az-dc-2"
    },
    "name" : "SAS",
    "id" : "6c81c680-df58-4512-81e7-ecf66d160638",
    "is_public" : true
  }, {
    "extra_specs" : {
      "volume_backend_name" : "SATA",
      "availability-zone" : "az-dc-1",
      "RESKEY:availability_zones" : "az-dc-1,az-dc-2",
      "os-vendor-extended:sold_out_availability_zones" : "az-dc-2"
    },
    "name" : "SATA",
    "qos_specs_id" : "585f29d6-7147-42e7-bfb8-ca214f640f6f",
    "is_public" : true,
    "id" : "ea6e3c13-aac5-46e0-b280-745ed272e662"
  }, {
    "extra_specs" : {
      "volume_backend_name" : "SSD",
      "availability-zone" : "az-dc-1",
      "RESKEY:availability_zones" : "az-dc-1,az-dc-2",
      "os-vendor-extended:sold_out_availability_zones" : "az-dc-2"
    },
    "name" : "SSD",
    "qos_specs_id" : "39b0c29a-308b-4f86-b478-5d3d02a43837",
    "is_public" : true,
    "id" : "6f2dee9e-82f0-4be3-ad89-bae605a3d24f"
  } ]
}

狀態(tài)碼: 400

Bad Request

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

狀態(tài)碼

狀態(tài)碼

描述

200

OK

400

Bad Request

錯誤碼

請參見錯誤碼。