1. 接口描述
接口请求域名: adp.tencentcloudapi.com 。
DescribeAppTriggerRunLogList
默认接口请求频率限制:20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数,本接口取值:DescribeAppTriggerRunLogList。 |
| Version | 是 | String | 公共参数,本接口取值:2026-05-20。 |
| Region | 是 | String | 公共参数,详见产品支持的 地域列表。 |
| AppId | 否 | String | 应用ID 示例值:2072866150944382336 |
| FilterList.N | 否 | Array of Filter | 过滤参数 |
| PageNumber | 否 | Integer | 页码 取值范围:[1, 1000000] 示例值:1 |
| PageSize | 否 | Integer | 每页数据量 取值范围:[1, 100] 示例值:10 |
| TriggerId | 否 | String | 应用触发器ID 示例值:64201696-52ee-49f6-a95b-0773b60a8e6b |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| RunLogList | Array of AppTriggerRunLog | 日志列表 |
| TotalCount | String | 日志列表数量 示例值:2 |
| RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 成功
输入示例
POST / HTTP/1.1
Host: adp.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeAppTriggerRunLogList
<公共请求参数>
{
"AppId": "2072866150944382336",
"FilterList": [
{
"Name": "PushStatus",
"Operator": 0,
"ValueList": [
"4"
]
}
],
"PageNumber": 1,
"PageSize": 10,
"TriggerId": "64201696-52ee-49f6-a95b-0773b60a8e6b"
}
输出示例
{
"Response": {
"RunLogList": [
{
"ConversationId": "t2e41cd4a39cc455ea5308a543db8ac13",
"DurationMs": "19106",
"EndTime": "2026-07-03T10:41:44+08:00",
"FireType": 3,
"InstanceId": "2e41cd4a-39cc-455e-a530-8a543db8ac13",
"PushStatus": 4,
"ResultCode": "SUCCESS",
"ResultSummary": "每隔 1 分钟执行 `hello` 工作流,对应的 **cron 表达式**为:\n\n
\n* * * * \n\n\n各字段含义(从左到右):\n\n| 字段 | 值 | 含义 |\n|------|------|------|\n| 分钟 | `*` | 每分钟 |\n| 小时 | `*` | 每小时 |\n| 日 | `*` | 每天 |\n| 月 | `*` | 每月 |\n| 星期 | `*` | 每周任意一天 |\n\n---\n\n**常见平台的配置方式:**\n\n**1. Linux crontab**\n
\n\n**2. GitHub Actions**\n
\n\n**3. Kubernetes CronJob**\n
\n\n**4. Airflow DAG**\n
"RunId": "msg_a2583256-5c07-4e38-8992-6b49daf00d41_1",
"ScheduledFireTime": "2026-07-03T10:41:24+08:00",
"StartTime": "2026-07-03T10:41:24+08:00",
"Status": 4,
"TriggerId": "64201696-52ee-49f6-a95b-0773b60a8e6b",
"Unread": true,
"WorkflowRunId": ""
}
],
"TotalCount": "2",
"RequestId": "121a757c-9765-4130-ac51-a8e2edce74c7"
}
}
## 5. 开发者资源
### 腾讯云 API 平台
[腾讯云 API 平台](https://cloud.tencent.com/api) 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
### API Inspector
用户可通过 [API Inspector](https://cloud.tencent.com/document/product/1278/49361) 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 [API Explorer](https://cloud.tencent.com/document/product/1278/46697) 进行在线调试。
### SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
* Tencent Cloud SDK 3.0 for Python: [CNB](https://cnb.cool/tencent/cloud/api/sdk/tencentcloud-sdk-python/-/blob/master/tencentcloud/adp/v20260520/adp_client.py), [GitHub](https://github.com/TencentCloud/tencentcloud-sdk-python/blob/master/tencentcloud/adp/v20260520/adp_client.py), [Gitee](https://gitee.com/TencentCloud/tencentcloud-sdk-python/blob/master/tencentcloud/adp/v20260520/adp_client.py)
* Tencent Cloud SDK 3.0 for Java: [CNB](https://cnb.cool/tencent/cloud/api/sdk/tencentcloud-sdk-java/-/blob/master/src/main/java/com/tencentcloudapi/adp/v20260520/AdpClient.java), [GitHub](https://github.com/TencentCloud/tencentcloud-sdk-java/blob/master/src/main/java/com/tencentcloudapi/adp/v20260520/AdpClient.java), [Gitee](https://gitee.com/TencentCloud/tencentcloud-sdk-java/blob/master/src/main/java/com/tencentcloudapi/adp/v20260520/AdpClient.java)
* Tencent Cloud SDK 3.0 for PHP: [CNB](https://cnb.cool/tencent/cloud/api/sdk/tencentcloud-sdk-php/-/blob/master/src/TencentCloud/Adp/V20260520/AdpClient.php), [GitHub](https://github.com/TencentCloud/tencentcloud-sdk-php/blob/master/src/TencentCloud/Adp/V20260520/AdpClient.php), [Gitee](https://gitee.com/TencentCloud/tencentcloud-sdk-php/blob/master/src/TencentCloud/Adp/V20260520/AdpClient.php)
* Tencent Cloud SDK 3.0 for Go: [CNB](https://cnb.cool/tencent/cloud/api/sdk/tencentcloud-sdk-go/-/blob/master/tencentcloud/adp/v20260520/client.go), [GitHub](https://github.com/TencentCloud/tencentcloud-sdk-go/blob/master/tencentcloud/adp/v20260520/client.go), [Gitee](https://gitee.com/TencentCloud/tencentcloud-sdk-go/blob/master/tencentcloud/adp/v20260520/client.go)
* Tencent Cloud SDK 3.0 for Node.js: [CNB](https://cnb.cool/tencent/cloud/api/sdk/tencentcloud-sdk-nodejs/-/blob/master/src/services/adp/v20260520/adp_client.ts), [GitHub](https://github.com/TencentCloud/tencentcloud-sdk-nodejs/blob/master/src/services/adp/v20260520/adp_client.ts), [Gitee](https://gitee.com/TencentCloud/tencentcloud-sdk-nodejs/blob/master/src/services/adp/v20260520/adp_client.ts)
* Tencent Cloud SDK 3.0 for .NET: [CNB](https://cnb.cool/tencent/cloud/api/sdk/tencentcloud-sdk-dotnet/-/blob/master/TencentCloud/Adp/V20260520/AdpClient.cs), [GitHub](https://github.com/TencentCloud/tencentcloud-sdk-dotnet/blob/master/TencentCloud/Adp/V20260520/AdpClient.cs), [Gitee](https://gitee.com/TencentCloud/tencentcloud-sdk-dotnet/blob/master/TencentCloud/Adp/V20260520/AdpClient.cs)
* Tencent Cloud SDK 3.0 for C++: [CNB](https://cnb.cool/tencent/cloud/api/sdk/tencentcloud-sdk-cpp/-/blob/master/adp/src/v20260520/AdpClient.cpp), [GitHub](https://github.com/TencentCloud/tencentcloud-sdk-cpp/blob/master/adp/src/v20260520/AdpClient.cpp), [Gitee](https://gitee.com/TencentCloud/tencentcloud-sdk-cpp/blob/master/adp/src/v20260520/AdpClient.cpp)
* Tencent Cloud SDK 3.0 for Ruby: [CNB](https://cnb.cool/tencent/cloud/api/sdk/tencentcloud-sdk-ruby/-/blob/master/tencentcloud-sdk-adp/lib/v20260520/client.rb), [GitHub](https://github.com/TencentCloud/tencentcloud-sdk-ruby/blob/master/tencentcloud-sdk-adp/lib/v20260520/client.rb), [Gitee](https://gitee.com/TencentCloud/tencentcloud-sdk-ruby/blob/master/tencentcloud-sdk-adp/lib/v20260520/client.rb)
### 命令行工具
* [Tencent Cloud CLI 3.0](https://cloud.tencent.com/document/product/440/6176)
## 6. 错误码
该接口暂无业务逻辑相关的错误码,其他错误码详见 [公共错误码](/document/api/1759/132554#.E5.85.AC.E5.85.B1.E9.94.99.E8.AF.AF.E7.A0.81)。