文档首页/ 数据治理中心 DataArts Studio/ API参考/ 数据开发API(V2)/ 作业开发API/ 查询作业的输入输出表 - ListJobInputOutputTables
更新时间:2026-06-04 GMT+08:00
分享

查询作业的输入输出表 - ListJobInputOutputTables

功能介绍

根据作业ID查询该作业解析的输入表和输出表,用于数据治理场景,判断作业是否可以下线。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v2/{project_id}/factory/task-table-references/{job_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方法请参见项目ID和账号ID

job_id

Long

作业Id。

表2 Query参数

参数

是否必选

参数类型

描述

io_type

String

表类型筛选,可选值:作业和表的关系,0表示作业是读表,1表示作业写表,2表示全部(默认)。

offset

Integer

分页列表的页数,默认值为0。取值范围大于等于0。

limit

Integer

分页返回结果,指定每页最大记录数。范围[1,100]

默认值:20

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

IAM Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值),使用Token认证时必选,最小长度:0,最大长度:4096。

X-Project-Id

String

project_id,项目编号。获取方法请参见项目ID和账号ID

多project场景采用AK/SK认证的接口请求,则该字段必选。

Content-Type

String

默认值:application/json;charset=UTF-8

可选,有Body体的情况下必选,没有Body体则无需填写和校验。

workspace

String

工作空间ID,获取方法请参见实例ID和工作空间ID

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

job_id

Long

作业ID。

job_name

String

作业名称。

table_count

Integer

表总数。

tables

Array of JobTableInfo objects

表列表。

表5 JobTableInfo

参数

参数类型

描述

db_type

String

数据库类型,仅支持DLI,HIVE,SPARK。

data_base

String

数据库名称。

table_name

String

表名称。

io_type

Integer

作业和表的关系,0表示作业是读表,1表示作业写表。

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

查询作业ID为5625的输入表列表。

GET /v2/{project_id}/factory/task-table-references/5625?io_type=0

响应示例

状态码:200

查询成功,返回作业的输入输出表信息。

{
  "job_id" : 5625,
  "job_name" : "job_5441",
  "table_count" : 2,
  "tables" : [ {
    "data_base" : "1_database",
    "db_type" : "DLI",
    "io_type" : 0,
    "table_name" : "d_2026-01-21 18:44:16:660"
  }, {
    "data_base" : "1_database",
    "db_type" : "DLI",
    "io_type" : 0,
    "table_name" : "b_20260121184416"
  } ]
}

状态码:400

查询失败。

{
  "error_code" : "DLF.5013",
  "error_msg" : "The request param is invalid."
}

状态码

状态码

描述

200

查询成功,返回作业的输入输出表信息。

400

查询失败。

相关文档