更新任务

调试

API Explorer

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

去调试

请求参数

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

Action string 必选示例值：UpdateTask

要执行的操作，取值：UpdateTask。

Version string 必选示例值：2025-08-15

API的版本，取值：2025-08-15。

Name string 可选示例值：test_name

任务名称

TaskId string 必选示例值：t-uuid

作业Id

CrossVpc object 可选示例值：--

打通 vpc 所需参数。更新时赋值为 {} (或 VpcId="")表示删除

VpcId string 必选示例值：vpc-xxxxxx

VPC ID。

SubnetIds object[] 必选示例值：{ "Name": "A", "Value": "subnet-a" }

子网 ID list, 键为可用区(A/B/C/D/E/...), 值为子网 ID. 同时输入 SubnetIds 时，本参数无效. 作为返回值时，优先参考本参数.

Key string 必选示例值：name1

Key

Value string 必选示例值：value1

Value

SecurityGroupId string 必选示例值：sg-xxxxxx

VPC 所属安全组 ID

EnableDnsResolve boolean 可选示例值：true

访问 VPC 下 PrivateZone/PrivateLink 域名

DaftTask object 可选示例值：--

Daft 作业参数

Envs object[] 可选示例值：[ { "Key": "ray.xxx", "Value": "a" } ]

环境变量，重复键会被覆盖，字符总长度不超过 500KB

Key string 必选示例值：name1

Key

Value string 必选示例值：value1

Value

Yaml string 可选示例值：Entrypoint 或 Yaml 必须选一种

基于 Yaml 执行，最大长度 1.5MB

Image string 必选示例值：python:3.9

作业 Image 地址

Configs object[] 可选示例值：[ { "Key": "ray.xxx", "Value": "a" } ]

Daft 配置，重复键会被覆盖，字符总合长度不超过 500KB

Key string 必选示例值：name1

Key

Value string 必选示例值：value1

Value

RunEnvs object[] 可选示例值：[ { "Key": "ray.xxx", "Value": "b" } ]

执行时追加/覆盖环境变量，字符总长度不超过 200KB

Key string 必选示例值：name1

Key

Value string 必选示例值：value1

Value

ImageType string 必选示例值：BuiltIn

镜像类型。BuiltIn-内置镜像，Custom-自定义镜像，VolcanoCr-火山镜像仓库镜像，External-外部第三方镜像(如 DockerHub)

Entrypoint string 可选示例值：python /opt/main.py

Daft 作业入口命令，执行时可覆盖，命令 + 参数长度不超过 2MB

ImageCredential object 可选

外部镜像凭证

Password string 可选示例值：123456

镜像仓库密钥

UserName string 可选示例值：admin

镜像仓库用户名

TosMount object 可选示例值：--

tos 加载参数。更新时赋值为 {} (或 TosMountPaths=[])表示删除

AccessKey string 必选示例值：AKxxxxxx

ak

MountType string 可选

MountType

SecretKey string 可选示例值：xxxxxx==

密码，只写入，不返回。更新时不填写则不更新

TosMountPaths object[] 必选示例值：--

TosMountPaths

Source string 必选示例值：tos://test-bucket/test

TOS 路径

MountPath string 必选示例值：/mnt/test

挂载路径

PythonTask object 可选示例值：--

Python 作业参数

Args string[] 可选示例值：[ "--a", "value1", "--b" ]

参数列表

Envs object[] 可选示例值：[ { "name": "a", "value": "value1" } ]

环境变量，字符总长度不超过 500KB

Key string 必选示例值：name1

Key

Value string 必选示例值：value1

Value

Image string 必选示例值：python:3.9

作业 Image 地址

RunEnvs object[] 可选示例值：[ { "name": "b", "value": "b" } ]

执行时追加/覆盖环境变量，字符总长度不超过 200KB

Key string 必选示例值：name1

Key

Value string 必选示例值：value1

Value

ImageType string 必选示例值：BuiltIn

镜像类型

Entrypoint string 必选示例值：python /code/xx.py

启动命令，执行时可覆盖，命令 + 参数长度不超过 2MB

ImageCredential object 可选

外部镜像凭证

Password string 可选示例值：123456

镜像仓库密钥

UserName string 可选示例值：admin

镜像仓库用户名

ClientToken string 可选示例值：uuid-xxxxxx

客户端token

Description string 可选示例值：for test

任务注释

NasMountPaths object[] 可选示例值：--

nas 加载参数。更新时赋值为 [] 表示删除

MountPath string 必选示例值：/test/nas/dst

挂载到Pod中的路径

VolumePath string 必选示例值：/test/nas/src

NAS文件系统待挂载的路径（NAS中的原路径）

FileSystemId string 必选示例值：nas-uuid

NAS文件系统id

AccessPointId string 必选示例值：nas-access-point-uuid

接入点Id

TimeoutMinutes integer 可选示例值：60

任务超时分钟数，超时后会自动 cancel，默认 0 不开启

VepfsMountPaths object[] 可选示例值：--

vepfs 加载参数。更新时赋值为 [] 表示删除

MountPath string 必选示例值：/mnt/vepfs

挂载到Pod中的路径

VolumePath string 必选示例值：/folder1/

vePFS文件系统待挂载的路径（vePFS中的原路径）

FileSystemId string 必选示例值：vepfs-xxxxxx

vePFS文件系统id

AccessPointId string 必选示例值：ap-xxx

vePFS 接入点 Id

DatasetMountPaths object[] 可选示例值：--

数据集加载参数。更新时赋值为 [] 表示删除

MountPath string 必选示例值：/test/data/dst

挂载到 Pod 中的路径

DatasetName string 必选示例值：ds-uuid

数据集 id

DatasetCodeReviewId string 可选示例值：cr-uuid

数据集代码审核 id

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidParameter	The specified parameter {} is invalid.	指定的参数 {} 无效。
400	DryRunOperation	The request is validated by a dryrun operation.	该请求通过 dryrun 操作进行验证。
400	MissingParameter	The required parameter {} is missing.	缺少必需的参数 {}。
400	InvalidRequestParam	Invalid request param {}, cause {}	非法请求参数 {}, 原因 {}
500	InternalError	The request has failed due to an unknown error.	由于未知错误，请求失败。

AI 数据湖服务