POST /reference_data/map_of_sets/{name}/description DEPRECATED

Add or update description a reference map of sets.

Add or update description in a reference map.

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

application/json

Table 2. POST /reference_data/map_of_sets/{name}/description 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 description

namespace

query

Optional

String

text/plain

Either SHARED or TENANT, default is SHARED.

description

query

Optional

String

text/plain

Required - Description of reference map

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}/description response codes
HTTP Response Code Unique Code Description

200

The reference map has description added or updated

404

1002

The reference map does not exist

422

1005

A request parameter is not valid

422

1021

Description value should be less than 2048 characters

500

1020

An error occurred while attempting to add description

Response Description

Information about the reference map

Response Sample


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