DescribeMachineSpec - 查询可用机器规格列表 - 人工智能平台 PAI

查询可用机器规格列表

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

GET /api/v2/public/instance_types HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
ResourceType	string	否	资源类型，默认为公共资源组。枚举值： Public : 公共资源组 Dedicated : 专属资源组	Public
ChargeType	string	否	付费方式，默认为按量付费。枚举值： PostPaid : 按量付费 PrePaid : 包年包月	PostPaid
InstanceTypes `deprecated`	array	否	参数已废弃。
	string	否	参数已废弃。	无需填写

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	40325405-579C-4D82***
Types	array<object>	当指定 CPU Memory 部署时，可以支持的组合值。
	object	支持的组合列表。例如: `{"CPU":1,"Memory":[1000,2000,4000]}` 代表当 CPU 为 1 核时，内存可选值为 1000,2000 或 4000
CPU	integer	CPU 的可选值	1
Memory	array	当 CPU 为上面的指定值时，内存的可选值。
	integer	内存的可选值列表。	1000
InstanceMetas	array<object>	当指定机型部署时，可用的机型列表。
	object	可用机型相关信息。
CPU	integer	机型的 CPU 核数。	32
Memory	number	该机型的内存数(单位 G)。	188
GPU	string	机型的 GPU 型号。若非 GPU 机型，则无此字段。	GU30
GPUAmount	integer	机型的 GPU 卡数。	1
GPUMemory	number	机型的 GPU 显存数(单位 G)	24
InstanceType	string	机型名称。	ml.gu7i.c32m188.1-gu30
SpotDiscount	number	机型使用 1 小时保护模式竞价实例时，当前能接受的最低折扣。0.1 代表 1 折。若无此字段，代表不支持购买竞价实例。	0.12
NonProtectSpotDiscount	number	机型使用无保护模式竞价实例时，当前能接受的最低折扣。0.1 代表 1 折。若无此字段，代表不支持购买竞价实例。	0.1
IsAvailable	boolean	机型当前是否可用。	true
Vendor	string	机型供应来源。枚举值： ECS : ECS BareMetal : 裸金属计算集群 Lingjun : 灵骏智算集群	ECS
StockStatus	string	机型库存状态。枚举值： WithStock : 有库存 ClosedWithStock : 库存较少 NoStock : 无库存	WithStock

示例

正常返回示例

JSON格式

{
  "RequestId": "40325405-579C-4D82***",
  "Types": [
    {
      "CPU": 1,
      "Memory": [
        1000
      ]
    }
  ],
  "InstanceMetas": [
    {
      "CPU": 32,
      "Memory": 188,
      "GPU": "GU30",
      "GPUAmount": 1,
      "GPUMemory": 24,
      "InstanceType": "ml.gu7i.c32m188.1-gu30",
      "SpotDiscount": 0.12,
      "NonProtectSpotDiscount": 0.1,
      "IsAvailable": true,
      "Vendor": "ECS",
      "StockStatus": "WithStock"
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。