Create a Polling Policy
post
/api/metric/PollingPolicies
Creates a polling policy.
The minimum required properties in the request body are:
The minimum required properties in the request body are:
- PolicyName
- IPRange
- CIDR
- DeviceMetaTypeID
- DeviceTypeCategoryID
- StatusID
- InstanceTypeID
- SysObjectID
- PollerTemplateID
- MethodID
- ThresholdGroupID
- DeviceNameMatchTypeID
- InstanceNameMatchTypeID
- DeviceTypeMatchTypeID
- MetaDataMatchTypeID
- PollTime
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
CIDR: integer
CIDR Allowed Values: - 0 => Disabled - 1 => EnabledExample:
1
-
DeviceMetaTypeID: integer
Device MetaType IDExample:
0
-
DeviceName: string
Device NameExample:
router.example.com
-
DeviceNameMatchTypeID: integer
The operator to match device names. Allowed Values: - 0 => LIKE - 1 => NOT LIKE - 2 => REGEXP - 3 => NOT REGEXPExample:
0
-
DeviceTypeCategoryID: integer
Device Type Category IDExample:
0
-
DeviceTypeMatchTypeID: integer
Device Type Match Type Allowed Values: - 0 => LIKE - 1 => NOT LIKE - 2 => REGEXP - 3 => NOT REGEXPExample:
0
-
InstanceName: string
Instance NameExample:
ens3
-
InstanceNameMatchTypeID: integer
The operator to match instance names. Allowed Values: - 0 => LIKE - 1 => NOT LIKE - 2 => REGEXP - 3 => NOT REGEXPExample:
0
-
InstanceTypeID: integer
Instance Type IDExample:
1
-
IPRange: string
IP Range (e.g. 10.*.0-9.1,2,3,4 or 172.16.10.0/24 for CIDR Scan)Example:
172.16.10.0/24
-
MetaData: string
MetaDataExample:
-
MetaDataMatchTypeID: integer
Meta DataMatch Type Allowed Values: - 0 => LIKE - 1 => NOT LIKE - 2 => REGEXP - 3 => NOT REGEXPExample:
0
-
MethodID: integer
MethodID Allowed Values: - 0 => NA - 1 => SNMP - 2 => WMI - 3 => Other - 5 => TransactionExample:
1
-
PolicyDescription: string
Policy DescriptionExample:
Description of the policy
-
PolicyName: string
The polling policy 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:Configure Network Interface Polling - ens3
-
PollerTemplateID: integer
Poller Template IDExample:
3
-
PollTime: integer
PollTime in secondsExample:
300s
-
StatusID: boolean
The metric policy status ID. Either 0 (disabled) or 1 (enabled).Example:
1
-
SysObjectID: integer
The device type ID to match.Example:
NONE
-
ThresholdGroupID: integer
Threshold Group IDExample:
3
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
The new polling policy.
-
total: integer
The total number of results regardless of paging.Example:
1
Nested Schema : metricPollingPoliciesRead
Type:
Show Source
object
-
Category: string
CategoryExample:
Any
-
CIDR: integer
CIDR |Allowed Values: |0 => Disabled |1 => EnabledExample:
1
-
CIDRDisplayName: string
A descriptive label for the CIDR flag. Allowed Values are "Disabled" and "Enabled"Example:
Disabled
-
DeviceDisplayName: string
Device Display NameExample:
Any
-
DeviceMetaTypeID: integer
Device MetaType IDExample:
0
-
DeviceMetaTypeName: string
Device MetaType NameExample:
ADBaseDN
-
DeviceName: string
Device NameExample:
router.example.com
-
DeviceNameMatchTypeID: integer
The operator to match device names. Allowed Values: - 0 => LIKE - 1 => NOT LIKE - 2 => REGEXP - 3 => NOT REGEXPExample:
0
-
DeviceType: string
Device TypeExample:
Any
-
DeviceTypeCategoryID: integer
Device Type Category IDExample:
0
-
DeviceTypeMatchTypeID: integer
Device Type Match Type Allowed Values: - 0 => LIKE - 1 => NOT LIKE - 2 => REGEXP - 3 => NOT REGEXPExample:
0
-
InstanceDisplayName: string
Instance Display NameExample:
LIKE/ens3/
-
InstanceName: string
Instance NameExample:
ens3
-
InstanceNameMatchTypeID: integer
The operator to match instance names. Allowed Values: - 0 => LIKE - 1 => NOT LIKE - 2 => REGEXP - 3 => NOT REGEXPExample:
0
-
InstanceTypeID: integer
Instance Type IDExample:
1
-
InstanceTypeName: string
Instance Type NameExample:
SNMP Interface
-
IPRange: string
IP Range (e.g. 10.*.0-9.1,2,3,4 or 172.16.10.0/24 for CIDR Scan)Example:
-
IPRangeDisplayName: string
IP Range Display Name. It will be the same as IP Range unless IP Range is blank. Then the display name will be "Any".Example:
Any
-
MetaData: string
MetaDataExample:
-
MetaDataDisplay: string
The meta data operator and value unless the value is blank. then the display will be "Any".Example:
Any
-
MetaDataMatchTypeID: integer
Meta Data Match Type Allowed Values: - 0 => LIKE - 1 => NOT LIKE - 2 => REGEXP - 3 => NOT REGEXPExample:
0
-
MethodID: integer
MethodID |Allowed Values: |0 => NA |1 => SNMP |2 => WMI |3 => Other |5 => TransactionExample:
1
-
MethodName: string
Method NameExample:
SNMP
-
PolicyDescription: string
Policy DescriptionExample:
-
PolicyID: integer
Policy IDExample:
5
-
PolicyName: string
Policy NameExample:
Configure Network Interface Polling - ens3
-
PollerTemplateID: integer
Poller Template IDExample:
3
-
PollTime: integer
PollTime in secondsExample:
300
-
StatusIcon: string
Status IconExample:
OrbGreen.png
-
StatusID: boolean
The metric policy status ID. Either 0 (disabled) or 1 (enabled).Example:
1
-
StatusName: string
Status NameExample:
Enabled
-
SysObjectID: integer
The device type ID to matchExample:
NONE
-
TemplateName: string
Template NameExample:
Default Network Interface
-
ThresholdGroupID: integer
Threshold Group IDExample:
3
-
ThresholdGroupName: string
Threshold Group NameExample:
Default Network Interface
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.