# 获取事件任务 - ShowIncidentTask #### 功能介绍 获取事件任务。 调用操作前进行调用。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/COC/doc?api=ShowIncidentTask)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-coc/coc_api_06.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | coc:ticket:listActions | List | - | - | - | - | #### URI GET /v2/incidents/{incident_id}/tasks 表1请求path参数列表 | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | incident_id | String | 是 | **参数解释：** 事件单号。 **约束限制：** 字符串 **取值范围：** 字符长度1-50 **默认取值：** 不涉及 | #### 响应参数 **状态码：200** 表2响应Body参数 | 名称 | 类型 | 描述 | |:---|:---|:---| | provider_code | String | **参数解释：** 服务标识。 **取值范围：** 不涉及 **默认取值：** 049 | | error_code | String | **参数解释：** 请求响应代码。 **取值范围：** GOM.00000000\~GOM.00009999999 **默认取值：** GOM.00000000 | | error_msg | String | **参数解释：** 请求响应描述。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | data | Arrays of [CocTaskDetailV2] | **参数解释：** 结果列表。 **取值范围：** 数组长度0-1000 **默认取值：** 不涉及 | 表3CocTaskDetailV2 | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | type | String | 否 | **参数解释：** 节点类型，指向当前事件流程所处的阶段。 **取值范围：** 枚举值 - StartNode：开始节点，表示流程的开始 - EndNode：结束节点，表示流程的结束 - ApprovalNode：审批节点，表示需要人工审批的环节 - OperateNode：操作节点，表示需要执行某些操作的环节 - PauseNode：暂停节点，表示流程处在暂停状态 - MutilateInstanceNode：多实例节点，通常用于会签等场景 **默认取值：** 0 | | name | String | 否 | **参数解释：** 节点名称。 **取值范围：** - 处理：工单已受理后，需要进行处理操作 - 一审或签：工单处于暂停审批阶段，需审批 - 未受理：表示工单 创建后，未受理 - 降级一审并签：工单降级需审批，且需要审批人全部审批通过 - 未受理驳回提单人确认：工单创建后被驳回 - 验证节点：表示工单状态为已解决待验证，需提单人进行验证 **默认取值：** 0 | | key | String | 否 | **参数解释：** 节点Key。 **取值范围：** - userTaskHandle1：处理 - pause_1_or_sign_node：一审或签 - level_1_all_sign_node：降级一审并签 - userTaskAccepted0001：未受理 - userTaskAcceptedRejectedConfirm1：未受理驳提单人确认 - resolved_conmfirm：验证节点 **默认取值：** 不涉及 | | state | String | 否 | **参数解释：** 状态，running运行中，suspend挂起中。 **取值范围：** 字符长度0-1000 **默认取值：** 不涉及 | | operations | Arrays of [CocTaskOperationDetailV2] | 否 | **参数解释：** 操作列表。 **取值范围：** 数组长度：0 - 1000 **默认取值：** 不涉及 | 表4CocTaskOperationDetailV2 | 名称 | 类型 | 是否必选 | 描述 | |:---|:---|:---|:---| | task_id | String | 否 | **参数解释：** 任务ID，后续执行操作的时候需要。 **取值范围：** 字符长度0-255 **默认取值：** 不涉及 | | key | String | 否 | **参数解释：** 操作Key，用于标记当前操作的类型。 **取值范围：** - recovery：恢复暂停 - agreed：审批同意 - rejected：审批驳回 - accepted：受理工单 - unAcceptedForward：工单未受理状态下转发责任人 - acceptedForward：已受理状态下转发责任人 - commitSolution：事件处理提交解决方案 - addRemark：添加备注 - RunWarRoom1：启动WarRoom - changeLevel：申请升降级 - pause：申请暂停 - confirm：事件单验收关单 **默认取值：** 不涉及 | #### 请求示例 获取事件单支持的任务。 ``` GET https://{Endpoint}/v2/incidents/{incident_id}/tasks ``` #### 响应示例 **状态码：200** 请求成功。 更多状态码请参考[状态码](https://support.huaweicloud.com/api-coc/coc_api_05_03.html)。 ``` { "provider_code": "049", "error_code": "GOM.00000000", "error_msg": null, "data": [ { "type": "OperateNode", "key": "userTaskHandle1", "name": "处理", "state": "running", "operations": [ { "task_id": "19102976566880092186683", "key": "commitSolution1" }, { "task_id": "19102976566880092186683", "key": "forwardOther1" }, { "task_id": "19102976566880092186683", "key": "AddRemark" }, { "task_id": "19102976566880092186683", "key": "incidentChangeLevel1" }, { "task_id": "19102976566880092186683", "key": "incidentPause" } ] } ] } ``` **状态码：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)。