You need to enable JavaScript to run this app.
文档中心
AI 数据湖服务

AI 数据湖服务

复制全文
下载 pdf
开发机
ListDevMachines - 开发机列表
复制全文
下载 pdf
ListDevMachines - 开发机列表
获取开发机列表​
调试​
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
这个页面对您有帮助吗?
有用
有用
无用
无用