文档首页/ 云运维中心 COC/ API参考/ API/ 故障管理/ 事件管理/ 事件操作历史列表 - ListIncidentsHistories
更新时间：2025-10-23 GMT+08:00
查看PDF
分享

事件操作历史列表 - ListIncidentsHistories

功能介绍

查询事件操作历史列表。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    coc:ticket:getOperationHistories

    List

    -

    -

    -

    -

URI

POST /v2/incidents/{incident_id}/histories

表1 请求path参数列表

名称

类型

是否必选

描述

incident_id

String

是

参数解释：

事件单号。

约束限制：

字符串

取值范围：

字符长度1-50

默认取值：

不涉及

请求参数

表2 请求Body参数：

名称

类型

是否必选

描述

count_filters

Array of 表3 CountFilterV2参数：

否

参数解释：

统计工单数量过滤器。

约束限制：

数组长度：0 - 10

取值范围：

不涉及

默认取值：

不涉及

fields

Array of String

否

参数解释：

指定接口返回的字段。

约束限制：

数组长度：0 - 100

取值范围：

不涉及

默认取值：

不涉及

group_by_filter

表4 ObjectFilterV2参数： object

否

参数解释：

分组过滤器。

约束限制：

数组长度：0 - 20

取值范围：

不涉及

默认取值：

不涉及

int_filters

Array of 表4 ObjectFilterV2参数：

否

参数解释：

整形过滤器。

约束限制：

数组长度：0 - 20

取值范围：

不涉及

默认取值：

不涉及

string_filters

Array of 表4 ObjectFilterV2参数：

否

参数解释：

条件过滤器。

约束限制：

数组长度：0 - 20

取值范围：

不涉及

默认取值：

不涉及

sort_filter

表4 ObjectFilterV2参数： object

否

参数解释：

排序过滤器。

约束限制：

数组长度：0 - 10

取值范围：

不涉及

默认取值：

不涉及

condition

String

否

参数解释：

表达式，对复杂表达式进行组装，可以用英文括号()、与&、或|。

示例：( filterName1 & filterName2) | filterName3。

filterName*：取自string_filters ObjectFilter.name。

如果为空，string_filters中的条件默认是与的关系

约束限制：

字符串

取值范围：

1-10000

默认取值：

不涉及
表3 CountFilterV2参数：

名称

类型

是否必选

描述

name

String

否

参数解释：

过滤器名称，用于condition表达式拼接。

约束限制：

字符串

取值范围：

0-255

默认取值：

不涉及

filters

Array of 表4 ObjectFilterV2参数：

否

参数解释：

统计数量过滤器。

约束限制：

数组长度：0 - 10

取值范围：

不涉及

默认取值：

不涉及
表4 ObjectFilterV2参数：

名称

类型

是否必选

描述

name

String

否

参数解释：

过滤器名称，用于condition表达式拼接。

约束限制：

字符串

取值范围：

0-255

默认取值：

不涉及

field

String

是

参数解释：

字段KEY，取值参考表4 ListIncidentsResponseBodyData参数列表。

约束限制：

字符串

取值范围：

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

表4 CocListHistoryResponseDataV2参数列表 object

否

参数解释：

接口响应的具体信息。

取值范围：

不涉及

默认取值：

不涉及
表6 CocListHistoryResponseDataV2参数列表

名称

类型

是否必选

描述

total

Long

否

参数解释：

该接口返回的事件单操作记录总条数。

取值范围：

1-9999999999999

默认取值：

不涉及

info

Arrays of 表5 CocTicketHistoryBaseInfo参数列表

否

参数解释：

历史信息列表。

取值范围：

数组长度：0 - 1024

默认取值：

不涉及
表7 CocTicketHistoryBaseInfo参数列表

名称

类型

是否必选

描述

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 表6 TicketInfoEnumData参数列表

否

参数解释：

枚举列表。

取值范围：

数组长度：0 - 1024

默认取值：

不涉及
表8 TicketInfoEnumData参数列表

名称

类型

是否必选

描述

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

请求成功。

更多状态码请参考状态码。

{
    "provider_code": "049",
    "error_code": "GOM.00000000",
    "error_msg": null,
    "data": {
        "total": 3,
        "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_id": "main",
                "comment": "Create project f****elling. ",
                "start_time": 1744252838982,
                "stop_time": 1744285427529,
                "action_name_zh": "响应预案自动执行失败",
                "action_name_en": "响应预案自动执行失败",
                "status": "INCIDENT_STATUS_TRIGGERED",
                "enum_data_list": [

                ]
            },
            {
                "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

服务器未能处理请求。

更多状态码请参考状态码。

{
  "error_code" : "GOM.00007256",
  "error_msg" : "参数错误",
  "provider_code" : "049",
  "data" : null
}

状态码

状态码

描述

200

请求成功。

更多状态码请参考状态码。

400

服务器未能处理请求。

更多状态码请参考状态码。

错误码

请参见错误码。

父主题： 事件管理