# 获取事件单详细 - ShowCocIncidentDetail #### 功能介绍 获取事件单详细。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/COC/doc?api=ShowCocIncidentDetail)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-coc/coc_api_06.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | coc:ticket:get | Read | - | - | - | - | #### URI GET /v1/external/incident/{incident_num} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | incident_num | 是 | String | 事件单号，事件单唯一id。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | provider_code | String | **参数解释：** 服务标识。 **取值范围：** 不涉及 **默认取值：** 049 | | error_code | String | **参数解释：** 请求响应代码。 **取值范围：** GOM.00000000\~GOM.00009999999 **默认取值：** GOM.00000000 | | error_msg | String | **参数解释：** 请求响应描述。 **取值范围：** 不涉及 | | data | [CocIncidentTicketDetailInfoResponseData] object | 事件工单详情。 | 表3CocIncidentTicketDetailInfoResponseData | 参数 | 参数类型 | 描述 | |:---|:---|:---| | incident_num | String | 事件单号。 | | region | Array of strings | 区域Code，如果自动拉起WarRoom则为必填，现在只支持1个。 | | enterprise_project | Array of strings | 企业项目ID，现在只支持1个。 | | current_cloud_service | Array of strings | 归属应用ID，现在只支持1个。 | | incident_level | String | 事件级别 参考：枚举 [事件级别](https://support.huaweicloud.com/api-coc/coc_api_04_03_001_006.html) | | is_service_interrupt | Boolean | 业务是否中断，取值：true/false。 | | start_time | Long | 故障发生时间戳。 | | fault_recovery_time | Long | 故障恢复时间戳。 | | fault_delineation_time | Long | 定界完成时间戳。 | | incident_type | String | 事件类别 参考：枚举 [事件类别](https://support.huaweicloud.com/api-coc/coc_api_04_03_001_006.html) | | incident_title | String | 事件标题，最大长度：200。 | | incident_description | String | 事件描述，最大长度：600。 | | incident_source | String | 单据来源 参考：枚举 [事件类别](https://support.huaweicloud.com/api-coc/coc_api_04_03_001_006.html) | | incident_ownership | String | 事件归属 参考：枚举 [事件归属](https://support.huaweicloud.com/api-coc/coc_api_04_03_001_006.html) | | incident_assignee | Array of strings | 责任人，排班场景和排班角色不能同时为空，现在只支持1个。 | | assignee_scene | String | 排班场景，责任人和排班角色不能同时为空。 | | assignee_role | String | 排班角色，排班场景和责任人不能同时为空。 | | warroom_id | String | warroom_id。 | | handle_time | Long | 最后一次提交解决方案时间戳。 | | status | String | **参数解释：** 事件单当前的状态，枚举值。 **约束限制：** 字符串 0 - 255字符 **取值范围：** 枚举值 - INCIDENT_STATUS_ACKNOWLEDGED：已受理 - INCIDENT_STATUS_CLOSED：客户已关闭 - INCIDENT_STATUS_COMPLETED：已完成 - INCIDENT_STATUS_REJECTED：被驳回 - INCIDENT_STATUS_RESOLVED：已解决待验证 - INCIDENT_STATUS_TRIGGERED：未受理 - level_approving：事件降级审批中 - pausing：暂停中 - pause_approving：事件暂停审批中 - ROS_CLEANUP_INCIDENT_CLOSED：租户退租事件单关闭 **默认取值：** 不涉及。 | | create_time | Long | 创单时间戳。 | | creator | String | 创单人。 | | enum_data_list | Array of [TicketInfoEnumData] objects | 枚举列表。 | 表4TicketInfoEnumData | 参数 | 参数类型 | 描述 | |:---|:---|:---| | filed_key | String | **参数解释：** 标识枚举值类型。 **约束限制：** 字符串 0 - 255字符 **取值范围：** 枚举值 - current_cloud_service_id：事件单责任服务 - creator：事件单创建人 - incident_ownership：事件单归属 - level_id：事件单级别 - work_flow_status：事件单状态 - mtm_type：事件单类型 - source_id：事件单来源 - assignee：当前责任人 - mtm_region：事件单所属region **默认取值：** 不涉及 | | enum_key | String | **参数解释：** 枚举对应的值，如当filed_key为creator且enum_key为test_id时，表示事件单创建人工号ID为test_id。 **约束限制：** 字符串 0 - 255字符 **取值范围：** 不涉及 **默认取值：** 不涉及 | | name_zh | String | 中文名称。 | | name_en | String | 英文名称。 | **状态码：400** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | provider_code | String | **参数解释：** 服务标识。 **取值范围：** 不涉及 **默认取值：** 049 | | error_code | String | **参数解释：** 请求响应代码。 **取值范围：** GOM.00000000\~GOM.00009999999 **默认取值：** GOM.00000000 | | error_msg | String | **参数解释：** 请求响应描述。 **取值范围：** 不涉及 | #### 请求示例 获取事件单详细。 ``` GET https://{Endpoint}/v1/external/incident/{incident_num} ``` #### 响应示例 **状态码：200** 请求成功。 更多状态码请参考[状态码](https://support.huaweicloud.com/api-coc/coc_api_05_03.html)。 ``` { "provider_code" : "049", "error_code" : "GOM.00000000", "error_msg" : null, "data" : { "incident_num" : "207E3F5A248A4F5DAABC012C7E", "region" : [ "OCB_cloud" ], "enterprise_project" : null, "current_cloud_service" : [ "6470681a31da2a47ed50a919" ], "incident_level" : "level_10", "is_service_interrupt" : true, "start_time" : null, "incident_type" : "inc_type_p_security_issues", "incident_title" : "FA3698893F", "incident_description" : "FA3698893F", "incident_source" : "incident_source_manual", "incident_ownership" : null, "incident_assignee" : [ "01649a08fb744291a952f3c470b92f9e" ], "assignee_scene" : "", "assignee_role" : "", "warroom_id" : null, "handle_time" : null, "status" : "INCIDENT_STATUS_TRIGGERED", "create_time" : 1700035856542, "fault_recovery_time" : 1700035856542, "fault_delineation_time" : 1700035856542, "creator" : "9fec03ee5b1040818b91bef6e16213df", "enum_data_list" : [ { "filed_key" : "current_cloud_service_id", "enum_key" : "6470681a31da2a47ed50a919", "name_zh" : null, "name_en" : null }, { "filed_key" : "creator", "enum_key" : "9fec03ee5b1040818b91bef6e16213df", "name_zh" : null, "name_en" : null }, { "filed_key" : "level_id", "enum_key" : "level_10", "name_zh" : "P1", "name_en" : "P1" }, { "filed_key" : "work_flow_status", "enum_key" : "INCIDENT_STATUS_TRIGGERED", "name_zh" : "未受理", "name_en" : "TRIGGERED" }, { "filed_key" : "mtm_type", "enum_key" : "inc_type_p_security_issues", "name_zh" : "安全问题", "name_en" : "Security issues" }, { "filed_key" : "source_id", "enum_key" : "incident_source_manual", "name_zh" : "人工创建", "name_en" : "Manual Creation" }, { "filed_key" : "assignee", "enum_key" : "01649a08fb744291a952f3c470b92f9e", "name_zh" : null, "name_en" : null } ] } } ``` **状态码：400** 服务器未能处理请求。 更多状态码请参考[状态码](https://support.huaweicloud.com/api-coc/coc_api_05_03.html)。 ``` { "error_code" : "GOM.00007256", "error_msg" : "参数错误", "provider_code" : 4, "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)。