# 查询指定作业的实例列表 - ListFactoryJobInstancesByName #### 功能介绍 根据作业名称精确查询作业实例列表。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/DataArtsStudio/doc?api=ListFactoryJobInstancesByName)中调试该接口，支持自动认证鉴权。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dataartsstudio/abcd.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI - URI格式 GET /v2/{project_id}/factory/jobs/{job_name}/instances/detail - 参数说明 表1URI参数说明 | 参数名 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | project_id | 是 | String | 项目编号，获取方法请参见[项目ID和账号ID](https://support.huaweicloud.com/api-dataartsstudio/projectid_accountid.html)。 | | job_name | 是 | String | 作业名称。 - 如果要查询指定批处理作业的实例列表，job_name就是批处理作业名称。 - 如果要查询实时作业下某个节点关联的子作业，job_name格式为\[实时作业名称\]_\[节点名称\]。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | min_plan_time | 否 | Long | 返回作业实例开始时间大于min_plan_time的作业实例，单位为毫秒ms，默认设置为查询当天0点，最大可支持查询一个月。 | | max_plan_time | 否 | Long | 返回作业实例开始时间小于max_plan_time的作业实例，单位为毫秒ms，默认设置为当前时间。 | | limit | 否 | int | 分页返回结果，指定每页最大记录数。 范围\[1,1000\] 默认值：10 | | offset | 否 | int | 分页的起始页，默认值为0。取值范围大于等于0。 | | status | 否 | String | 实例运行状态： - waiting：等待运行 - running：运行中 - success：运行成功 - fail：运行失败 - running-exception：运行异常 - skip-by-depend：跳过 - freeze：冻结 - pause：暂停 - manual-stop：取消 默认查全部 | | instance_type | 否 | int | 作业调度方式： - 0：正常调度 - 2：手工调度 - 5：补数据 - 6：子作业调度 - 7：单次调度 默认查全部 | | force_success | 否 | boolean | status为success的时候使用，true则筛选出强制成功的作业实例。 默认值：false | | ignore_success | 否 | boolean | status为success的时候使用，true则筛选出忽略失败的作业实例。 默认值：false | #### 请求参数 表3请求Header参数 | 参数名 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | workspace | 否 | String | 工作空间id。获取方法请参见[实例ID和工作空间ID](https://support.huaweicloud.com/api-dataartsstudio/dataartsstudio_02_0350.html)。 - 如果不设置该参数，默认查询default工作空间下的数据。 - 如果需要查询其他工作空间的数据，需要带上该消息头。 说明： - 多个DataArts Studio实例需要指定工作空间。 - 当工作空间里面没有default工作空间时，工作空间为必填参数，否则会报错。 | #### 响应参数 表4参数说明 | 参数名 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | total | 是 | Long | 总记录数 | | instances | 是 | List\ | 作业实例状态，参考[表5]。 | 表5Instance属性说明 | 参数名 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | job_name | 是 | String | 作业名称。如果要查询指定批处理作业的实例列表，job_name就是批处理作业名称；如果要查询实时作业下某个节点关联的子作业，job_name格式为\[实时作业名称\]_\[节点名称\]。 | | job_id | 否 | Long | 作业id。 | | job_instance_name | 是 | String | 作业实例运行时日志记录的实例名称，非作业定义的名称。 | | status | 是 | String | 状态： - waiting：等待运行 - running：运行中 - success：运行成功 - fail：运行失败 - running-exception：运行异常 - skip-by-depend：跳过 - freeze：冻结 - pause：暂停 - manual-stop：取消 | | plan_time | 是 | Long | 作业实例计划执行时间 | | start_time | 是 | Long | 作业实例实际执行开始时间 | | end_time | 否 | Long | 作业实例实际执行结束时间 | | execute_time | 否 | Long | 执行耗时，单位：毫秒 | | instance_id | 是 | Long | 作业实例ID，用于查询作业实例详情。 | | submit_time | 是 | Long | 作业提交运行时间 | | instance_type | 是 | int | 作业调度方式： - 0：正常调度 - 2：手工调度 - 5：补数据 - 6：子作业调度 - 7：单次调度 | | force_success | 否 | boolean | 作业实例状态筛选为强制成功 默认值：false | | ignore_success | 否 | boolean | 作业实例状态筛选为忽略失败 默认值：false | | version | 否 | int | 作业实例版本。 | #### 请求示例 查询批处理作业job_batch的实例列表 ``` GET /v2/b384b9e9ab9b4ee8994c8633aabc9505/factory/jobs/job_batch/instances/detail ``` #### 响应示例 - 成功响应 HTTP状态码 200 ``` { "total": 2, "instances": [{ "end_time": 1551671598000, "execute_time": 300, "force_success": false, "ignore_success": false, "instance_id": 34765, "instance_type": 2, "job_id": 608627, "job_name": "job_batch", "job_instance_name": "job_batch", "plan_time": 1551671580000, "start_time": 1551671580000, "status": "success", "submit_time": 1550910278706, "version": 1 }, { "end_time": 1551671538000, "execute_time": 0.3, "force_success": false, "ignore_success": false, "instance_id": 34764, "instance_type": 5, "job_id": 608627, "job_name": "job_batch", "job_instance_name": "job_batch", "plan_time": 1551671520000, "start_time": 1551671521000, "status": "success", "submit_time": 1550910278706, "version": 1 }] } ``` - 失败响应 HTTP状态码 400 ``` { "error_code": "DLF.30100", "error_msg": "The job does not exists." } ```