文档中心

AI 数据湖服务

工作流实例

RunWorkflowInstance - 运行工作流实例

运行工作流实例

调试

API Explorer

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

去调试

请求参数

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

Action string 必选示例值：RunWorkflowInstance

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

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

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

Name string 必选示例值：workflow_instance_name

工作流实例名称

RunEnvs object[] 可选示例值：[ { "Name": "key1", "Value": "value1" } ]

已弃用，工作流实例运行环境变量，会覆盖/追加到所有其下任务实例的环境变量

Name string 必选示例值：Key

Name

Value string 必选示例值：Value

Value

WorkflowId string 必选示例值：wf-tpl-xxx

工作流 Id

ClientToken string 可选示例值：uuid-xxxxxx

客户端token

WorkflowRunEnvs object[] 可选示例值：[ { "Key": "key1", "Value": "value1" } ]

优先级高于 RunEnvs，会完全覆盖 RunEnvs，工作流实例运行环境变量，会覆盖/追加到所有其下任务实例的环境变量

Key string 必选示例值：name1

Key

Value string 必选示例值：value1

Value

返回参数

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

WorkflowInstanceId string 示例值：wf-tpl-xxx-yy

工作流实例 Id

请求示例

POST https://open.volcengineapi.com​
{​
    "Name": "workflow_instance_name",​
    "WorkflowId": "wf-tpl-xxx",​
    "ClientToken": ""​
}​

返回示例

{​
    "Result": {​
        "WorkflowInstanceId": "wf-tpl-xxx-yy"​
    },​
    "ResponseMetadata": {​
        "Action": "RunWorkflowInstance",​
        "Region": "cn-beijing",​
        "Service": "las_ai_dev",​
        "Version": "2025-08-15",​
        "RequestId": "20230604110420****100232280022D31",​
        "Deprecated": true​
    }​
}​

错误码

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

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

最近更新时间：2026.08.10 16:47:46

这个页面对您有帮助吗？

有用

无用