全栈应用服务器 > API 文档 > 区域/规格 >查询实例规格

查询实例规格

最近更新时间: 2025-12-09 11:57:14

查询实例规格类型列表

接口描述

查询全栈应用服务器支持的实例类型规格列表，可以根据实例类型、系列、区域等参数进行筛选，支持分页。

请求路径

GET /v1/instance-types?instanceType=<instanceType>&family=<family>&nextMarker=<nextMarker>&limit=<limit>

请求参数

参数名称	参数类型	是否必填	描述
instanceType	string	否	指定要查询的实例类型。例如：`ecs.t2.medium`
family	string	否	指定实例的系列名称。例如：`t2`
nextMarker	string	否	分页标记，从哪个位置开始查询
limit	int	否	返回结果的最大数量。最大不超过 100

响应字段

字段名称	字段类型	描述
instanceType	string	实例类型 ID（如 `ecs.t2.medium`）
family	string	实例规格族（如 `t2`）
familyName	string	实例规格族名称
category	string	实例规格分类
cpu	int	vCPU 内核数目
cpuArchitecture	string	CPU 架构
memory	float64	内存大小 (GiB)
gpuName	string	GPU 名称（如 NVIDIA 4090）
gpuMemory	float64	单块 GPU 显存 (GiB)
gpuCount	int	GPU 数量
diskQuantity	int	支持挂载的磁盘数量上限
regions	string[]	支持的区域

请求示例

GET /v1/instance-types?family=t1&limit=5 HTTP/1.1
Host: <RegionID>-ecs.qiniuapi.com
Authorization: Qiniu <AccessToken>
X-Qiniu-Date: 20250924T040050Z

响应示例

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Reqid: vF0AALFqqjECHGgY

{
   "items": [
      {
         "category": "general",
         "cpu": 1,
         "cpuArchitecture": "x86_64",
         "diskQuantity": 0,
         "family": "t1",
         "familyName": "轻量型 T1",
         "gpuCount": 0,
         "gpuMemory": 0,
         "gpuName": "",
         "instanceType": "ecs.t1.c1m2",
         "memory": 2,
         "regions": [
            "ap-southeast-1",
            "ap-northeast-1",
            "ap-southeast-2",
            "cn-changshan-1",
            "cn-hongkong-1"
         ]
      },
      ...
   ],
   "limit": 5
   "nextMarker": "6890258402cd31ab88b6bee8"
}

以上内容是否对您有帮助？