Create a Metric Display Instance
post
/api/metric/DisplayInstances
Creates a metric display instance.
The minimum required properties in the request body are:
The minimum required properties in the request body are:
- SourceDeviceID
- SourceDeviceName
- InstanceID
- MetricDisplayInstanceName
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
DeviceName: string
Serialized device name the new display instance is associated with.Example:
router.example.com;z1 OR router.example.com
-
DeviceZoneID: integer
Database ID of the device zone the new display instance is associated with. Deprecated. Use serialized device name instead. Specify either DeviceZoneName or DeviceZoneID.
-
DeviceZoneName: string
Device zone name the new display instance is associated with. Deprecated. Use serialized device name instead. Specify either DeviceZoneName or DeviceZoneID.
-
InstanceID: integer
Instance IDExample:
543
-
MetricDisplayInstanceName: string
The custom display name.
To avoid confusion with numeric IDs, the name value cannot be integers only or integers prefixed with the + or - symbols only. It must contain letters or other characters. For example, 1234, +1234, and -1234 are not valid, but US1234, US+1234 and US_1234 are.Example:1 Minute Average
-
SourceDeviceName: string
Source device name
-
SourceDeviceZoneID: integer
Database ID of the source device zone. Deprecated. Use serialized device name instead. Specify either SourceDeviceZoneName or SourceDeviceZoneID.
-
SourceDeviceZoneName: string
Source device zone name. Deprecated. Use serialized device name instead. Specify either SourceDeviceZoneName or SourceDeviceZoneID.
Response
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : schema
Match All
Show Source
-
object
SuccessfulAddOperation
The response body for a successful add operation.
-
object
type
Nested Schema : SuccessfulAddOperation
Type:
object
The response body for a successful add operation.
Show Source
-
message: string
The response message.Example:
Added record
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
true
Nested Schema : type
Type:
Show Source
object
-
data: array
data
-
total: integer
The total number of results regardless of paging.Example:
1
Nested Schema : metricDisplayInstancesRead
Type:
Show Source
object
-
DeviceID: integer
Device IDExample:
1
-
DeviceName: string
Device NameExample:
router.example.com
-
DeviceZoneName: string
Device zone name.Example:
Default First Zone
-
InstanceID: integer
Instance IDExample:
543
-
InstanceName: string
Instance NameExample:
Load-1
-
MetricDisplayInstanceID: integer
Metric DisplayInstance IDExample:
35
-
MetricDisplayInstanceName: string
Custom display nameExample:
1 Minute Average
-
SourceDeviceID: integer
Source Device IDExample:
1
-
SourceDeviceName: string
Source Device NameExample:
router.example.com
-
SourceDeviceZoneName: string
Source device zone name.
Default Response
Failed operation
Root Schema : schema
Type:
Show Source
object
-
errors: array
errors
The list of errors reported. Validation errors will be keyed by record field.
-
message: string
The response message.Example:
Exception thrown
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
false
Nested Schema : errors
Type:
array
The list of errors reported. Validation errors will be keyed by record field.
Show Source
-
Array of:
object items
An error.
Nested Schema : items
Type:
object
An error.