创建任务 ## 调试 [去调试](https://api.volcengine.com/api-explorer/?action=CreateTask&groupName=%E4%BB%BB%E5%8A%A1%E7%AE%A1%E7%90%86&serviceCode=las&version=2025-08-15) ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **Action** string 必选 `示例值：CreateTask` 要执行的操作，取值：CreateTask。 **Version** string 必选 `示例值：2025-08-15` API的版本，取值：2025\-08\-15。 **Name** string 必选 `示例值：test_name` 任务名称 **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` 镜像仓库用户名 **TaskType** string 必选 `示例值：Daft` 任务类型 **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 ## 返回参数下方仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336)。 **TaskId** string `示例值：t-uuid` 任务 Id ## 请求示例 ```text POST https://open.volcengineapi.com { "Name": "test_name", "CrossVpc": { "VpcId": "vpc-xxxxxx", "SubnetIds": [ { "Key": "name1", "Value": "value1" } ], "SecurityGroupId": "sg-xxxxxx" }, "DaftTask": { "Envs": [ { "Key": "ray.xxx", "Value": "a" } ], "Yaml": "Entrypoint 或 Yaml 必须选一种", "Image": "python:3.9", "Configs": [ { "Key": "ray.xxx", "Value": "a" } ], "RunEnvs": [ { "Key": "ray.xxx", "Value": "b" } ], "ImageType": "BuiltIn", "Entrypoint": "python /opt/main.py", "ImageCredential": { "Password": "123456", "UserName": "admin" } }, "TaskType": "Daft", "TosMount": { "AccessKey": "AKxxxxxx", "SecretKey": "xxxxxx==", "TosMountPaths": [ { "Source": "tos://test-bucket/test", "MountPath": "/mnt/test" } ] }, "SparkTask": { "Args": [ "--flag1", "value1" ], "Envs": [ { "name": "spark.xxx", "value": "a" } ], "Image": "python:3.9", "Configs": [ { "Key": "name1", "Value": "value1" } ], "ImageType": "BuiltIn", "JarTosUrl": "tos://xx.jar", "SparkType": "PySpark", "JarMainClass": "com.volcengine.Test", "ScriptTosUrl": "tos://xx.py", "DependencyFiles": [ "tos://xx.txt" ], "ImageCredential": { "Password": "123456", "UserName": "admin" }, "DependencyJarTosUrls": [ "tos://xx.jar" ], "DependencyPythonTosUrls": [ "tos://xx.zip", "tos://xx.py" ] }, "PythonTask": { "Args": [ "--a", "value1", "--b" ], "Envs": [ { "name": "a", "value": "value1" } ], "Image": "python:3.9", "RunEnvs": [ { "name": "b", "value": "b" } ], "ImageType": "BuiltIn", "Entrypoint": "python /code/xx.py", "ImageCredential": {} }, "ClientToken": "uuid-xxxxxx", "Description": "for test", "NasMountPaths": [ { "MountPath": "/test/nas/dst", "VolumePath": "/test/nas/src", "FileSystemId": "nas-uuid", "AccessPointId": "nas-access-point-uuid" } ], "TimeoutMinutes": 60, "VepfsMountPaths": [ { "MountPath": "/mnt/vepfs", "VolumePath": "/folder1/", "FileSystemId": "vepfs-xxxxxx", "AccessPointId": "ap-xxx" } ], "DatasetMountPaths": [ { "MountPath": "/test/data/dst", "DatasetName": "ds-uuid" } ], "DatasetCodeReviewId": "cr-uuid" } ``` ## 返回示例 ```json { "Result": { "TaskId": "t-uuid" }, "ResponseMetadata": { "Action": "CreateTask", "Region": "cn-beijing", "Service": "las_ai_qa", "Version": "2025-08-15", "RequestId": "20230604110420****100232280022D31", "Deprecated": true } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6369/68677)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |400 |MissingParameter |The required parameter {} is missing. |缺少必需的参数 {}。 | |400 |InvalidParameter |The specified parameter {} is invalid. |指定的参数 {} 无效。 | |400 |DryRunOperation |The request is validated by a dryrun operation. |该请求通过 dryrun 操作进行验证。 | |400 |InvalidRequestParam |Invalid request param {}, cause {} |非法请求参数 {}, 原因 {} | |500 |InternalError |The request has failed due to an unknown error. |由于未知错误，请求失败。 |

AI 数据湖服务