POST /data_classification/dsm_event_mappings

Creates a new custom DSM event mapping.

Creates a new custom DSM event mapping.

Table 1. POST /data_classification/dsm_event_mappings resource details
MIME Type

application/json

Table 2. POST /data_classification/dsm_event_mappings request parameter details
Parameter Type Optionality Data Type MIME Type Description

fields

header

Optional

String

text/plain

Optional - Use this parameter to specify which fields you would like to get back in the response. Fields that are not named are excluded. Specify subfields in brackets and multiple fields in the same object are separated by commas.

Table 3. POST /data_classification/dsm_event_mappings request body details
Parameter Data Type MIME Type Description Sample

data

Object

application/json

Required - A DSM event mapping that contains the following fields:
  • log_source_type_id - Required - Number - The ID of the Log Source Type this DSM event mapping resource is associated with.
  • log_source_event_id - Required - String - The primary identifying value parsed from an event to be used to look up the corresponding QID record.
  • log_source_event_category - Required - String - The secondary identifying value parsed from an event to be used to look up the corresponding QID record.
  • qid_record_id - Required - Number - The ID of the QID record to which this DSM event mapping provides a mapping.

{ "log_source_event_category": "String", "log_source_event_id": "String", "log_source_type_id": 42, "qid_record_id": 42 }

Table 4. POST /data_classification/dsm_event_mappings response codes
HTTP Response Code Unique Code Description

201

The new custom DSM event mapping was created.

409

1008

There is an existing custom DSM event mapping with same the log_source_type_id, log_source_event_id and log_source_event_category combination. Cannot create duplicate DSM event mapping.

422

1005

Invalid parameter value provided for the new DSM event mapping.

500

1020

An error occurred during the attempt to create a new custom DSM event mapping.

Response Description

The newly created DSM event mapping that contains the following fields:
  • id - Number - The ID of the DSM event mapping.
  • log_source_type_id - Number - The ID of the Log Source Type this DSM event mapping resource is associated with.
  • log_source_event_id - String - The primary identifying value parsed from an event to be used to look up the corresponding QID record.
  • log_source_event_category - String - The secondary identifying value parsed from an event to be used to look up the corresponding QID record.
  • custom_event - Boolean - Flag to identify if the DSM event mapping is system provided (custom_event=false) or user-provided (custom_event=true).
  • qid_record_id - Number - The ID of the QID record to which this DSM event mapping provides a mapping.
  • uuid - String - The uuid of the DSM event mapping.

Response Sample


{
    "custom_event": true,
    "id": 42,
    "log_source_event_category": "String",
    "log_source_event_id": "String",
    "log_source_type_id": 42,
    "qid_record_id": 42,
    "uuid": "String"
}