启动任务实例

调试

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 一致

MaxReplicas integer 可选示例值：1

Daft Worker 最大实例数，默认和 Replicas 相同

MinReplicas integer 可选示例值：1

Daft Worker 最小实例数，默认和 Replicas 相同

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

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

DaftWorkerGroups，如果设置则至少包含一个 WorkerGroup，将忽略 DaftResourceConfig 下的 WorkerCpuNum、WorkerMemorySize、WorkerGpuNum、Replicas 参数

Replicas integer 可选示例值：1

Daft worker 实例数，默认 1

EnableMGpu boolean 可选示例值：false

DaftWorker 开启 mGPU 功能。开启后将使用 WorkerMGpuCorePercentage 和 WorkerMGpuMemorySize 参数、忽略 WorkerGpuNum 参数

MaxReplicas integer 可选示例值：1

Daft Worker 最大实例数，默认和 Replicas 相同

MinReplicas integer 可选示例值：1

Daft Worker 最小实例数，默认和 Replicas 相同

WorkerCpuNum float 必选示例值：1.2

DaftWorker cpu 数量

WorkerGpuNum float 可选示例值：0.1

DaftWorker gpu 数量，默认 0

ResourceSpecId string 必选示例值：spec_uuid

队列资源规格Id

WorkerGroupName string 必选示例值：worker_group_name

WorkerGroupName

WorkerMemorySize float 可选示例值：1.2

DaftWorker memory 容量，单位 Gi

WorkerMGpuMemorySize integer 可选示例值：1024

mGPU 使用内存大小，单位 MiB，开启 mGPU 时必须大于 256MiB

WorkerMGpuCorePercentage integer 可选示例值：30

mGPU 使用核心百分比，开启 mGPU 时范围为 5 ~ 99

WorkerMemorySize float 可选示例值：1.2

DaftWorker memory 容量，单位 Gi

WorkerMGpuMemorySize integer 可选示例值：1024

mGPU 使用内存大小，单位 MiB，开启 mGPU 时必须大于 256MiB

EnableMultiWorkerGroup boolean 可选示例值：false

启用 DaftWorkerGroups 参数，将忽略 DaftResourceConfig 下的 WorkerCpuNum、WorkerMemorySize、WorkerGpuNum、Replicas 参数

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

SharedMemorySize integer 可选示例值：2

共享内存大小，单位 Gi。仅 Python 任务生效；未设置时 EMR 侧默认按任务内存的 70% 分配；上限为任务内存，必须为整数

MGpuCorePercentage integer 可选示例值：30

mGPU 使用核心百分比，开启 mGPU 时范围为 5 ~ 100

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

TaskInstanceId string 示例值：ti-uuid

作业实例ID

请求示例

返回示例

错误码

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

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

AI 数据湖服务