AI 数据湖服务
AI 数据湖服务
开发参考
请输入
- 文档首页
AI 数据湖服务API 参考：管控面开发机ListDevMachines - 开发机列表
复制全文
下载 pdfListDevMachines - 开发机列表
文档反馈
问问助手获取开发机列表
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：ListDevMachines
要执行的操作，取值：ListDevMachines。
Version string 必选 示例值：2025-08-15
API的版本，取值：2025-08-15。
OwnerIds string[] 可选 示例值：["5881976"]
创建者，火山子账户ID
Statuses string[] 可选 示例值：["Running"]
状态，可选枚举值：Creating,Failed,Running,Stopping,Stopped,Deleting,Deleted,ImageSaving,Error
NextToken string 可选 示例值：nextToken
下一次查询起始Id（不包含）或页码（默认为0）
MaxResults integer 可选 示例值：10
单页记录数
ResourceIds string[] 可选 示例值：见请求示例
队列ID，可去队列列表中获取
DevMachineIds string[] 可选 示例值：["dm-abc"]
开发机ID，可在开发机详情中获取
DevMachineName string 可选 示例值：dm-abc
开发机名称，支持模糊查询
SortOrder string 可选 示例值：CreateTime
排序顺序
SortBy string 可选 示例值：Desc
排序参数
返回参数
Items object[] 示例值：见返回示例
概要列表
Id string
开发机ID
Ebs object
云盘配置信息
VolumeSize integer 示例值：100
云硬盘大小，单位G
Type string 示例值：PL0
云硬盘类型，枚举值：PL0,PL1
Name string
开发机名称
Ports object[]
端口配置信息
Name string 示例值：SSH
服务名称
ExternalPort integer 示例值：2222
外部端口
InternalPort integer 示例值：22
内部端口
SSHLoginCommand string
访问链接
Type string 示例值：System
端口类型，System：系统端口，Custom：自定义端口
Status string
开发机状态
OwnerId string
创建者
Resource object
服务元数据
ResourceId string 示例值：resourceId
在线队列 Id
GpuCardsNum integer 示例值：1
单实例 GPU 卡数
Cu integer 示例值：1
单实例 CU，旧版本字段
CpuNum string
cpu数量，单位核
Memory string
内存数量，单位G
GpuCardType string
GPU卡型，具体值在队列中获取
SpecId string
资源池Id，在队列列表页面，通过开发机者模式选择选中队列的资源池的SpecId字段获取
StopTime string
2025-08-10T07:47:23Z
StartTime string
2025-08-10T06:47:23Z
CreateTime string
2025-08-10T06:47:23Z
Description string
描述信息
ErrorMessage string
错误信息
RuntimeInSeconds long
运行时长，单位秒
NextToken string 示例值：0
分页查询的下一页token
MaxResults integer 示例值：10
单次查询可返回的最大记录数
TotalCount long 示例值：20
总记录数
请求示例
POST https://open.volcengineapi.com
{
"NextToken": "0",
"MaxResults": 10
}
返回示例
{
"Result": {
"Items": [
{
"Id": "dm-abc",
"Ebs": {
"Type": "PL0",
"VolumeSize": 100
},
"Name": "dm-abc",
"Ports": [
{
"Name": "SSH",
"Type": "System",
"ExternalPort": 2222,
"InternalPort": 22,
"SSHLoginCommand": "ssh -p 22 root@192.168.0.1"
}
],
"Status": "Running",
"OwnerId": "test@bytedance.com",
"Resource": {
"Cu": 1,
"ResourceId": "resourceId",
"GpuCardsNum": 1,
"InstanceNum": null
},
"StopTime": "",
"StartTime": "2025-08-10T06:47:23Z",
"CreateTime": "2025-08-10T06:47:23Z",
"Description": "description",
"ErrorMessage": "",
"RuntimeInSeconds": 20
}
],
"NextToken": "0",
"MaxResults": 10,
"TotalCount": 20
},
"ResponseMetadata": {
"Action": "ListDevMachines",
"Region": "cn-beijing",
"Service": "las",
"Version": "2025-08-15",
"RequestId": "20230604110420****100232280022D31",
"Deprecated": true
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | MissingParameter | The required parameter {} is missing. | 缺少必需的参数 {}。 |
400 | InvalidRequestParam | Invalid request param {}, cause {} | 非法请求参数 {}, 原因 {} |
500 | InternalError | The request has failed due to an unknown error. | 由于未知错误，请求失败。 |
最近更新时间：2026.09.18 10:58:48
这个页面对您有帮助吗？
有用
有用
无用
无用