更新时间:2022-01-22 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

    预留属性。

    RESKEY:availability_zones

    String

    支持当前云硬盘类型的AZ列表。

    os-vendor-extended:sold_out_availability_zones

    String

    当前云硬盘类型售罄的AZ列表。

  • error参数说明

    参数

    参数类型

    描述

    message

    String

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

    code

    String

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

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

  • 响应样例
    { 
        "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",  
                "qos_specs_id": null,  
                "id": "6c81c680-df58-4512-81e7-ecf66d160638",  
                "is_public": true,  
                "description": null 
            },  
            { 
                "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",  
                "description": null 
            },  
            { 
                "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",  
                "description": null 
            } 
        ] 
    }

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

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

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

状态码

  • 正常

    200

错误码

请参考错误码

分享:

    相关文档

    相关产品

关闭导读