AI 数据湖服务
AI 数据湖服务
开发参考
请输入
- 文档首页
AI 数据湖服务API 参考：管控面任务管理RunTaskInstance - 启动任务实例
复制全文
下载 pdfRunTaskInstance - 启动任务实例
文档反馈
问问助手启动任务实例
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：RunTaskInstance
要执行的操作，取值：RunTaskInstance。
Version string 必选 示例值：2025-08-15
API的版本，取值：2025-08-15。
TaskId string 必选 示例值：Daft-xxxxxx
任务Id
RunEnvs object[] 可选 示例值：[ { "Key": "ray.xxx", "Value": "b" } ]
执行时追加/覆盖环境变量
Key string 必选 示例值：name1
Key
Value string 必选 示例值：value1
Value
Priority integer 可选 示例值：1
任务优先级, 0(最低)~9(最高), 优先级>=3的任务可能抢占优先级<=2的任务，< 0 表示不设置优先级
Entrypoint string 可选 示例值：python /opt/main.py
入口命令。执行时可覆盖
ResourceId string 必选 示例值：resource_xxxxxx
队列资源Id
ClientToken string 可选 示例值：uuid-xxxxxx
客户端token
DaftResourceConfig object 可选 示例值：--
Daft资源配置
Replicas integer 可选 示例值：1
Daft worker 实例数，默认 1
EnableMGpu boolean 可选 示例值：false
DaftWorker 开启 mGPU 功能。开启后将使用 WorkerMGpuCorePercentage 和 WorkerMGpuMemorySize 参数、忽略 WorkerGpuNum 参数
HeadCpuNum float 可选 示例值：1.2
DaftHead cpu 数量，默认与 WorkerCpuNum 一致
WorkerCpuNum float 可选 示例值：1.2
DaftWorker cpu 数量
WorkerGpuNum float 可选 示例值：0.1
DaftWorker gpu 数量，默认 0
HeadMemorySize float 可选 示例值：1.2
DaftHead memory 容量，单位 Gi，默认与 WorkerMemorySize 一致
ResourceSpecId string 可选 示例值：spec_uuid
队列资源规格Id
WorkerMemorySize float 可选 示例值：1.2
DaftWorker memory 容量，单位 Gi
WorkerMGpuMemorySize integer 可选 示例值：1024
mGPU 使用内存大小，单位 MiB，开启 mGPU 时必须大于 256MiB
WorkerMGpuCorePercentage integer 可选 示例值：30
mGPU 使用核心百分比，开启 mGPU 时范围为 5 ~ 100
ResourceSpecGroupId string 可选 示例值：group_uuid
队列资源规格组Id
PythonResourceConfig object 可选 示例值：--
Python资源配置
CpuNum float 必选 示例值：1.1
CPU 数量
GpuNum float 可选 示例值：0.1
GPU 数量，默认 0.0
Replicas integer 可选 示例值：1
运行实例数量，默认 1
EnableMGpu boolean 可选 示例值：false
开启 mGPU 功能。开启后将使用 MGpuCorePercentage 和 MGpuMemorySize 参数、忽略 GpuNum 参数
MemorySize float 可选 示例值：1.1
内存大小，单位 Gi，默认为 CpuNum * 4
MGpuMemorySize integer 可选 示例值：1024
mGPU 使用内存大小，单位 MiB，开启 mGPU 时必须大于 256MiB
MGpuCorePercentage integer 可选 示例值：30
mGPU 使用核心百分比，开启 mGPU 时范围为 5 ~ 100
返回参数
TaskInstanceId string 示例值：ti-uuid
作业实例ID
请求示例
POST https://open.volcengineapi.com
{
"ResourceId": "resource_xxxxxx",
"TaskId": "Daft-xxxxxx",
"DaftResourceConfig": {
"WorkerCpuNum": 1,
"WorkerMemorySize": 3,
"WorkerGpuNum": 0,
"Replicas": 1,
"HeadCpuNum": 1,
"HeadMemorySize": 3
}
}
返回示例
{
"Result": {
"TaskInstanceId": "ti-uuid"
},
"ResponseMetadata": {
"Action": "RunTaskInstance",
"Region": "cn-beijing",
"Service": "las_ai_qa",
"Version": "2025-08-15",
"RequestId": "20230604110420****100232280022D31",
"Deprecated": true
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
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 {} | 非法请求参数 {}, 原因 {} |
400 | EmptyResource | Resource doesn't exist. | 队列不存在 |
500 | InternalError | The request has failed due to an unknown error. | 由于未知错误，请求失败。 |
最近更新时间：2026.07.02 15:03:53
这个页面对您有帮助吗？
有用
有用
无用
无用