# 查看OBS审计日志列表 - CreateListEvents
#### 功能介绍
功能介绍：查看OBS审计日志列表
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-dsc/dsc_02_0008.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dsc/dsc_02_0031.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
POST /v1/{project_id}/sdg/exception/list-events
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释：** 项目ID。可参考获取项目ID获取。 **约束限制：** 不涉及 **取值范围：** 以IAM服务接口返回值为准，字符长度32-32。 **默认取值：** 不涉及 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。通过调用IAM服务查询用户Token接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 不涉及 **取值范围：** IAM服务查询用户Token接口为准 **默认取值：** 不涉及 |
   
表3请求Body参数 
| 参数         | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| status     | 否    | String  | **参数解释：** 操作结果状态 **约束限制：** 不涉及 **取值范围：** - NEED-待处理   - CONFIRM-确认   - MIS-误判   - EXCLUDE-排除    **默认取值：** 不涉及                                                                                                                                                                                                   |
| type       | 否    | String  | **参数解释：** 事件类型 **约束限制：** 不涉及 **取值范围：** - ACCESS-访问异常   - UBE-UBE异常   - OPERATE-操作异常   - OPERATION-运维操作异常   - MANAGEMENT-管理异常    **默认取值：** 不涉及 |
| start_time | 否    | Long    | **参数解释：** 开始时间 **约束限制：** 最大值2147483647 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| end_time   | 否    | Long    | **参数解释：** 结束时间 **约束限制：** 最大值2147483647 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| offset     | 否    | Integer | **参数解释：** 分页偏移 **约束限制：** 最大值2147483647 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| limit      | 否    | Integer | **参数解释：** 每页数量限制 **约束限制：** 最大值2147483647 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数         | 参数类型                                                                                  | 描述                                                                                                                                         |
|:---|:---|:---|
| total      | Integer                                                                               | **参数解释：** 总记录数 **取值范围：** 不涉及   |
| exceptions | Array of [ExceptionEventInfo] objects | **参数解释：** 异常事件列表 **取值范围：** 不涉及 |
   
 表5ExceptionEventInfo 
| 参数           | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|
| id           | String  | **参数解释：** 资源ID，唯一标识 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| requester_id | String  | **参数解释：** 请求者ID **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| owner_id     | String  | **参数解释：** 拥有者ID **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| type         | String  | **参数解释：** 事件类型 **取值范围：** - ACCESS-访问异常   - UBE-UBE异常   - OPERATE-操作异常   - OPERATION-运维操作异常   - MANAGEMENT-管理异常    |
| status       | String  | **参数解释：** 操作结果状态 **取值范围：** - NEED-待处理   - CONFIRM-确认   - MIS-误判   - EXCLUDE-排除                                                                                                                                                                                                      |
| event_name   | String  | **参数解释：** 事件名称 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| alarm_time   | Long    | **参数解释：** 告警时间 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| confirmed    | Boolean | **参数解释：** 是否已确认 **取值范围：** true-是，false-否                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| expired      | Boolean | **参数解释：** 是否过期 **取值范围：** true-是，false-否                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   
#### 请求示例
查询OBS审计异常事件列表
```
{
  "status" : "NEED",
  "type" : "UBE",
  "start_time" : 1787306400000,
  "end_time" : 1787313600000,
  "offset" : 0,
  "limit" : 10
}
```
#### 响应示例
**状态码：200**
```
{
  "total" : 2,
  "exceptions" : [ {
    "id" : "0b02392f3d0042bd8f80376485d9b7d8",
    "requester_id" : "a1b2c3d4e5f6478980abcdef01234567",
    "owner_id" : "c3d4e5f6a7b8490a9bcd1234567890ab",
    "type" : "UBE",
    "status" : "NEED",
    "event_name" : "未授权敏感数据访问",
    "alarm_time" : 1787306400000,
    "confirmed" : false,
    "expired" : false
  }, {
    "id" : "1c134a3f4e0153ce9f90487596e0c8e9",
    "requester_id" : "b2c3d4e5f6a7489909cdef012345678a",
    "owner_id" : "d4e5f6a7b8c940a1bcde234567890abc",
    "type" : "UBE",
    "status" : "NEED",
    "event_name" : "异常批量数据下载",
    "alarm_time" : 1787307000000,
    "confirmed" : false,
    "expired" : false
  } ]
}
```
#### 状态码
| 状态码 | 描述    |
|:---|:---|
| 200 | 请求已成功 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dsc/ErrorCode.html)。
