更新时间:2024-03-25 GMT+08:00

查询云硬盘类型列表

功能介绍

查询支持的云硬盘类型。

URI

  • URI格式

    GET /v3/{project_id}/types

  • 参数说明

    参数

    是否必选

    描述

    project_id

    项目ID。

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

请求消息

  • 请求样例:
    GET https://{endpoint}/v3/{project_id}/types

响应消息

  • 响应参数

    参数

    参数类型

    描述

    volume_types

    list

    查询请求返回的云硬盘类型列表,请参见•volume_types参数说明

    error

    Object

    出现错误时,返回的错误信息,具体请参见•error参数说明

  • volume_types参数说明

    参数

    参数类型

    描述

    extra_specs

    Object

    云硬盘类型的规格,请参见•extra_specs参数说明

    name

    String

    云硬盘类型名称。

    id

    String

    云硬盘类型的ID。

    description

    String

    云硬盘类型的描述信息。

    qos_specs_id

    String

    预留属性。

    is_public

    Boolean

    预留属性。

  • extra_specs参数说明

    参数

    参数类型

    描述

    volume_backend_name

    String

    预留属性。

    availability-zone

    String

    预留属性。

    HW:availability_zone

    String

    预留属性。

  • error参数说明

    参数

    参数类型

    描述

    message

    String

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

    code

    String

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

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

  • 响应样例
    {
        "volume_types": [
            {
                "extra_specs": {
                    "volume_backend_name": "SAS", 
                    "availability-zone": "az-dc-1"
                }, 
                "name": "SAS", 
                "qos_specs_id": null, 
                "id": "6c81c680-df58-4512-81e7-ecf66d160638", 
                "is_public": true, 
                "description": null
            }, 
            {
                "extra_specs": {
                    "volume_backend_name": "SAS", 
                    "availability-zone": "az-dc-1"
                }, 
                "name": "SAS", 
                "qos_specs_id": "585f29d6-7147-42e7-bfb8-ca214f640f6f", 
                "is_public": true, 
                "id": "ea6e3c13-aac5-46e0-b280-745ed272e662", 
                "description": null
            }, 
            {
                "extra_specs": {
                    "volume_backend_name": "SSD", 
                    "availability-zone": "az-dc-1"
                }, 
                "name": "SSD", 
                "qos_specs_id": "39b0c29a-308b-4f86-b478-5d3d02a43837", 
                "is_public": true, 
                "id": "6f2dee9e-82f0-4be3-ad89-bae605a3d24f", 
                "description": null
            }
        ]
    }

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

    其中error是泛指的错误,有badrequest、itemNotFound等,如报错为:

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

状态码

  • 正常

    200

错误码

请参考错误码