GetInstanceType - 查询规格--机器学习平台-火山引擎

文档中心

立即注册

导航

GetInstanceType - 查询规格

最近更新时间：2025.04.24 21:00:31首次发布时间：2025.04.24 21:00:31

查询规格

调试

API Explorer

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

去调试

请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	GetInstanceType	要执行的操作，取值：GetInstanceType。
Version	String	是	2024-07-01	API的版本，取值：2024-07-01。
Id	String	是	.	规格id

返回参数

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

参数	类型	示例值	描述
Id	String	ml.g1ie.large	规格ID
Family	String	ml.g1ie	规格族
Kind	String	.	规格类型
ZoneInfo	Array of Object	.	各个可用区的支持状态
Cpu	Double	4	CPU数量
MemoryMiB	Double	4096	内存
GpuType	String	Tesla-V100	GPU类型
GpuCount	Integer	8	GPU数量
GpuMemoryMiB	Integer	32510	显存
AvailableGPUMemoryMiB	Integer	32000	可用显存
EniCount	Integer	16	网卡数量
EniMaximumBandwidthMbps	Integer	4000	网卡带宽
RdmaEniCount	Integer	4	RDMA网卡数量
RdmaEniMaximumBandwidthMbps	Integer	8000	RDMA带宽
VolumeSupportedTypes	Array of String	.	支持的云盘列表
VolumeMaximumIops	Integer	8000	云盘Iops
VolumeMaximumBandwidthMbps	Integer	8000	云盘带宽
NvmeSsdCount	Integer	4	本地盘数量
PriceByHour	Double	1	小时参考价格
PriceByDay	Double	10	天参考价格
PriceByMonth	Double	100	月参考价格

请求示例 1

{}

返回示例 1

{}

请求示例 2

{
	"NameContains": "QA",
	"PageNumber": 1,
	"PageSize": 10,
	"ResourceQueueIds": [
		"q-20240620150557-46nb5"
	],
	"SortBy": "CreateTime",
	"SortOrder": "Descend",
	"States": [
		"Stopped"
	]
}

返回示例 2

{
	"List": [
		{
			"AllowImageBuild": true,
			"CreateTime": "2025-04-16T03:49:03.038Z",
			"CreatorTrn": "trn:iam::21000*****:user/*****",
			"Description": "",
			"ExpectedStopTime": "",
			"Id": "di-20250416114902-*****",
			"Image": {
				"Type": "Public",
				"Url": "vemlp-cn-beijing.cr.volces.com/preset-images/python:3.10"
			},
			"IsBuildingImage": false,
			"LaunchTime": "2025-04-16T03:49:37.165Z",
			"Name": "开发机名称1",
			"NodeAffinitySpec": {},
			"Ports": [
				{
					"APIGPrivateUrl": "https://*****.apigateway-cn-beijing-inner.volceapi.com/devinstance/di-20250416114902-*****-code-server/?folder=/root/code\u0026enable-get-requests=true\u0026password=*****",
					"EnablePublicNetworkAccess": false,
					"EniIp": "172.16.64.53",
					"EniPort": 10000,
					"Name": "WebIDE",
					"Status": {
						"State": ""
					},
					"Type": "system"
				}
			],
			"ResourceClaim": {
				"InstanceTypeId": "ml.g3a.2xlarge",
				"Type": "Preset",
				"ZoneId": ""
			},
			"ResourceQueueId": "q-20240620150557-*****",
			"SshPublicKey": "",
			"Status": {
				"Message": "",
				"State": "Stopped"
			},
			"StopTime": "2025-04-16T03:49:43.829Z",
			"StoppedTime": "2025-04-16T03:50:43Z",
			"UpdateTime": "",
			"Volume": {
				"Id": "vol-3wb1glr2kt43po6*****",
				"Size": 20,
				"Status": null,
				"VolumeTypeId": "ml.essd.pl0"
			},
			"ZoneID": "cn-beijing-c"
		},
		{
			"AllowImageBuild": true,
			"CreateTime": "2025-04-15T14:15:34.865Z",
			"CreatorTrn": "trn:iam::*****:user/*****",
			"Description": "",
			"ExpectedStopTime": "",
			"Id": "di-20250415221534-*****",
			"Image": {
				"Type": "Public",
				"Url": "vemlp-cn-beijing.cr.volces.com/preset-images/python:3.10"
			},
			"IsBuildingImage": false,
			"LaunchTime": "2025-04-15T14:16:10.016Z",
			"Name": "开发机名称2",
			"NodeAffinitySpec": {},
			"Ports": [
				{
					"APIGPrivateUrl": "https://*****.apigateway-cn-beijing-inner.volceapi.com/devinstance/di-20250415221534-*****-code-server/?folder=/root/code\u0026enable-get-requests=true\u0026password=*****",
					"EnablePublicNetworkAccess": false,
					"EniIp": "172.16.64.51",
					"EniPort": 10000,
					"Name": "WebIDE",
					"Status": {
						"State": ""
					},
					"Type": "system"
				}
			],
			"ResourceClaim": {
				"InstanceTypeId": "ml.g3a.2xlarge",
				"Type": "Preset",
				"ZoneId": ""
			},
			"ResourceQueueId": "q-20240620150557-*****",
			"SshPublicKey": "",
			"Status": {
				"Message": "",
				"State": "Stopped"
			},
			"StopTime": "2025-04-15T14:16:15.882Z",
			"StoppedTime": "2025-04-15T14:17:15Z",
			"UpdateTime": "",
			"Volume": {
				"Id": "vol-3wazzpc8gd43po7*****",
				"Size": 20,
				"Status": null,
				"VolumeTypeId": "ml.essd.pl0"
			},
			"ZoneID": "cn-beijing-c"
		}
	],
	"PageNumber": 1,
	"PageSize": 10,
	"TotalCount": 2
}

请求示例 3

{
	"Id": "ml.hpcg1ve.21xlarge"
}

返回示例 3

{
	"AvailableGPUMemoryMiB": 32510,
	"Cpu": 84,
	"EniCount": 15,
	"EniMaximumBandwidthMbps": 25600,
	"Family": "ml.hpcg1ve",
	"GpuCount": 8,
	"GpuMemoryMiB": 32768,
	"GpuType": "Tesla-V100",
	"Id": "ml.hpcg1ve.21xlarge",
	"Kind": "Rdma",
	"MemoryMiB": 350208,
	"NvmeSsdCount": 0,
	"PriceByDay": 2663.51,
	"PriceByHour": 233.83,
	"PriceByMonth": 54158,
	"RdmaEniCount": 1,
	"RdmaEniMaximumBandwidthMbps": 102400,
	"VolumeMaximumBandwidthMbps": 98304,
	"VolumeMaximumIops": 200000,
	"VolumeSupportedTypes": [
		"ml.essd.pl1"
	],
	"ZoneInfo": [
		{
			"SupportStatus": "Valid",
			"ZoneId": "cn-beijing-a"
		},
		{
			"SupportStatus": "Valid",
			"ZoneId": "cn-beijing-b"
		}
	]
}

错误码

您可访问公共错误码，获取更多错误码信息。