1. 接口描述
接口请求域名： wedata.tencentcloudapi.com 。
查询工作流运行
默认接口请求频率限制：20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：ListTriggerWorkflowRuns。 |
| Version | 是 | String | 公共参数，本接口取值：2025-08-06。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表。 |
| ProjectId | 是 | String | 项目ID 示例值：1289453534546 |
| Filters.N | 否 | Array of Filter | 过滤参数,工作流名称或ID查询名称：Keyword,工作流ID查询名称：WorkflowId,文件夹查询名称：FolderId,负责人查询名称：InChargeUin, 工作流执行id: ExecutionId |
| OrderFields.N | 否 | Array of OrderField | 排序字段，排序字段名称 如下开始时间：CreateTime，结束时间：EndTime |
| PageNumber | 否 | Integer | 页码 示例值：1 |
| PageSize | 否 | Integer | 页大小 示例值：10 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| Data | TriggerWorkflowRunResult | 工作流运行查询结果 |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 查询工作流运行信息
输入示例
POST / HTTP/1.1
Host: wedata.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ListTriggerWorkflowRuns
<公共请求参数>
{
"ProjectId": "1460947878944567296",
"PageNumber": 1,
"PageSize": 10
}输出示例
{
"Response": {
"Data": {
"Items": [
{
"AppId": "1315051789",
"CreateTime": "1766578800035",
"CycleType": "MINUTE_CYCLE",
"EndTime": null,
"ErrorCodeStr": "WaitingExecutionResource",
"ExecuteUserName": null,
"ExecuteUserUin": "100044422442",
"ExecutionCostTime": "0",
"ExecutionEndTime": null,
"ExecutionId": "8eea49e5-6ff1-43c2-9a09-9d263be0254a",
"ExecutionStartTime": null,
"ExecutionState": "QUEUED",
"FolderId": "27683508-bee2-11f0-9366-7c8c09fca71c",
"FolderName": "bonneyyu",
"PendingCostTime": "453",
"PendingStartTime": "1766578800946",
"PlannedSchedulingTime": null,
"ProjectId": "1460947878944567296",
"QueueCostTime": "0",
"QueueStartTime": "1766578800581",
"RerunTimes": 0,
"SelectedTaskIds": [
"20251122104618492",
"20251125143106316"
],
"SupportRerun": false,
"TriggerId": "4c62277b-a0ea-47a3-8bde-90b13c128905",
"TriggerType": "Scheduler",
"UserNameInCharge": "bonneyyu",
"UserUinInCharge": "100044422442",
"WorkflowId": "b0a148ad-ce76-4a75-8a1a-14e1994f2675",
"WorkflowName": "bonneyyu_test5",
"WorkflowParams": "{\"project112\":\"12\"}",
"WorkflowVersionId": "de467c0b-08d2-4776-b732-f3a5ea0f749a"
},
{
"AppId": "1315051789",
"CreateTime": "1766578200051",
"CycleType": "MINUTE_CYCLE",
"EndTime": null,
"ErrorCodeStr": "WaitingExecutionResource",
"ExecuteUserName": null,
"ExecuteUserUin": "100044422442",
"ExecutionCostTime": "0",
"ExecutionEndTime": null,
"ExecutionId": "f41703b7-4ca2-4518-adc1-4c1e902a7e2c",
"ExecutionStartTime": null,
"ExecutionState": "QUEUED",
"FolderId": "27683508-bee2-11f0-9366-7c8c09fca71c",
"FolderName": "bonneyyu",
"PendingCostTime": "1053",
"PendingStartTime": "1766578200775",
"PlannedSchedulingTime": null,
"ProjectId": "1460947878944567296",
"QueueCostTime": "0",
"QueueStartTime": "1766578200447",
"RerunTimes": 0,
"SelectedTaskIds": [
"20251122104618492",
"20251125143106316"
],
"SupportRerun": false,
"TriggerId": "4c62277b-a0ea-47a3-8bde-90b13c128905",
"TriggerType": "Scheduler",
"UserNameInCharge": "bonneyyu",
"UserUinInCharge": "100044422442",
"WorkflowId": "b0a148ad-ce76-4a75-8a1a-14e1994f2675",
"WorkflowName": "bonneyyu_test5",
"WorkflowParams": "{\"project112\":\"12\"}",
"WorkflowVersionId": "de467c0b-08d2-4776-b732-f3a5ea0f749a"
},
{
"AppId": "1315051789",
"CreateTime": "1766577600071",
"CycleType": "MINUTE_CYCLE",
"EndTime": null,
"ErrorCodeStr": "WaitingExecutionResource",
"ExecuteUserName": null,
"ExecuteUserUin": "100044422442",
"ExecutionCostTime": "0",
"ExecutionEndTime": null,
"ExecutionId": "0cd40b34-71f1-449f-8609-07adf3cda295",
"ExecutionStartTime": null,
"ExecutionState": "QUEUED",
"FolderId": "27683508-bee2-11f0-9366-7c8c09fca71c",
"FolderName": "bonneyyu",
"PendingCostTime": "1652",
"PendingStartTime": "1766577601091",
"PlannedSchedulingTime": null,
"ProjectId": "1460947878944567296",
"QueueCostTime": "1",
"QueueStartTime": "1766577600713",
"RerunTimes": 0,
"SelectedTaskIds": [
"20251122104618492",
"20251125143106316"
],
"SupportRerun": false,
"TriggerId": "4c62277b-a0ea-47a3-8bde-90b13c128905",
"TriggerType": "Scheduler",
"UserNameInCharge": "bonneyyu",
"UserUinInCharge": "100044422442",
"WorkflowId": "b0a148ad-ce76-4a75-8a1a-14e1994f2675",
"WorkflowName": "bonneyyu_test5",
"WorkflowParams": "{\"project112\":\"12\"}",
"WorkflowVersionId": "de467c0b-08d2-4776-b732-f3a5ea0f749a"
},
{
"AppId": "1315051789",
"CreateTime": "1766577600053",
"CycleType": "HOUR_CYCLE",
"EndTime": null,
"ErrorCodeStr": "WaitingExecutionResource",
"ExecuteUserName": null,
"ExecuteUserUin": "100028578781",
"ExecutionCostTime": "0",
"ExecutionEndTime": null,
"ExecutionId": "165a3009-c6d1-43e1-a415-257aa5630aef",
"ExecutionStartTime": null,
"ExecutionState": "QUEUED",
"FolderId": "f4afe0e4-4b5a-11f0-8ec8-b8599f277de5",
"FolderName": "0001",
"PendingCostTime": "1652",
"PendingStartTime": "1766577601111",
"PlannedSchedulingTime": null,
"ProjectId": "1460947878944567296",
"QueueCostTime": "1",
"QueueStartTime": "1766577600606",
"RerunTimes": 0,
"SelectedTaskIds": [
"20251124153853796",
"20251124153907522",
"20251124225418489",
"20251124215540484"
],
"SupportRerun": false,
"TriggerId": "0f0da343-7e97-45de-b125-858f45a88c96",
"TriggerType": "Scheduler",
"UserNameInCharge": "ivesjcjiang",
"UserUinInCharge": "100028578781",
"WorkflowId": "36f56792-1b9f-4bae-aa20-c80359f69c9c",
"WorkflowName": "ives_test1",
"WorkflowParams": "{\"project112\":\"12\"}",
"WorkflowVersionId": "80d8c67c-ba11-4d21-864a-7f65835d3ed5"
},
{
"AppId": "1315051789",
"CreateTime": "1766577000035",
"CycleType": "MINUTE_CYCLE",
"EndTime": null,
"ErrorCodeStr": "WaitingExecutionResource",
"ExecuteUserName": null,
"ExecuteUserUin": "100044422442",
"ExecutionCostTime": "0",
"ExecutionEndTime": null,
"ExecutionId": "8c19c03a-b396-4101-84bb-1054ac8c4efd",
"ExecutionStartTime": null,
"ExecutionState": "QUEUED",
"FolderId": "27683508-bee2-11f0-9366-7c8c09fca71c",
"FolderName": "bonneyyu",
"PendingCostTime": "2253",
"PendingStartTime": "1766577000969",
"PlannedSchedulingTime": null,
"ProjectId": "1460947878944567296",
"QueueCostTime": "0",
"QueueStartTime": "1766577000602",
"RerunTimes": 0,
"SelectedTaskIds": [
"20251122104618492",
"20251125143106316"
],
"SupportRerun": false,
"TriggerId": "4c62277b-a0ea-47a3-8bde-90b13c128905",
"TriggerType": "Scheduler",
"UserNameInCharge": "bonneyyu",
"UserUinInCharge": "100044422442",
"WorkflowId": "b0a148ad-ce76-4a75-8a1a-14e1994f2675",
"WorkflowName": "bonneyyu_test5",
"WorkflowParams": "{\"project112\":\"12\"}",
"WorkflowVersionId": "de467c0b-08d2-4776-b732-f3a5ea0f749a"
},
{
"AppId": "1315051789",
"CreateTime": "1766576400029",
"CycleType": "MINUTE_CYCLE",
"EndTime": null,
"ErrorCodeStr": "WaitingExecutionResource",
"ExecuteUserName": null,
"ExecuteUserUin": "100044422442",
"ExecutionCostTime": "0",
"ExecutionEndTime": null,
"ExecutionId": "9b4db3a1-a839-4fbc-81b6-2865851e1a18",
"ExecutionStartTime": null,
"ExecutionState": "QUEUED",
"FolderId": "27683508-bee2-11f0-9366-7c8c09fca71c",
"FolderName": "bonneyyu",
"PendingCostTime": "2853",
"PendingStartTime": "1766576400911",
"PlannedSchedulingTime": null,
"ProjectId": "1460947878944567296",
"QueueCostTime": "0",
"QueueStartTime": "1766576400546",
"RerunTimes": 0,
"SelectedTaskIds": [
"20251122104618492",
"20251125143106316"
],
"SupportRerun": false,
"TriggerId": "4c62277b-a0ea-47a3-8bde-90b13c128905",
"TriggerType": "Scheduler",
"UserNameInCharge": "bonneyyu",
"UserUinInCharge": "100044422442",
"WorkflowId": "b0a148ad-ce76-4a75-8a1a-14e1994f2675",
"WorkflowName": "bonneyyu_test5",
"WorkflowParams": "{\"project112\":\"12\"}",
"WorkflowVersionId": "de467c0b-08d2-4776-b732-f3a5ea0f749a"
},
{
"AppId": "1315051789",
"CreateTime": "1766575800052",
"CycleType": "MINUTE_CYCLE",
"EndTime": null,
"ErrorCodeStr": "WaitingExecutionResource",
"ExecuteUserName": null,
"ExecuteUserUin": "100044422442",
"ExecutionCostTime": "0",
"ExecutionEndTime": null,
"ExecutionId": "0125a779-3a00-45d3-b9ae-6fb7653a2d02",
"ExecutionStartTime": null,
"ExecutionState": "QUEUED",
"FolderId": "27683508-bee2-11f0-9366-7c8c09fca71c",
"FolderName": "bonneyyu",
"PendingCostTime": "3453",
"PendingStartTime": "1766575800811",
"PlannedSchedulingTime": null,
"ProjectId": "1460947878944567296",
"QueueCostTime": "0",
"QueueStartTime": "1766575800468",
"RerunTimes": 0,
"SelectedTaskIds": [
"20251122104618492",
"20251125143106316"
],
"SupportRerun": false,
"TriggerId": "4c62277b-a0ea-47a3-8bde-90b13c128905",
"TriggerType": "Scheduler",
"UserNameInCharge": "bonneyyu",
"UserUinInCharge": "100044422442",
"WorkflowId": "b0a148ad-ce76-4a75-8a1a-14e1994f2675",
"WorkflowName": "bonneyyu_test5",
"WorkflowParams": "{\"project112\":\"12\"}",
"WorkflowVersionId": "de467c0b-08d2-4776-b732-f3a5ea0f749a"
},
{
"AppId": "1315051789",
"CreateTime": "1766575200052",
"CycleType": "MINUTE_CYCLE",
"EndTime": null,
"ErrorCodeStr": "WaitingExecutionResource",
"ExecuteUserName": null,
"ExecuteUserUin": "100044422442",
"ExecutionCostTime": "0",
"ExecutionEndTime": null,
"ExecutionId": "b8d22d85-326d-45e9-9d1a-ac1cd6a16621",
"ExecutionStartTime": null,
"ExecutionState": "QUEUED",
"FolderId": "27683508-bee2-11f0-9366-7c8c09fca71c",
"FolderName": "bonneyyu",
"PendingCostTime": "4053",
"PendingStartTime": "1766575200901",
"PlannedSchedulingTime": null,
"ProjectId": "1460947878944567296",
"QueueCostTime": "0",
"QueueStartTime": "1766575200553",
"RerunTimes": 0,
"SelectedTaskIds": [
"20251122104618492",
"20251125143106316"
],
"SupportRerun": false,
"TriggerId": "4c62277b-a0ea-47a3-8bde-90b13c128905",
"TriggerType": "Scheduler",
"UserNameInCharge": "bonneyyu",
"UserUinInCharge": "100044422442",
"WorkflowId": "b0a148ad-ce76-4a75-8a1a-14e1994f2675",
"WorkflowName": "bonneyyu_test5",
"WorkflowParams": "{\"project112\":\"12\"}",
"WorkflowVersionId": "de467c0b-08d2-4776-b732-f3a5ea0f749a"
},
{
"AppId": "1315051789",
"CreateTime": "1766574600067",
"CycleType": "MINUTE_CYCLE",
"EndTime": null,
"ErrorCodeStr": "WaitingExecutionResource",
"ExecuteUserName": null,
"ExecuteUserUin": "100044422442",
"ExecutionCostTime": "0",
"ExecutionEndTime": null,
"ExecutionId": "463f30aa-dcd0-4936-ba6d-bc29fcce157c",
"ExecutionStartTime": null,
"ExecutionState": "QUEUED",
"FolderId": "27683508-bee2-11f0-9366-7c8c09fca71c",
"FolderName": "bonneyyu",
"PendingCostTime": "4653",
"PendingStartTime": "1766574601057",
"PlannedSchedulingTime": null,
"ProjectId": "1460947878944567296",
"QueueCostTime": "0",
"QueueStartTime": "1766574600614",
"RerunTimes": 0,
"SelectedTaskIds": [
"20251122104618492",
"20251125143106316"
],
"SupportRerun": false,
"TriggerId": "4c62277b-a0ea-47a3-8bde-90b13c128905",
"TriggerType": "Scheduler",
"UserNameInCharge": "bonneyyu",
"UserUinInCharge": "100044422442",
"WorkflowId": "b0a148ad-ce76-4a75-8a1a-14e1994f2675",
"WorkflowName": "bonneyyu_test5",
"WorkflowParams": "{\"project112\":\"12\"}",
"WorkflowVersionId": "de467c0b-08d2-4776-b732-f3a5ea0f749a"
},
{
"AppId": "1315051789",
"CreateTime": "1766574000052",
"CycleType": "MINUTE_CYCLE",
"EndTime": null,
"ErrorCodeStr": "WaitingExecutionResource",
"ExecuteUserName": null,
"ExecuteUserUin": "100044422442",
"ExecutionCostTime": "0",
"ExecutionEndTime": null,
"ExecutionId": "7757c65c-c153-483a-ad70-b6a28d848d13",
"ExecutionStartTime": null,
"ExecutionState": "QUEUED",
"FolderId": "27683508-bee2-11f0-9366-7c8c09fca71c",
"FolderName": "bonneyyu",
"PendingCostTime": "5253",
"PendingStartTime": "1766574000914",
"PlannedSchedulingTime": null,
"ProjectId": "1460947878944567296",
"QueueCostTime": "0",
"QueueStartTime": "1766574000568",
"RerunTimes": 0,
"SelectedTaskIds": [
"20251122104618492",
"20251125143106316"
],
"SupportRerun": false,
"TriggerId": "4c62277b-a0ea-47a3-8bde-90b13c128905",
"TriggerType": "Scheduler",
"UserNameInCharge": "bonneyyu",
"UserUinInCharge": "100044422442",
"WorkflowId": "b0a148ad-ce76-4a75-8a1a-14e1994f2675",
"WorkflowName": "bonneyyu_test5",
"WorkflowParams": "{\"project112\":\"12\"}",
"WorkflowVersionId": "de467c0b-08d2-4776-b732-f3a5ea0f749a"
}
],
"PageNumber": 1,
"PageSize": 10,
"TotalCount": 10705,
"TotalPageNumber": 1071
},
"RequestId": "fd1420f1-5ed4-40b5-acb5-be94b0137c1b"
}
}5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| InternalError | 内部错误。 |
| InvalidParameterValue | 参数取值错误。 |
| MissingParameter | 缺少参数错误。 |
| OperationDenied | 操作被拒绝。 |
| ResourceNotFound | 资源不存在。 |
| UnauthorizedOperation | 未授权操作。 |
| UnknownParameter | 未知参数错误。 |
