GET-获取事件详情

接口介绍

获取事件详情接口用于获取某一事件的详细信息。

请求方式

接口地址

https://<ucwi_endpoint>:5443/skg/v1/dlp/incident/<事件ID>

请求参数

Python请求示例

以下示例为使用Python代码调用接口，以请求获取事件详情信息。

该示例旨在调用接口，请求获取UUID为d829cb60-1571-4c72-b2c4-3de461698b73的事件的详细信息。

# -*- coding: utf-8 -*-
from requests.packages.urllib3.exceptions import InsecureRequestWarning
from ucwi_config import UCWIConfig
from ucwi_auth import get_headers
import requests
import json

requests.packages.urllib3.disable_warnings(InsecureRequestWarning)

incident_uuid = "d829cb60-1571-4c72-b2c4-3de461698b73"
# 事件的UUID
api = "/skg/v1/dlp/incident/{}".format(incident_uuid)
url = "{0}{1}".format(UCWIConfig.base_url, api)

headers = get_headers()
response = requests.get(url, headers=headers, verify=False)
if response.status_code != 200:
    print("Bad request, response code:", response.status_code)
    print(response.text)
else:
    print(json.dumps(response.json(), indent=4).encode('utf-8').decode('raw_unicode_escape'))

返回结果

返回值包含：查询ID，检测时间，事件时间，来源，目标，策略名称，通道，动作，事件状态，安全级别，最大匹配，和文件名称。

返回值参数定义如下表所示：

返回示例

事件详情请求返回值案例：

• 请求成功：

  {
  "result" : 0,
  "data" : {
  "queryID" : "d829cb60-1571-4c72-b2c4-3de461698b73",
  "forensicsName" : "76c68a52-dff3-47e0-b992-a3186fad2134.eml"
  "detectTime" : 1484896943,
  "incidentTime": 1484896943,
  "source" : ["abc\joe.doe"],
  "dest" : ["www.baidu.com"],
  "action" : 1/2,
  "channel" : "http",
  "policies" : ["test"],
  "incidentStatus" : 1/2/3/4/5,
  "severityTypeCode": 1/2/3/4,
  "maxMatches": 10
  }
  }

• 请求失败

  {
  "result" : 1,
  "errorCode" : 400,
  "message" : "Invalid parameter"
  }

错误代码