POST /reference_data/map_of_sets/{name}

Add or update an element in a reference map of sets.

Table 1. POST /reference_data/map_of_sets/{name} resource details
MIME Type
application/json

Table 2. POST /reference_data/map_of_sets/{name} request parameter details
Parameter	Type	Optionality	Data Type	MIME Type	Description
name	path	Required	String	text/plain	Required - The name of the reference map of sets to add or update an element in
key	query	Required	String	text/plain	Required - The key of the set to add or update
value	query	Required	String	text/plain	Required - The value to add or update in the reference map of sets. Note: Date values must be represented in milliseconds since the Unix Epoch January 1st 1970.
source	query	Optional	String	text/plain	Optional - This indicates where the data originated. The default value is 'reference data api'
fields	query	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 /reference_data/map_of_sets/{name} response codes
HTTP Response Code	Unique Code	Description
200		The reference map of sets has had an element added or updated
404	1002	The reference map of sets does not exist
422	1005	A request parameter is not valid
500	1020	An error occurred while attempting to add or update data in the reference map of sets

Response Description

Information about the reference map of sets that has had an element added or updated. This returns information about the reference map of sets but not the contained data.

Response Sample


{
    "creation_time": 42,
    "element_type": "String <one of: ALN, NUM, IP, PORT, ALNIC, DATE>",
    "key_label": "String",
    "name": "String",
    "number_of_elements": 42,
    "time_to_live": "String",
    "timeout_type": "String <one of: UNKNOWN, FIRST_SEEN, LAST_SEEN>",
    "value_label": "String"
}