Create an Inclusion Profile

post

/api/discovery/Includes

Creates a new inclusion profile. The inclusion profile can be one of four types- Ping, Seed, LDAP or CDP.
The minimum required properties in the request body are:
  • ProfileName
  • ProfileStatusID
  • ProfileTypeID
  • DeviceZoneID

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 : discoveryIncludes
Type: object
Show Source
  • The LDAP base domain name.
    Example: DC=localdomain,DC=local
  • The CDP seeds. For example, 10.10.10.1,hostname,172.16.10.1.
    Example: oracle.doceng.json.BetterJsonNull@4e26040f
  • The type of range expansion. Allowed Values:
    • 1: Glob expansion
    • 2: CIDR expansion
    Example: oracle.doceng.json.BetterJsonNull@5065bdac
  • The device zone ID.
    Example: 1
  • The number of iterations for CDP discovery.
    Example: oracle.doceng.json.BetterJsonNull@477bea57
  • The IP Range (for example, 10.*.0-9.1,2,3,4 for glob expansion; 172.16.10.0/24 for CIDR expansion).
    Example: 10.*.0-9.1
  • The inclusion 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: Active Directory scan
  • The profile status ID. Either 0 (disabled) or 1 (enabled).
    Example: 0
  • The profile type ID. Allowed values are:
    • 1: Ping Scan. The IPRange and CID parameters are also required.
    • 2: Seed Scan. The Seeds parameter is also required.
    • 3: LDAP Scan. The ServerName, ServerPort, BaseDN, UserDN, UserPass, and Query parameters are also required.
    • 4: CDP Scan. The CDPSeeds and Hops parameters are also required.
    Example: 3
  • The LDAP query text to produce server names.
    Example: (objectClass=computer)
  • The seeds. For example, 10.10.10.1,hostname,172.16.10.1.
    Example: oracle.doceng.json.BetterJsonNull@6705b763
  • The LDAP server FQDN host or IP address.
    Example: ldap.localdomain.local
  • The LDAP server port (TCP only).
    Example: 389
  • The LDAP base user name.
    Example: monolith@localhost
  • The LDAP base user password.
    Example: password
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 inclusion profile.
Show Source
Nested Schema : discoveryIncludesRead
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