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

AI 数据湖服务

复制全文
下载 pdf
开发机
UpdateDevMachine - 更新开发机
复制全文
下载 pdf
UpdateDevMachine - 更新开发机
更新开发机​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值:UpdateDevMachine​
要执行的操作,取值:UpdateDevMachine。​
​
Version string 必选 示例值:2025-08-15​
API的版本,取值:2025-08-15。​
​
NetMode string 可选 示例值:Share​
SSH网络模式,Exclusive:独占模式,Share:共享模式,DisablePublicNetwork:关闭公网​
​
Ebs object 可选 示例值:见请求示例​
磁盘配置信息​
VolumeSize integer 必选 示例值:100​
云硬盘大小,单位G​
​
Type string 必选 示例值:PL0​
云硬盘类型,枚举值:PL0,PL1​
​
​
SSH object 可选 示例值:见请求示例​
SSH配置信息,至少添加一个名称为SSH,类型为System的访问端口;开启独占网络模式,可添加额外自定义访问端口​
PublicKey string 必选 示例值:ssh-rsa AAAA6DbWW2Ibzb5s 192.168.0.1​
公钥信息​
​
​
Name string 可选 示例值:name​
实例名称​
​
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:自定义端口​
​
​
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字段获取​
​
​
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​
​
​
Datasets object[] 可选 示例值:见请求示例​
数据集配置信息​
DatasetName string 必选 示例值:las_test​
数据集名称​
​
MountPath string 必选 示例值:/dataset​
容器内挂载点​
​
​
Envs object[] 可选 示例值:见请求示例​
开发机环境变量配置​
Key string 必选 示例值:Key​
环境变量Key​
​
Value string 可选 示例值:Value​
环境变量Value​
​
​
Credential object 可选 示例值:见请求示例​
密钥配置信息​
​
ClientToken string 可选 示例值:xxxx​
客户端token​
​
Description string 可选 示例值:description​
实例描述​
​
DevMachineId string 必选 示例值:dm-abc​
实例id​
​
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​
​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
DevMachineId string 示例值:dm-abc​
开发机Id​
​
​
​
请求示例​
​
POST https://open.volcengineapi.com​
{​
"DevMachineId": "dm-abc",​
"Ebs": {​
"Type": "PL0",​
"VolumeSize": 100​
},​
"SSH": {​
"PublicKey": "ssh-rsa AAAA6DbWW2Ibzb5s 192.168.0.1"​
},​
"Name": "name",​
"Image": {​
"ImageUrl": "las-ai-cr.volces.com/las/test:v1",​
"ImageType": "BuiltIn"​
},​
"Ports": [​
{​
"Name": "SSH",​
"Type": "System",​
"ExternalPort": 2222,​
"InternalPort": 22,​
"SSHLoginCommand": ""​
}​
],​
"Resource": {​
"CpuNum": 1,​
"Memory": 2,​
"SpecId": "legacy",​
"ResourceId": "resourceId",​
"GpuCardsNum": 1​
},​
"Storages": [​
{​
"TOS": {​
"Source": "tos://adc/ab"​
},​
"Protocol": "TOS",​
"AccessKey": "ak-abc",​
"MountPath": "/mnt/tos",​
"SecretKey": "sk-abc"​
}​
],​
"Credential": {},​
"Description": "description",​
"PrivateNetwork": {​
"ClbId": "clb-abc",​
"ClbIp": "192.168.0.1",​
"VpcId": "vpc-abc",​
"SubnetIds": [​
"[subnet-abc]"​
],​
"SecurityGroupId": "sg-test"​
}​
}​
​
返回示例​
​
{​
"Result": {​
"DevMachineId": "dm-abc"​
},​
"ResponseMetadata": {​
"Action": "UpdateDevMachine",​
"Region": "cn-beijing",​
"Service": "las",​
"Version": "2025-08-15",​
"RequestId": "20230604110420****100232280022D31",​
"Deprecated": false​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
MissingParameter​
The required parameter {} is missing.​
缺少必需的参数 {}。​
400​
InvalidParameter​
The specified parameter {} is invalid.​
指定的参数 {} 无效。​
400​
InvalidRequestParam​
Invalid request param {}, cause {}​
非法请求参数 {}, 原因 {}​
400​
DevMachineNotFound​
Dev Machine [] Not Found​
开发机 [] 不存在​
400​
DevMachineIsNotChangeable​
dev Machine [] is not changeable.​
开发机 [] 目前不可变更​
500​
InternalError​
The request has failed due to an unknown error.​
由于未知错误,请求失败。​
​
​
最近更新时间:2026.09.18 10:58:48
这个页面对您有帮助吗?
有用
有用
无用
无用