
# 查询作业执行计划 - ShowFlinkJobExecutionGraph
#### 功能介绍
该API用于查询作业执行计划。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DLI&api=ShowFlinkJobExecutionGraph)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限及授权项说明](https://support.huaweicloud.com/api-dli/dli_02_0375.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项 Action | 访问级别 Access Level | 资源类型（\*为必须） Resource Type (\*: required) | 条件键 Condition Key                                                                                                                                                  | 别名 Alias | 依赖的授权项 Dependencies |
  |:---|:---|:---|:---|:---|:---|
  | dli:jobs:get                            | read                                            | jobs \*                                                                | - [g:ResourceTag/\<tag-key\>](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)   | -                                      | -                                                 |
     
  
 
#### URI
- URI格式 GET /v1.0/{project_id}/streaming/jobs/{job_id}/execute-graph
  
- 参数说明
  表1URI参数说明 
  | 参数名称       | 是否必选 | 参数类型   | 说明                                                                                     |
  |:---|:---|:---|:---|
  | project_id | 是    | String | 项目编号，用于资源隔离。获取方式请参考[获取项目ID](https://support.huaweicloud.com/api-dli/dli_02_0183.html)。 |
  | job_id     | 是    | Long   | 作业ID。                                                                                  |
     
  
 
#### 请求消息
无请求参数。
#### 响应消息
表2响应参数说明 
| 参数名称          | 是否必选 | 参数类型   | 说明                                                        |
|:---|:---|:---|:---|
| is_success    | 否    | String | 请求是否成功。                                                   |
| message       | 否    | String | 消息内容。                                                     |
| execute_graph | 否    | Object | 查询作业计划的响应参数。具体请参考[表3]。 |
   
 表3execute_graph参数说明 
| 参数名称        | 是否必选 | 参数类型    | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| jid         | 否    | String  | flink作业id。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| name        | 否    | String  | flink作业名字。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| isStoppable | 否    | Boolean | 是否可停止。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| state       | 否    | String  | 作业运行状态。 - INITIALIZING：作业初始化  - CREATED：已创建  - RUNNING：运行中  - FAILING：失败  - FAILED：已失败  - CANCELLING：取消中  - CANCELED：已取消  - FINISHED：已完成  - RESTARTING：重启中  - SUSPENDED：挂起  - RECONCILING：系统自检中   |
| start-time  | 否    | Long    | 作业启动时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| end-time    | 否    | Long    | 作业停止时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| duration    | 否    | Long    | 作业运行时长。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   
#### 请求示例
无
#### 响应示例
```
{
    "is_success": "true",
    "message": "查询作业执行流图成功",
    "execute_graph": {
        "jid": "4e966f43f2c90b0e1bf3188ecf55504b",
        "name": "",
        "isStoppable": false,
        "state": "RUNNING",
        "start-time": 1578904488436,
        "end-time": -1,
        "duration": 516274
    }
}
```
#### 状态码
表4状态码 
| 状态码 | 描述          |
|:---|:---|
| 200 | 查询作业执行计划成功。 |
| 400 | 输入参数无效。     |
   
#### 错误码
调用接口出错后，将不会返回上述结果，而是返回错误码和错误信息，更多介绍请参见[错误码](https://support.huaweicloud.com/api-dli/dli_02_0056.html)。
