tencent cloud

APIs

查询物理机机型

聚焦模式
字号
最后更新时间: 2026-04-27 16:55:56

1. 接口描述

接口请求域名: edgezone.intl.tencentcloudapi.com 。

根据 AppId 查询账号下可用区维度的机型配额列表;若传入 Zone,则仅返回指定可用区下的机型配额;若不传,则返回账号下所有可用区的机型配额。

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

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

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

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:DescribeInstanceTypes。
Version String 公共参数,本接口取值:2026-04-01。
Region String 公共参数,详见产品支持的 地域列表
Zone String 可用区代码,如 ap-guangzhou-1;不传则返回账号下所有可用区的机型。

3. 输出参数

参数名称 类型 描述
InstanceTypeQuotaSet Array of InstanceTypeQuota 机型配额列表。
TotalCount Integer 返回记录数量。
RequestId String 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 查询指定可用区的账号机型配额

查询指定可用区下当前账号可用的机型配额列表。

输入示例

POST / HTTP/1.1
Host: edgezone.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeInstanceTypes
<公共请求参数>

{
    "Zone": "ap-guangzhou-1"
}

输出示例

{
    "Response": {
        "InstanceTypeQuotaSet": [
            {
                "Zone": "ap-guangzhou-1",
                "InstanceType": "BMS5.MEDIUM8",
                "InstanceFamily": "BM.S5",
                "CpuCores": 8,
                "CpuType": "6231C*2",
                "MemoryGb": 32,
                "SystemDiskType": "SSD",
                "SystemDiskSize": 480,
                "SystemDiskCount": 2,
                "DataDiskType": "SSD",
                "DataDiskSize": 960,
                "DataDiskCount": 4,
                "DiskType": "SSD-480G*2, SSD-960G*4",
                "NetworkInterfaceType": "25G*2",
                "GpuType": "",
                "Quota": 10
            }
        ],
        "TotalCount": 1,
        "RequestId": "eac6b301-a322-493a-8e36-83b295459397"
    }
}

示例2 查询账号全部可用区机型配额

不传 Zone 时,返回当前账号下所有可用区的机型配额列表。

输入示例

POST / HTTP/1.1
Host: edgezone.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeInstanceTypes
<公共请求参数>

{}

输出示例

{
    "Response": {
        "InstanceTypeQuotaSet": [
            {
                "Zone": "ap-guangzhou-1",
                "InstanceType": "BMS5.MEDIUM8",
                "InstanceFamily": "BM.S5",
                "CpuCores": 8,
                "CpuType": "6231C*2",
                "MemoryGb": 32,
                "SystemDiskType": "SSD",
                "SystemDiskSize": 480,
                "SystemDiskCount": 2,
                "DataDiskType": "SSD",
                "DataDiskSize": 960,
                "DataDiskCount": 4,
                "DiskType": "SSD-480G*2, SSD-960G*4",
                "NetworkInterfaceType": "25G*2",
                "GpuType": "",
                "Quota": 10
            },
            {
                "Zone": "ap-guangzhou-2",
                "InstanceType": "BMS5.LARGE16",
                "InstanceFamily": "BM.S5",
                "CpuCores": 16,
                "CpuType": "6231C*2",
                "MemoryGb": 64,
                "SystemDiskType": "SSD",
                "SystemDiskSize": 480,
                "SystemDiskCount": 2,
                "DataDiskType": "SSD",
                "DataDiskSize": 1920,
                "DataDiskCount": 4,
                "DiskType": "SSD-480G*2, SSD-1920G*4",
                "NetworkInterfaceType": "25G*2",
                "GpuType": "",
                "Quota": 0
            }
        ],
        "TotalCount": 2,
        "RequestId": "b5d7f3a2-c418-4b9e-9c72-4a1e6d3f8b90"
    }
}

5. 开发者资源

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

该接口暂无业务逻辑相关的错误码,其他错误码详见 公共错误码

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈