RunTaskInstance - 启动任务实例--AI 数据湖服务-火山引擎

文档中心

立即注册

AI 数据湖服务

任务管理

RunTaskInstance - 启动任务实例

启动任务实例

调试

API Explorer

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

去调试

请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	RunTaskInstance	要执行的操作，取值：RunTaskInstance。
Version	String	是	2025-08-15	API的版本，取值：2025-08-15。
RunEnvs	Array of Object	否	[{"Key":"ray.xxx", "Value": "b"}]	执行时追加/覆盖环境变量
Entrypoint	String	否	python /opt/main.py	入口命令。执行时可覆盖
TaskId	String	是	Daft-xxxxxx	任务Id
ResourceId	String	是	resource_xxxxxx	队列资源Id
ClientToken	String	否	uuid-xxxxxx	客户端token
DaftResourceConfig	Object	否	--	Daft资源配置
SparkResourceConfig	Object	否	--	Spark资源配置
PythonResourceConfig	Object	否	--	Python资源配置

返回参数

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

参数	类型	示例值	描述
TaskInstanceId	String	ti-uuid	作业实例ID

请求示例

POST /?Action=RunTaskInstance&Version=2025-08-15 HTTP/1.1
Host: open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20250819T071728Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250819/cn-beijing/las_ai_dev/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "TaskId": "Daft-xxxxxx",
  "ResourceId": "resource_xxxxxx",
  "ClientToken": "uuid-xxxxxx",
  "DaftResourceConfig": {
    "Replicas": 1,
    "HeadCpuNum": 1.2,
    "WorkerCpuNum": 1.2,
    "WorkerGpuNum": 0.1,
    "HeadMemorySize": 1.2,
    "WorkerMemorySize": 1.2
  },
  "SparkResourceConfig": {
    "Replicas": 1,
    "DriverCpuNum": 1,
    "DriverGpuNum": 0.1,
    "ExecutorCpuNum": 1,
    "ExecutorGpuNum": 0.1,
    "DriverMemorySize": 4,
    "ExecutorMemorySize": 4
  },
  "PythonResourceConfig": {
    "CpuNum": 1.1,
    "GpuNum": 0.1,
    "Replicas": 1,
    "MemorySize": 1.1
  }
}

返回示例

{
    "Result": {
        "TaskInstanceId": "i-uuid"
    },
    "ResponseMetadata": {
        "Action": "RunTaskInstance",
        "Region": "cn-north-1",
        "Service": "las_ai_qa",
        "Version": "2025-08-15",
        "RequestId": "20230604110420****100232280022D31",
        "Deprecated": true
    }
}

错误码

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

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

最近更新时间：2025.12.19 11:47:22

这个页面对您有帮助吗？

有用

无用

AI 数据湖服务

调试 #

请求参数 #

返回参数 #

请求示例 #

返回示例 #

错误码 #

调试

请求参数

返回参数

请求示例

返回示例

错误码