Create a Device Configuration Policy
post
/api/config/Policies
Creates a new device configuration policy.
The minimum required properties in the request body are:
The minimum required properties in the request body are:
- ConfigDiscoProfileName
- StatusID
- Description
- DeviceNameRegex
- DeviceMetaTypeID
- DeviceMetaTypeValue
- ConfigAgentProfileID
- ConfigActionProfileID
- DeviceTypeID
- DeviceTypeCategoryID
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
ConfigActionProfileID: integer
The action profile ID.Example:
1001
-
ConfigAgentProfileID: integer
The configuration agent profile ID.Example:
1001
-
ConfigDiscoProfileName: string
The 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:test
-
Description: string
The policy description.Example:
Example Description
-
DeviceMetaTypeID: integer
The device meta type ID.Example:
5
-
DeviceMetaTypeValue: string
The device meta type value.Example:
Example Value
-
DeviceNameRegex: string
The regular expression to match with device names. Used to limit the policy to specific devices.Example:
^(Device-[0-9]{3})$
-
DeviceTypeCategoryID: integer
The device type category ID.Example:
6
-
DeviceTypeID: string
The device type ID.Example:
NONE
-
IPRange: string
The device IP range to which the policy should be applied.Example:
192.168.1.0 - 192.168.1.255
-
StatusID: integer
The policy status ID. Either 0 (disabled) or 1 (enabled).Example:
0
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 properties of the new device configuration policy.
-
total: integer
The total number of results regardless of paging.Example:
1
Nested Schema : configPoliciesRead
Type:
Show Source
object
-
ActionName: string
The action name.Example:
SSH Action
-
ConfigActionProfileID: integer
The action profile ID.Example:
1001
-
ConfigAgentProfileID: integer
The configuration agent profile ID.Example:
1001
-
ConfigDiscoProfileID: integer
The profile ID specified for individual CRUD operations.Example:
1004
-
ConfigDiscoProfileName: string
The policy name.Example:
test
-
Description: string
The policy description.Example:
Example Description
-
DeviceMetaTypeID: integer
The device meta type ID.Example:
5
-
DeviceMetaTypeName: string
The device meta type name.Example:
Example Name
-
DeviceMetaTypeValue: string
The device meta type value.Example:
Example Value
-
DeviceNameRegex: string
The regular expression to match with device names. Used to limit the policy to specific devices.Example:
^(Device-[0-9]{3})$
-
DeviceTypeCategoryID: integer
The device type category ID.Example:
6
-
DeviceTypeCategoryName: string
The device type category name.Example:
Server
-
DeviceTypeID: string
The device type ID.Example:
NONE
-
DeviceTypeName: string
The device type name.Example:
Example Name
-
IPRange: string
The device IP range to apply the policy to.Example:
192.168.1.0 - 192.168.1.255
-
ProfileName: string
The profile name.Example:
SSH Profile
-
Status: string
The status, based on the value of the StatusID property. When StatusID is 0, Status is Disabled. When StatusID is 1, Status is EnabledExample:
Disabled
-
StatusIcon: string
The status image name based on StatusID. If StatusID is 0, StatusIcon will be OrbRed.png. If StatusID is 1, StatusIcon will be OrbGreen.png.Example:
OrbRed.png
-
StatusID: integer
The policy status ID. Either 0 (disabled) or 1 (enabled).Example:
0
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.