查询对应的云盘资源是否可以创建

最近更新时间: 2026-11-07 00:09:03

1. 接口描述

接口请求域名： cbs.api3.fincloud.tencent.cn。

查询对应的云盘资源是否可以创建

默认接口请求频率限制：20次/秒。

接口更新时间：2025-12-31 16:42:04。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeZoneDiskConfigInfos
Version	是	否	String	公共参数，本接口取值：2017-03-12
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
DiskChargeType	否	否	String	付费类型。示例值：
DiskConfigs	是	否	Array of DiskConfigSet	云盘配置列表。示例值：查看
Zone	是	否	String	可用区。示例值： mock-zone

3. 输出参数

参数名称	类型	描述
DiskConfigSetQuota	Int64	可创建云盘数量示例值：
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InvalidParameterValue	无效参数值。参数值格式错误或者参数值不被支持等。
MissingParameter	参数缺失。请求没有带必选参数。

5. 示例

示例1 查询region1二区高效云盘可创建的组合数量

假设用户需要创建一个含有50GB系统盘和100GB数据盘，且均为高效云盘的子机，使用该接口可以查询云盘可以创建的组合数量。实际可创建的子机数量需要根据DescribeZoneInstanceConfigInfos接口的返回值共同决定

输入示例

https://cbs.api3.fincloud.tencent.cn/?Action=DescribeZoneDiskConfigInfos
&DiskConfigs.0.DiskUsage=DATA_DISK
&DiskConfigs.0.DiskType=CLOUD_PREMIUM
&DiskConfigs.0.DiskSize=50
&DiskConfigs.1.DiskUsage=SYSTEM_DISK
&DiskConfigs.1.DiskType=CLOUD_PREMIUM
&DiskConfigs.1.DiskSize=100
&Zone=ap-region1-2
&<Common Parameters>

输出示例

{
    "Response": {
        "DiskConfigSetQuota": 890,
        "RequestId": "fc25f96a-f78b-4be3-9cb9-8050681e7fa5"
    }
}