# 审计日志（操作日志）- QueryAuditLogs
#### 功能
查询审计日志列表。
| **SLA项**   | **定义**  |
|:---|:---|
| 请求成功率      | ≥99%    |
| 可用性        | Tier 2  |
| 数据一致性      | 强一致     |
| 吞吐量        | 60 次/分钟 |
| TP50请求时延   | 200 ms  |
| TP99.9请求时延 | 300 ms  |
   
#### 注意事项
无
#### 调用方法
GET
#### URI
/rest/dataapi/homs/open-api/v1/cloudAuditlog
**路径参数**
无
**查询参数**
| **参数**       | **是否必选** | **类型** | **值域**  | **描述**              |
|:---|:---|:---|:---|:---|
| log_type     | 否        | string | 无       | 日志类型，0：操作日志，1：安全日志。 |
| begin_time   | 是        | long   | 毫秒时间戳   | 开始时间。               |
| end_time     | 是        | long   | 毫秒时间戳   | 结束时间。               |
| page_size    | 是        | int    | 0\~1000 | 页大小。                |
| offset_value | 是        | int    | 无       | 查询起始值。              |
   
#### 请求
- **请求header参数**
  
  | **参数**          | **是否必选**                                                                    | **类型** | **值域** | **说明**              |
  |:---|:---|:---|:---|:---|
  | X-APIG-Appcode  | 是                                                                           | string | 无      | 由SRE分配的AppCode。     |
  | x-auth-token    | 是                                                                           | string | 无      | 调用方APIG的IAM认证token。 |
  | x-hcso-domainid | 是（HCSO场景） 否（其他场景） | string | 无      | 接入的租户ID。            |
  | x-hcso-appcode  | 是                                                                           | string | 无      | 由SRE分配的AppCode      |
     
  

- **请求body参数**
  无
  
- **请求示例**
  ```
  GET /rest/dataapi/homs/open-api/v1/cloudAuditlog HTTP/1.1 
  Host: example.com
  Content-Type: application/json 
  Accept: application/json
  X-APIG-Appcode: xxx 
  x-auth-token: xxx 
  x-hcso-domainid：xxx 
  x-hcso-appcode：xxx
  ```
  
 
#### 响应
- **响应参数**
  - 响应状态码200：返回Data对象。Data对象包含如下属性：
    
    | **参数** | **是否必选** | **类型**       | **值域** | **说明** |
    |:---|:---|:---|:---|:---|
    | total  | 是        | int32        | 无      | 数据总数量。 |
    | list   | 是        | List\<Item\> | 无      | 流程对象。  |
       
    Item对象包含如下属性：
    
    | **参数**               | **是否必选** | **类型** | **值域** | **说明**                    |
    |:---|:---|:---|:---|:---|
    | id                   | 是        | string | 无      | 日志ID。                     |
    | operating_name       | 是        | string | 无      | 操作名称。                     |
    | operating_source     | 是        | int32  | 无      | 操作源。                      |
    | operation_result     | 是        | string | 无      | 操作结果：0-成功，1-失败。           |
    | operation_detail     | 是        | string | 无      | 操作详情。                     |
    | resource_name        | 是        | string | 无      | 资源名称。                     |
    | resource_type        | 是        | string | 无      | 资源类型。                     |
    | operating_user       | 是        | string | 无      | 操作人员。                     |
    | department           | 是        | string | 无      | 部门。                       |
    | severity             | 是        | string | 无      | 风险等级：4-致命，3-重要，2-一般，1-提示。 |
    | type                 | 是        | string | 无      | 日志类型：0-操作日志，1-安全日志。       |
    | start_time           | 是        | string | 无      | 开始时间。                     |
    | end_time             | 是        | string | 无      | 结束时间。                     |
    | resource_id          | 是        | string | 无      | 资源ID。                     |
    | resource_region      | 是        | String | 无      | 资源区域。                     |
    | source_addr          | 是        | String | 无      | 资源IP。                     |
    | region_id            | 是        | String | 无      | 区域ID。                     |
    | region_name          | 是        | String | 无      | 区域名称。                     |
    | resource_region_name | 是        | String | 无      | 资源区域名称。                   |
       
    
   

- **响应示例**
  ```
  HTTP/1.1 200 OK 
  Date:Tue,18 Jul 2023 09:58:01 GMT
  Server: example.com
  Content-Type: application/json;charset=UTF8 
  { 
      "total": 33, 
      "list": [ 
               { 
               "id": "2030", 
               "operating_name": "addScheduleSchedule", 
               "operating_source": "操作源", 
               "operation_result": "0-成功 1-失败", 
               "operation_detail": "操作详情", 
               "resource_name": "CloudCapacity", 
               "resource_type": "schedule", 
               "operating_user": "capacityApi", 
               "department": "部门", 
               "severity": "风险等级 4-致命，3-重要，2-一般，1-提示'", 
               "type": "日志类型,0-操作日志，1-安全日志'", 
               "start_time": "2020-11-01 01:13:59", 
               "end_time": "2020-11-01 01:13:59", 
               "resource_id": "资源Id", 
               "resource_region": "资源regionName:cn-north-1", 
               "source_addr": "资源IP-取表字段regionIp：10.0.25.204", 
               "region_id": "cn-north-1", 
               "region_name": "xx-region", 
               "resource_region_name": "xx-region" 
                } 
              ] 
  }
  ```
  
 
#### 状态码
| **状态码** | **说明**     |
|:---|:---|
| 200     | 操作成功。      |
| 400     | 参数错误。      |
| 401     | token鉴权失败。 |
| 403     | 鉴权失败。      |
| 404     | rest接口未找到。 |
   
#### 操作危险级别
Minor