# 获取事件单历史 - ListIncidentsHistories #### 功能介绍 查询事件操作历史列表。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/COC/doc?api=ListIncidentsHistories)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-coc/coc_api_06.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | coc:ticket:getOperationHistories | List | - | - | - | - | #### URI POST /v2/incidents/{incident_id}/histories 表1请求path参数列表 | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | incident_id | String | 是 | **参数解释：** 事件单号。 **约束限制：** 字符串 **取值范围：** 字符长度1-50 **默认取值：** 不涉及 | #### 请求参数 表2请求Body参数： | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | count_filters | Array of [CountFilterV2] | 否 | **参数解释：** 统计工单数量过滤器。 **约束限制：** 数组长度：**0 - 10** **取值范围：** 不涉及 **默认取值：** 不涉及 | | fields | Array of String | 否 | **参数解释：** 指定接口返回的字段。 **约束限制：** 数组长度：**0 - 100** **取值范围：** 不涉及 **默认取值：** 不涉及 | | group_by_filter | [ObjectFilterV2] object | 否 | **参数解释：** 分组过滤器。 **约束限制：** 数组长度：**0 - 20** **取值范围：** 不涉及 **默认取值：** 不涉及 | | int_filters | Array of [ObjectFilterV2] | 否 | **参数解释：** 整形过滤器。 **约束限制：** 数组长度：**0 - 20** **取值范围：** 不涉及 **默认取值：** 不涉及 | | string_filters | Array of [ObjectFilterV2] | 否 | **参数解释：** 条件过滤器。 **约束限制：** 数组长度：**0 - 20** **取值范围：** 不涉及 **默认取值：** 不涉及 | | sort_filter | [ObjectFilterV2] object | 否 | **参数解释：** 排序过滤器。 **约束限制：** 数组长度：**0 - 10** **取值范围：** 不涉及 **默认取值：** 不涉及 | | condition | String | 否 | **参数解释：** 表达式，对复杂表达式进行组装，可以用英文括号()、与\&、或\|。 示例：( filterName1 \& filterName2) \| filterName3。 filterName\*：取自string_filters ObjectFilter.name。 如果为空，string_filters中的条件默认是与的关系 **约束限制：** 字符串 **取值范围：** 1-10000 **默认取值：** 不涉及 | 表3CountFilterV2参数： | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | name | String | 否 | **参数解释：** 过滤器名称，用于condition表达式拼接。 **约束限制：** 字符串 **取值范围：** 0-255 **默认取值：** 不涉及 | | filters | Array of [ObjectFilterV2] | 否 | **参数解释：** 统计数量过滤器。 **约束限制：** 数组长度：**0 - 10** **取值范围：** 不涉及 **默认取值：** 不涉及 | 表4ObjectFilterV2参数： | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | name | String | 否 | **参数解释：** 过滤器名称，用于condition表达式拼接。 **约束限制：** 字符串 **取值范围：** 0-255 **默认取值：** 不涉及 | | field | String | 是 | **参数解释：** 字段KEY，取值参考[表4 ListIncidentsResponseBodyData参数列表](https://support.huaweicloud.com/api-coc/ListIncidents.html#ListIncidents__zh-cn_topic_0000002254566672_table904mcpsimp)。 **约束限制：** 字符串 **取值范围：** 0-255 **默认取值：** 不涉及 | | operator | String | 是 | **参数解释：** 操作符，取值：in/like/startwith/endwith/=/!=/\>/\<。 **约束限制：** 字符串 **取值范围：** 0-20 **默认取值：** 不涉及 | | values | Arrays of String | 是 | **参数解释：** 需要过滤的值，值的内容支持String，时间戳，枚举，整形，全部以字符串的形式进行传递。 **约束限制：** 数组长度：1 - 1024 元素字符长度： 最小长度：0 最大长度： 1024 **取值范围：** 不涉及 **默认取值：** 不涉及 | | group | String | 否 | **参数解释：** 分组查询信息。 **约束限制：** 字符串 **取值范围：** 0-255 **默认取值：** 不涉及 | | match_type | String | 否 | **参数解释：** 匹配方式。 **约束限制：** 字符串 **取值范围：** 0-255 **默认取值：** 不涉及 | | priority_type | String | 否 | **参数解释：** 优先级处理方式。 **约束限制：** 字符串 **取值范围：** 0-255 **默认取值：** 不涉及 | #### 响应参数 **状态码：200** 表5响应Body参数列表 | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | provider_code | String | 否 | **参数解释：** 服务标识，当前为固定值049。 **取值范围：** 字符长度0-256 **默认取值：** 049 | | error_code | String | 否 | **参数解释：** 请求响应代码，范围：0000\~9999，正常时取值：0。 **取值范围：** 字符长度0-256 **默认取值：** 0 | | error_msg | String | 否 | **参数解释：** 请求响应描述。 **取值范围：** 字符长度0-256 **默认取值：** 不涉及 | | data | [CocListHistoryResponseDataV2] object | 否 | **参数解释：** 接口响应的具体信息。 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表6CocListHistoryResponseDataV2参数列表 | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | total | Long | 否 | **参数解释：** 该接口返回的事件单操作记录总条数。 **取值范围：** 1-9999999999999 **默认取值：** 不涉及 | | info | Arrays of [CocTicketHistoryBaseInfo] | 否 | **参数解释：** 历史信息列表。 **取值范围：** 数组长度：0 - 1024 **默认取值：** 不涉及 | 表7CocTicketHistoryBaseInfo参数列表 | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | action | String | 否 | **参数解释：** Action操作类型。 **取值范围：** 字符长度0-255 **默认取值：** 不涉及 | | action_name_zh | String | 否 | **参数解释：** Action中文名称。 **取值范围：** 字符长度0-255 **默认取值：** 不涉及 | | action_name_en | String | 否 | **参数解释：** Action英文名称。 **取值范围：** 字符长度0-255 **默认取值：** 不涉及 | | operator | String | 否 | **参数解释：** 操作人ID。 **取值范围：** 字符长度0-255 **默认取值：** 不涉及 | | status | String | 否 | **参数解释：** 当前状态。 **取值范围：** 字符长度0-255 **默认取值：** 不涉及 | | start_time | String | 否 | **参数解释：** 操作开始时间。 **取值范围：** 字符长度0-100 **默认取值：** 不涉及 | | stop_time | String | 否 | **参数解释：** 操作结束时间。 **取值范围：** 字符长度0-100 **默认取值：** 不涉及 | | comment | String | 否 | **参数解释：** 备注信息。 **取值范围：** 字符长度0-255 **默认取值：** 不涉及 | | enum_data_list | Arrays of [TicketInfoEnumData] | 否 | **参数解释：** 枚举列表。 **取值范围：** 数组长度：0 - 1024 **默认取值：** 不涉及 | 表8TicketInfoEnumData参数列表 | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | prop_id | String | 否 | **参数解释：** 字段KEY，标识哪个字段。 **取值范围：** 字符长度0-255 **默认取值：** 不涉及 | | biz_id | String | 否 | **参数解释：** 枚举KEY。 **取值范围：** 字符长度0-255 **默认取值：** 不涉及 | | name_zh | String | 否 | **参数解释：** 中文名称。 **取值范围：** 字符长度0-255 **默认取值：** 不涉及 | | name_en | String | 否 | **参数解释：** 英文名称。 **取值范围：** 字符长度0-255 **默认取值：** 不涉及 | #### 请求示例 获取事件操作历史列表。 ``` POST https://{Endpoint}/v2/incidents/{incident_id}/histories { "sort_filter": { "operator": "desc", "field": "start_time", "name": "start_time", "values": [ "start_time" ] } } ``` #### 响应示例 **状态码：200** 请求成功。 更多状态码请参考[状态码](https://support.huaweicloud.com/api-coc/coc_api_05_03.html)。 ``` { "provider_code": "049", "error_code": "GOM.00000000", "error_msg": null, "data": { "total": 2, "info": [ { "action": "incident_accept", "operator": "653989085ba7487184d7cf219b8aa51e", "start_time": 1744285427529, "action_name_zh": "受理事件", "action_name_en": "Handling an incident", "status": "INCIDENT_STATUS_ACKNOWLEDGED", "enum_data_list": [ { "name_zh": "COC-Script", "name_en": "COC-Script", "biz_id": "653989085ba7487184d7cf219b8aa51e", "prop_id": "operator" } ] }, { "action": "create_incident", "start_time": 1744252838667, "stop_time": 1744252838982, "action_name_zh": "创建事件单", "action_name_en": "create incident", "status": "INCIDENT_STATUS_TRIGGERED", "enum_data_list": [ ] } ] } } ``` **状态码：400** 服务器未能处理请求。 更多状态码请参考[状态码](https://support.huaweicloud.com/api-coc/coc_api_05_03.html)。 ``` { "error_code" : "GOM.00007256", "error_msg" : "参数错误", "provider_code" : "049", "data" : null } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 请求成功。 更多状态码请参考[状态码](https://support.huaweicloud.com/api-coc/coc_api_05_03.html)。 | | 400 | 服务器未能处理请求。 更多状态码请参考[状态码](https://support.huaweicloud.com/api-coc/coc_api_05_03.html)。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-coc/ErrorCode.html)。