Create an Exclusion Profile

post

/api/discovery/Excludes

Creates a new exclusion profile.
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
Request Body - application/json ()
Root Schema : schema
Match All
Show Source
Nested Schema : schema
Type: object
Show Source
  • The device zone ID.
    Example: 1
  • 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.*
  • 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.
  • 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
  • The profile status ID. Either 0 (disabled) or 1 (enabled).
    Example: 0
  • The profile type ID. Allowed Values:
    • 1: IP Range
    • 2: Device List
    Example: 1
  • 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
Back to Top

Response

Supported Media Types

200 Response

Successful operation
Body ()
Root Schema : schema
Match All
Show Source
Nested Schema : SuccessfulAddOperation
Type: object
The response body for a successful add operation.
Show Source
Nested Schema : type
Type: object
Show Source
Nested Schema : data
Type: array
The properties of the new exclusion profile.
Show Source
Nested Schema : discoveryExcludesRead
Type: object
Show Source
Nested Schema : DeviceZoneID
Type: object
The device zone name and ID.
Show Source
  • The device zone ID.
    Example: 1
  • The device zone name associated with the specified id.
    Example: Default First Zone

Default Response

Failed operation
Body ()
Root Schema : schema
Type: object
Show Source
Nested Schema : errors
Type: array
The list of errors reported. Validation errors will be keyed by record field.
Show Source
Nested Schema : items
Type: object
An error.
Back to Top