Clotho Time Series API - POST now/v1/clotho/put

Adds a data series to the MetricBase database.

URL format

Versioned URL: api/now/v1/clotho/put

Supported request parameters

Table 1. Parameters
Parameter Description
sysparm_ignore_unknown_series Optional. If true, ignore unknown series and continue the transaction without returning an error. The default is true.

Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see Supported REST API headers.

Table 2. Request headers
Header Description
None
Table 3. Response headers
Header Description
None

Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, seeREST response codes.

Table 4. Status codes
Status code Description
None

Request body

The API accepts a JSON object or an array of JSON objects. The JSON objects must be in this form.
{"seriesRef":{"subject":"xxx","table:"yyy","metric":"zzz"}, 
"values":[{"timestamp":"2016-10-14T10:30:00", "value":1.23},
          {"timestamp":"2016-10-14T10:31:00", "value":6.45}]}
An example of an array of JSON objects.
[{"seriesRef":{"subject":"xxx","table:"yyy","metric":"zzz"}, 
"values":[{"timestamp":"2016-10-14T10:30:00", "value":1.23},
          {"timestamp":"2016-10-14T10:31:00", "value":6.45}]},
 ...]