更新时间:2025-07-04 GMT+08:00
分享

获取事件任务

功能介绍

获取事件任务。

调用操作前进行调用。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v2/incidents/{incident_id}/tasks

表1 请求path参数列表

名称

类型

是否必选

描述

incident_id

String

参数解释:

事件单号。

约束限制:

字符串

取值范围:

字符长度1-50

默认取值:

不涉及

响应参数

状态码:200

表2 响应Body参数列表

名称

类型

是否必选

描述

ResponseBodyTemplate(allOf)

表3

参数解释:

通用返回体,用于文档生成。

取值范围:

不涉及

默认取值:

不涉及

data

Arrays of CocIncidentTaskDetail

参数解释:

结果列表。

取值范围:

数组长度0-1000

默认取值:

不涉及

表3 ResponseBodyTemplate(allOf)

名称

类型

是否必选

描述

provider_code

String

参数解释:

服务标识。

取值范围:

字符长度0-256

默认取值:

049

error_code

String

参数解释:

请求响应代码,范围:0000~9999,正常时取值:0。

取值范围:

字符长度0-256

默认取值:

0

error_msg

String

参数解释:

请求响应描述。

取值范围:

字符长度0-256

默认取值:

不涉及

表4 CocIncidentTaskDetail

名称

类型

是否必选

描述

type

String

参数解释:

节点类型。

取值范围:

字符长度0-10

默认取值:

0

key

String

参数解释:

节点KEY。

取值范围:

字符长度0-255

默认取值:

不涉及

state

String

参数解释:

状态,running运行中,suspend挂起中。

取值范围:

字符长度0-255

默认取值:

不涉及

operations

Arrays of CocIncidentOperateDetail

参数解释:

操作列表。

取值范围:

数组长度:0 - 1024

默认取值:

不涉及

表5 CocIncidentOperateDetail

名称

类型

是否必选

描述

task_id

String

参数解释:

任务ID,后续执行操作的时候需要。

取值范围:

字符长度0-255

默认取值:

不涉及

key

String

参数解释:

操作Key,后续执行操作的时候需要。

取值范围:

字符长度0-255

默认取值:

不涉及

name_en

String

参数解释:

英文名称。

取值范围:

字符长度0-255

默认取值:

不涉及

name_cn

String

参数解释:

中文名称。

取值范围:

字符长度0-255

默认取值:

不涉及

请求示例

获取事件单支持的任务。

GET https://{Endpoint}/v2/incidents/{incident_id}/tasks

响应示例

状态码:200

请求成功。

更多状态码请参考状态码

{
    "provider_code": "049",
    "error_code": "GOM.00000000",
    "error_msg": null,
    "data": [
        {
            "type": "OperateNode",
            "key": "userTaskHandle1",
            "name": "处理",
            "state": "running",
            "operations": [
                {
                    "task_id": "19102976566880092186683",
                    "key": "commitSolution1",
                    "name_en": "commitSolution1",
                    "name_cn": "提交解决方案"
                },
                {
                    "task_id": "19102976566880092186683",
                    "key": "forwardOther1",
                    "name_en": "forwardOther1",
                    "name_cn": "转发"
                },
                {
                    "task_id": "19102976566880092186683",
                    "key": "AddRemark",
                    "name_en": "AddRemark",
                    "name_cn": "添加备注"
                },
                {
                    "task_id": "19102976566880092186683",
                    "key": "incidentChangeLevel1",
                    "name_en": "incidentChangeLevel1",
                    "name_cn": "升降级",
                    "operate_tip_zh": "只有责任人可以操作"
                },
                {
                    "task_id": "19102976566880092186683",
                    "key": "incidentPause",
                    "name_en": "incidentPause"
                }
            ]
        }
    ]
}

状态码:400

服务器未能处理请求。

更多状态码请参考状态码

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

状态码

状态码

描述

200

请求成功。

更多状态码请参考状态码

400

服务器未能处理请求。

更多状态码请参考状态码

错误码

请参见错误码

相关文档