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

AI 数据湖服务

复制全文
下载 pdf
开发机
GetDevMachine - 开发机详情
复制全文
下载 pdf
GetDevMachine - 开发机详情
获取开发机详情​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值:GetDevMachine​
要执行的操作,取值:GetDevMachine。​
​
Version string 必选 示例值:2025-08-15​
API的版本,取值:2025-08-15。​
​
DevMachineId string 必选 示例值:dm-abc​
开发机ID​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
DevMachineDetail object 示例值:见返回示例​
开发机详情​
Id string​
开发机ID​
​
Ebs object​
云盘配置信息​
VolumeSize integer 示例值:100​
云硬盘大小,单位G​
​
Type string 示例值:PL0​
云硬盘类型,枚举值:PL0,PL1​
​
​
SSH object​
SSH配置信息​
PublicKey string 示例值:ssh-rsa AAAA6DbWW2Ibzb5s 192.168.0.1​
公钥信息​
​
​
Name string​
开发机名称​
​
Image object​
镜像配置信息​
ImageUrl string 示例值:las-ai-cr.volces.com/las/test:v1​
镜像地址​
​
ImageType string 示例值:BuiltIn​
镜像类型,BuiltIn:内置镜像,Custom:自定义镜像,VolcanoCR:火山引擎镜像,External:外部镜像URL​
​
​
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​
停止时间​
​
Storages object[]​
存储配置信息​
TOS object​
TOS存储配置信息​
Source string 示例值:tos://adc/ab​
TOS路径​
​
​
AccessKey string 示例值:ak-abc​
存储地址秘钥AK​
​
MountPath string 示例值:/mnt/tos​
容器内挂载点​
​
SecretKey string 示例值:sk-abc​
存储地址秘钥SK​
​
Nas object​
NAS存储配置信息​
FileSystemId string 示例值:enas-cnbjtest​
文件系统Id​
​
AccessPointId string 示例值:ap-test​
接入点id​
​
SourcePath string 示例值:/test​
系统待挂载路径​
​
​
VePFS object​
VePFS存储配置信息​
FileSystemId string 示例值:vepfs-abc​
文件系统ID​
​
SourcePath string 示例值:/abc​
系统待挂载路径​
​
​
Source string 示例值:tos://abc/ab​
存储源地址,历史字段​
​
Protocol string 示例值:TOS​
存储协议,支持TOS、NAS、VEPFS​
​
​
StartTime string​
启动时间​
​
CreateTime string​
创建时间​
​
UpdateTime string​
更新时间​
​
Description string​
描述信息​
​
ErrorMessage string​
错误信息​
​
PrivateNetwork object​
网络配置信息​
NetworkAccessMode string 示例值:CLB​
网络接入模式​
​
ClbId string 示例值:clb-abc​
Clb ID​
​
ClbIp string 示例值:192.168.0.1​
Clb IP​
​
VpcId string 示例值:vpc-abc​
VPC ID​
​
SubnetIds object[]​
子网id列表​
Key string 示例值:name1​
Key​
​
Value string 示例值:value1​
Value​
​
​
SecurityGroupId string 示例值:sg-test​
安全组ID​
​
NatGatewayId string 示例值:ngw-test​
NAT网关id​
​
EipId string 示例值:eip-test​
NAT网关关联的公网id​
​
​
RuntimeInSeconds long​
运行时长​
​
Datasets object[]​
数据集配置信息​
DatasetName string 示例值:las_test​
数据集名称​
​
MountPath string 示例值:/dataset​
容器内挂载点​
​
​
Envs object[]​
环境变量配置信息​
Key string 示例值:Key​
环境变量Key​
​
Value string 示例值:Value​
环境变量Value​
​
​
NetMode string 示例值:Share​
SSH网络模式,Share:共享模式,Exclusive:专享模式,DisablePublicNetwork:关闭公网​
​
ScheduleStrategy string​
调度策略,Wait:等待模式,Preempt:抢占模式​
​
ZoneId string 示例值:cn-beijing-a​
可用区​
​
​
​
​
请求示例​
​
POST https://open.volcengineapi.com​
{​
"DevMachineId": "dm-abc"​
}​
​
返回示例​
​
{​
"Result": {​
"DevMachineDetail": {​
"Id": "dm-abc",​
"Ebs": {​
"Type": "PL0",​
"VolumeSize": 100​
},​
"SSH": {​
"PublicKey": "ssh-rsa AAAA6DbWW2Ibzb5s 192.168.0.1"​
},​
"Name": "dm-abc",​
"Image": {​
"ImageUrl": "las-ai-cr.volces.com/las/test:v1",​
"ImageType": "BuiltIn"​
},​
"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": "",​
"Storages": [​
{​
"TOS": {​
"Source": "tos://adc/ab"​
},​
"Protocol": "TOS",​
"AccessKey": "ak-abc",​
"MountPath": "/mnt/tos",​
"SecretKey": "sk-abc"​
}​
],​
"StartTime": "2025-08-10T06:47:23Z",​
"CreateTime": "2025-08-10T06:47:23Z",​
"UpdateTime": "2025-08-10T06:47:23Z",​
"Description": "description",​
"ErrorMessage": "",​
"PrivateNetwork": {​
"ClbId": "clb-abc",​
"ClbIp": "192.168.0.1",​
"VpcId": "vpc-abc",​
"SubnetIds": [​
"[subnet-abc]"​
],​
"SecurityGroupId": "sg-test"​
},​
"RuntimeInSeconds": 20​
}​
},​
"ResponseMetadata": {​
"Action": "GetDevMachine",​
"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 {}​
非法请求参数 {}, 原因 {}​
400​
DevMachineNotFound​
Dev Machine [] Not Found​
开发机 [] 不存在​
400​
InvalidParameter​
The specified parameter {} is invalid, cause: {}​
无效的请求参数 {}, 原因 {}​
500​
InternalError​
The request has failed due to an unknown error.​
由于未知错误,请求失败。​
​
​
最近更新时间:2026.09.18 10:58:48
这个页面对您有帮助吗?
有用
有用
无用
无用