Create an Exclusion Profile
post
/api/discovery/Excludes
Creates a new exclusion profile.
The minimum required properties in the request body are:
The minimum required properties in the request body are:
- ProfileName
- DeviceZoneID
- ProfileStatusID
- ProfileTypeID
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Nested Schema : schema
Type:
Show Source
object
-
DeviceZoneID: integer
The device zone ID.Example:
1
-
IPRange: string
Required when the value of ProfileTypeID is 1. The IP range to exclude from discovery. For example, 10.*.0-9.1,2,3,4.Example:
0.0.0-1.*
-
ProfileDescr: string
The discovery profile description, which explains why the devices are being excluded.Example:
This is an example of excluding a list of devices from discovery.
-
ProfileName: string
The exclusion profile 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:Example Device list
-
ProfileStatusID: integer
The profile status ID. Either 0 (disabled) or 1 (enabled).Example:
0
-
ProfileTypeID: integer
The profile type ID. Allowed Values:
- 1: IP Range
- 2: Device List
Example:1
-
Seeds: string
Required when the value of ProfileTypeID is 2. The seeds to exclude from discovery. For example, 10.10.10.1,hostname,172.16.10.1.Example:
192.168.100.255,10.10.10.255
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 exclusion profile.
-
total: integer
The total number of results regardless of paging.Example:
1
Nested Schema : discoveryExcludesRead
Type:
Show Source
object
-
DeviceZoneID: object
DeviceZoneID
The device zone name and ID.
-
DeviceZoneName: string
The device zone name.Example:
Default First Zone
-
IPRange: string
The IP range excluded from discovery. For example, 10.*.0-9.1,2,3,4.Example:
0.0.0-1.*
-
ProfileDescr: string
The discovery profile description, which explains why the devices are being excluded.Example:
This is an example of excluding a list of devices from discovery.
-
ProfileID: integer
The discovery profile ID for individual CRUD operations.Example:
2
-
ProfileName: string
The discovery profile name.Example:
Example Device List
-
ProfileStatus: string
The profile status.Example:
Disabled
-
ProfileStatusIcon: string
The profile status icon.Example:
OrbRed.png
-
ProfileStatusID: integer
The profile status ID. Either 0 (disabled) or 1 (enabled).Example:
0
-
ProfileType: string
The profile type. Allowed Values:
- 1: IP Range
- 2: Device List
Example:Device List
-
Seeds: string
The seeds excluded from discovery.Example:
192.168.100.255,10.10.10.255
Nested Schema : DeviceZoneID
Type:
object
The device zone name and ID.
Show Source
-
id: integer
The device zone ID.Example:
1
-
name: string
The device zone name associated with the specified id.Example:
Default First Zone
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.