调用ListInstances获取实例的列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
dataworks:* |
list |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ProjectEnv |
string |
是 |
运行的环境,包括 PROD(生产环境)和 DEV(开发环境)。 枚举值:
|
PROD |
| NodeId |
integer |
否 |
节点的 ID。您可以调用 ListNodes 查看节点 ID 信息。 |
100000000000 |
| NodeName |
string |
否 |
节点的名称。您可以调用 ListNodes 查看节点名称。 |
openmr_8**** |
| Owner |
string |
否 |
负责人的 ID,即工作空间管理员的账号 UID。您可登录阿里云控制台后,在账号管理的安全管理中查看账号 UID。 |
193379**** |
| ProjectId |
integer |
是 |
工作空间的 ID。您可以调用 ListProjects 查看空间 ID 信息。 |
12345 |
| BizName |
string |
否 |
业务流程的名称。您可以调用 ListBusiness 查看业务流程信息。 |
test_bizName |
| ProgramType |
string |
否 |
节点的类型。您可以调用 ListNodes 查看节点类型。 |
ODPS_SQL |
| PageNumber |
integer |
否 |
页码数,用于翻页。最小值为 1,最大值为 100。 |
1 |
| PageSize |
integer |
否 |
每页显示的条数,默认为 10 条,最大 100 条。 |
10 |
| DagId |
integer |
否 |
DagId 可以是执行补数据 RunCycleDagNodes ,冒烟测试 RunSmokeTest ,手动业务流程 RunManualDagNodes 等接口返回的 DagId。 |
11111 |
| Bizdate |
string |
否 |
获取实例列表的日期,格式为 yyyy-MM-dd HH:mm:ss。 |
2020-02-02 00:00:00 |
| BeginBizdate |
string |
否 |
获取实例列表的开始日期,格式为 yyyy-MM-dd HH:mm:ss。 |
2020-02-02 00:00:00 |
| EndBizdate |
string |
否 |
获取实例列表的结束日期,格式为 yyyy-MM-dd HH:mm:ss。 |
2020-02-03 00:00:00 |
| Status |
string |
否 |
任务的状态,取值如下:
|
NOT_RUN |
| OrderBy |
string |
否 |
返回值的排序规则。取值如下:
枚举值:
|
INSTANCE_ID_DESC |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回结果。 |
||
| HttpStatusCode |
integer |
HTTP 状态码。 |
200 |
| RequestId |
string |
请求的 ID。用于定位日志,排查问题。 |
E6F0DBDD-5AD**** |
| ErrorMessage |
string |
错误信息。 |
The project does not exist. |
| ErrorCode |
string |
错误码。 |
Invalid.Tenant.ProjectNotExists |
| Success |
boolean |
调用是否成功。取值如下:
|
true |
| Data |
object |
实例的列表。 |
|
| PageNumber |
integer |
页码数。 |
1 |
| PageSize |
integer |
每页显示的条数,默认为 10 条,最大为 100 条。 |
10 |
| TotalCount |
integer |
实例的总数。 |
66 |
| Instances |
array<object> |
实例的信息。 |
|
|
object |
返回数据。 |
||
| Status |
string |
任务的状态,取值如下:
|
NOT_RUN |
| CycTime |
integer |
调度任务的运行时间。 格式示例为 13 位数字,例如 |
1590422400000 |
| BeginRunningTime |
integer |
实例开始运行的时间。 格式示例为 13 位数字,例如 |
1590416703313 |
| FinishTime |
integer |
调度任务的结束时间。 格式示例为 13 位数字,例如 |
1590416703313 |
| ErrorMessage |
string |
实例运行的报错信息。 该字段已废弃,您可以调用 GetInstanceLog 接口获取执行任务的相关报错信息。 |
error message |
| CreateTime |
integer |
实例的创建时间。 格式示例为 13 位数字,例如 |
1590416703313 |
| DagId |
integer |
工作流的 ID。 |
33845 |
| Priority |
integer |
实例运行优先级,取值分为 1、3、5、7 和 8。 取值越大,优先级越高。默认优先级为 1。 |
1 |
| TaskType |
string |
任务实例的调度类型,取值如下:
|
NORMAL(0) |
| ParamValues |
string |
参数的信息。 |
bizdate=$bizdate tbods=$tbods |
| Connection |
string |
连接串。 |
odps_source |
| BaselineId |
integer |
基线 ID。 |
123123 |
| DqcType |
integer |
DQC 类型,取值如下:
|
1 |
| DagType |
string |
工作流的类型,取值如下:
|
DAILY |
| BusinessId |
integer |
业务流程 ID |
123 |
| TaskRerunTime |
integer |
实例还可以运行的次数。取值可以为空、以及大于等于 0 的整数。
|
0 |
| ModifyTime |
integer |
调度任务的最新修改时间。 格式示例为 13 位数字,例如 |
1590416703313 |
| Repeatability |
boolean |
实例任务是否可以重复执行。 |
true |
| RepeatInterval |
integer |
调度任务运行出错后,重新调整调度频率,单位为毫秒(ms)。 |
60000 |
| InstanceId |
integer |
实例的 ID。 |
1234 |
| BeginWaitResTime |
integer |
实例任务开始等待资源的时间。 格式示例为 13 位数字,例如 |
1590416703313 |
| RelatedFlowId |
integer |
关联的业务流程 ID。 |
123456 |
| Bizdate |
integer |
执行调度任务的日期。通常为该任务运行时间的前一天。 格式示例为 13 位数字,例如 |
1590336000000 |
| NodeName |
string |
节点的名称。 |
kzh |
| BeginWaitTimeTime |
integer |
实例任务开始等待调度的时间。 格式示例为 13 位数字,例如 |
1590416703313 |
| DqcDescription |
string |
DQC 分区规则串。 |
[{"projectName":"ztjy_dim","tableName":"dim_user_agent_manage_area_a","partition":"ds\u003d$[yyyy-mm-dd-1]"}] |
| NodeId |
integer |
节点的 ID。 |
33115 |
| CreateUser |
string |
触发实例运行的用户。例如,用户 Test 触发补数据实例运行,则 CreateUser 为 Test。 |
Test |
示例
正常返回示例
JSON格式
{
"HttpStatusCode": 200,
"RequestId": "E6F0DBDD-5AD****",
"ErrorMessage": "The project does not exist.",
"ErrorCode": "Invalid.Tenant.ProjectNotExists",
"Success": true,
"Data": {
"PageNumber": 1,
"PageSize": 10,
"TotalCount": 66,
"Instances": [
{
"Status": "NOT_RUN",
"CycTime": 1590422400000,
"BeginRunningTime": 1590416703313,
"FinishTime": 1590416703313,
"ErrorMessage": "error message",
"CreateTime": 1590416703313,
"DagId": 33845,
"Priority": 1,
"TaskType": "NORMAL(0)",
"ParamValues": "bizdate=$bizdate tbods=$tbods",
"Connection": "odps_source",
"BaselineId": 123123,
"DqcType": 1,
"DagType": "DAILY",
"BusinessId": 123,
"TaskRerunTime": 0,
"ModifyTime": 1590416703313,
"Repeatability": true,
"RepeatInterval": 60000,
"InstanceId": 1234,
"BeginWaitResTime": 1590416703313,
"RelatedFlowId": 123456,
"Bizdate": 1590336000000,
"NodeName": "kzh",
"BeginWaitTimeTime": 1590416703313,
"DqcDescription": "[{\"projectName\":\"ztjy_dim\",\"tableName\":\"dim_user_agent_manage_area_a\",\"partition\":\"ds\\u003d$[yyyy-mm-dd-1]\"}]",
"NodeId": 33115,
"CreateUser": "Test"
}
]
}
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。