1. 接口描述
接口请求域名: wedata.tencentcloudapi.com 。
根据任务ID分页查询任务绑定监听的事件
默认接口请求频率限制:20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:DescribeRelatedTasksByTaskId。 |
Version | 是 | String | 公共参数,本接口取值:2021-08-20。 |
Region | 是 | String | 公共参数,详见产品支持的 地域列表。 |
ProjectId | 是 | String | 项目Id 示例值:1464962169590902784 |
TaskId | 是 | String | 任务Id 示例值:20250606112506283 |
PageNumber | 是 | Integer | 当前页码,从1开始 示例值:1 |
PageSize | 是 | Integer | 单页大小,最大200 示例值:10 |
DependencyDirection | 是 | String | 查询直接依赖方向,如UP表示上游、DOWN表示下游 示例值:UP |
Environment | 是 | String | 查询开发环境还是生产环境版本,DEV表示开发环境、PROD表示生产环境 示例值:DEV |
TaskName | 否 | String | 任务名称,模糊搜索 示例值:taskName |
CycleTypeList.N | 否 | Array of String | 任务调度周期,I:分支;H:小时;D:天;W:周;M:月;Y:年;O:一次性。 示例值:D |
StatusList.N | 否 | Array of String | 任务状态,N:新建; Y:调度中; O:已暂停;F:已下线;INVALID:已失效 示例值:NS |
OwnerNameList.N | 否 | Array of String | 任务责任人名 示例值:name |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
Data | DescribeRelatedTasksByTaskIdResp | 查询到的直接上下游任务列表结果 注意:此字段可能返回 null,表示取不到有效值。 |
RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 成功示例
输入示例
POST / HTTP/1.1
Host: wedata.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeRelatedTasksByTaskId
<公共请求参数>
{
"ProjectId": "1464962169590902784",
"TaskId": "20250606112506283",
"PageNumber": 1,
"PageSize": 10,
"DependencyDirection": "UP",
"Environment": "DEV",
"TaskName": "",
"CycleTypeList": [],
"StatusList": [],
"OwnerNameList": []
}
输出示例
{
"Response": {
"Data": {
"PageNumber": 1,
"PageSize": 10,
"RelatedTaskList": [
{
"CycleType": "D",
"DependencyDirection": "UP",
"OwnerName": "peanutzhu",
"ProjectDisplayName": "wedata数据开发",
"ProjectId": "1464962169590902784",
"Status": "N",
"TaskId": "20250606112604725",
"TaskName": "test_0606_1",
"TaskTypeId": 35,
"WorkflowId": "ab43623e-2473-413a-8c80-59e875167c96",
"WorkflowName": "test_ceshi"
}
],
"TotalCount": 1
},
"RequestId": "49c7dfc2-c145-4937-830d-96ab1608a430"
}
}
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: GitHub, Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub, Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub, Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub, Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub, Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub, Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub, Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub, Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
AuthFailure | CAM签名/鉴权错误。 |
FailedOperation | 操作失败。 |
InvalidParameter | 参数错误。 |
InvalidParameterValue | 参数取值错误。 |
MissingParameter | 缺少参数错误。 |