文档中心

云服务器

请输入

云盘

DescribeVolumeType - 查询云盘类型

调用DescribeVolumeType接口查询各地域可用区支持创建的云盘类型。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：DescribeVolumeType

要执行的操作，取值：DescribeVolumeType。

Version string 必选示例值：2020-04-01

API的版本，取值：2020-04-01。

ZoneId string 可选示例值：cn-beijing-a

可用区Id。

VolumeTypeIds.N string[] 可选示例值：VolumeTypeIds.1=ESSD_PL0

待查询的云盘类型，取值说明如下：

PTSSD：性能型SSD。

ESSD_PL0：极速型SSD云盘，PL0规格。

ESSD_FlexPL: 极速型SSD云盘，FlexPL规格。

TSSD_TL0：吞吐型SSD云盘。

默认查询所有云盘类型。

说明

关于云盘规格的详细说明，请参见云盘规格。

PageNumber integer 可选示例值：1

起始页码，默认值为1。

PageSize integer 可选示例值：20

每页大小，最大100，默认值为50。

Filter string 可选示例值：/

过滤器。该参数已废弃，请勿使用。

OrderBy string 可选示例值：/

排序。该参数已废弃，请勿使用。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

PageSize integer 示例值：20

每页大小。

PageNumber integer 示例值：1

起始页码，默认值为1。

TotalCount integer 示例值：2

符合条件的云盘类型总数。

VolumeTypes object[] 示例值：-

符合条件的云盘信息。

Id string 示例值：ESSD_FlexPL

待查询的云盘类型，取值说明如下：

PTSSD：性能型SSD。

ESSD_PL0：极速型SSD云盘，PL0规格。

ESSD_FlexPL: 极速型SSD云盘，FlexPL规格。

TSSD_TL0：吞吐型SSD云盘。

说明

关于云盘规格的详细说明，请参见云盘规格。

Zones string[] 示例值：g cn-beijing-a

该云盘类型所在可用区。

ExtraPerformanceTypes object[] 示例值：-

额外性能信息。

Id string 示例值：IOPS

额外性能类型，取值说明如下：

Balance：均衡型额外性能。

IOPS：IOPS型额外性能。

Throughput：吞吐量型额外性能。

MaxIops string 示例值：1

该规格云盘支持的最大IOPS。

MaxThroughput string 示例值：1

该规格云盘支持的最大带宽。

请求示例

GET /?Action=DescribeVolumeType&Version=2020-04-01&VolumeTypeIds.1=ESSD_FlexPL HTTP/1.1​
Host: open.volcengineapi.com​
Region: cn-beijing​
ServiceName: storage_ebs​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "20240401115223DABE6F7F7C4EA281****,​
        "Action": "DescribeVolumeType",​
        "Version": "2020-04-01",​
        "Service": "storage_ebs",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "PageNumber": 1,​
        "PageSize": 99,​
        "TotalCount": 1,​
        "VolumeTypes": [​
           {​
                "Id": "ESSD_PL0",​
                "Zones": [​
                    "cn-beijing-a",​
                    "cn-beijing-b",​
                    "cn-beijing-c"​
                ]​
            }​
        ]​
    }​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
500	InternalError	An internal error has occurred.	内部错误，请重试。如果多次尝试失败，请提交工单。

最近更新时间：2026.01.07 17:09:45

这个页面对您有帮助吗？

有用

无用