2.5. MSE sensor creation

MSE sensors can be created issuing a POST request to the following URI:

      HTTP Verb: POST
      URI: https://hostname/api/v1/sensors/mse

      STATUS: DEPRECATED
      HTTP Verb: POST
      URI: https://hostname/api/v1/sensors/create/mse

This request accepts the following payload parameters:

stream (Mandatory) MSE stream name.
name (Mandatory) Name given to the mse sensor.
parent_uuid (Optional) Specifies the parent sensor UUID. If none is specified it defaults to root sensor.
version_mse (Optional) Specifies the version of MSE. If none is specified it defaults to MSE value.
snmp_community (Optional) Specifies the community name for SNMP.
snmp_version (Optional) Specifies the community version for SNMP. Allowed versions are: 1, 2c.

homenets (Optional) Set multiple Home Networks to this sensor. This parameters contains an array with the following format:

            {
              ...
              "homenets": [
                { "name" : "NameOfHomenet", "value" : "192.168.1.0/24" },
                { "name" : "NameOfHomenet2", "value" : "192.168.2.0/24" },
                ...
              ]
            }

If request was successful HTTP 200 OK status code will be returned alongside a JSON response describing the new MSE sensor.

In the following lines you may find an example response to a successful request:

      Request:
        HTTP Verb: POST
        URI: https://hostname/api/v1/sensors/mse?auth_token=xxxxxx
        Payload: { "name": "test_mse",
                   "parent_uuid": "7549459708256671519",
                   "stream": "StreamB",
                   "mse_version": "8",
                   "port":"xxxx" }

      Response:
        {
          "query": true,
          "sensor": {
            "id": 902
            "uuid": "4110689521083459108"
            "name": "test_mse"
            "stream": "StreamB"
            "mse_version": "8"
          }
        }