
# 查询训练作业日志
#### 功能介绍
按行来查询训练作业日志详细信息。
#### URI
GET /v1/{project_id}/training-jobs/{job_id}/versions/{version_id}/aom-log
参数说明如[表1]所示。
 表1路径参数 
| 参数         | 是否必选 | 参数类型   | 说明                                                                                               |
|:---|:---|:---|:---|
| project_id | 是    | String | 用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 |
| job_id     | 是    | Long   | 训练作业的ID。                                                                                         |
| version_id | 是    | Long   | 训练作业的版本ID。                                                                                       |
   
表2Query参数 
| 参数        | 是否必选 | 参数类型    | 说明                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| base_line | 否    | String  | 日志的基准位置，根据接口返回获得，为空的时候代表获取最新的日志。                                                                                                                                                                                                                                                                                         |
| lines     | 否    | Integer | 获取日志的长度，默认为50行。lines的范围为\[0, 500\]。                                                                                                                                                                                                                                                                                      |
| log_file  | 是    | String  | 需要查看的日志文件名称，获取方式请参见[获取训练作业日志的文件名](https://support.huaweicloud.com/api-modelarts/modelarts_03_0054.html)。                                                                                                                                                                                                                 |
| order     | 否    | String  | 日志查询的方向。 - desc：向下查询。  - asc：向上查询。   |
   
#### 请求消息
无。
#### 响应消息
响应参数如[表3]所示。
 表3响应参数 
| 参数            | 参数类型    | 说明                                                                                                                                                    |
|:---|:---|:---|
| error_message | String  | 调用失败时的错误信息。 调用成功时无此字段。                                                                                  |
| error_code    | String  | 调用失败时的错误码，具体请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。 调用成功时无此字段。 |
| content       | String  | 请求获得日志的内容。                                                                                                                                            |
| lines         | Integer | 获得日志的行数。                                                                                                                                              |
| start_line    | String  | 该段日志内容的开始位置。                                                                                                                                          |
| end_line      | String  | 该段日志内容的结束位置。                                                                                                                                          |
| is_success    | Boolean | 请求是否成功。                                                                                                                                               |
   
#### 请求示例
如下以查询"job_id"为10，"version_id"为10，文件名为"log1.log"的日志为例。
```
GET    https://endpoint/v1/{project_id}/training-jobs/10/versions/10/aom-log?log_file=log1.log&base_line= 1551252759254000002&lines=50&order=desc
```
#### 响应示例
- 成功响应示例
  ```
  {
      "is_success": true,
      "start_line":1551252759254000002,
      "content": "Log string",
      "end_line": "1551252759254000003",
      "lines": "1"
  }
  ```
  
- 失败响应示例
  ```
  {
      "is_success": false,
      "error_message": "Error string",
      "error_code": "ModelArts.0105"
  }
  ```
  
 
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0094.html)。
