Update an Inclusion Profile
put
/api/discovery/Includes/{id}
Updates the properties of the inclusion profile that matches the specified ID.
Request
Path Parameters
-
id(required): integer
The discovery profile ID.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
BaseDN: string
The LDAP base domain name.Example:
DC=localdomain,DC=local
-
CDPSeeds: string
The CDP seeds. For example, 10.10.10.1,hostname,172.16.10.1.Example:
oracle.doceng.json.BetterJsonNull@4e26040f
-
CIDR: string
The type of range expansion. Allowed Values:
- 1: Glob expansion
- 2: CIDR expansion
Example:oracle.doceng.json.BetterJsonNull@5065bdac
-
DeviceZoneID: integer
The device zone ID.Example:
1
-
Hops: integer
The number of iterations for CDP discovery.Example:
oracle.doceng.json.BetterJsonNull@477bea57
-
IPRange: string
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
-
ProfileName: string
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
-
ProfileStatusID: integer
The profile status ID. Either 0 (disabled) or 1 (enabled).Example:
0
-
ProfileTypeID: integer
The profile type ID. Allowed values are:
- 1: Ping Scan. The IPRange and CID parameters are updated.
- 2: Seed Scan. The Seeds parameter is updated.
- 3: LDAP Scan. The ServerName, ServerPort, BaseDN, UserDN, UserPass, and Query parameters are updated.
- 4: CDP Scan. The CDPSeeds and Hops parameters are updated.
Example:3
-
Query: string
The LDAP query text to produce server names.Example:
(objectClass=computer)
-
Seeds: string
The seeds. For example, 10.10.10.1,hostname,172.16.10.1.Example:
oracle.doceng.json.BetterJsonNull@6705b763
-
ServerName: string
The LDAP server FQDN host or IP address.Example:
ldap.localdomain.local
-
ServerPort: integer
The LDAP server port (TCP only).Example:
389
-
UserDN: string
The LDAP base user name.Example:
monolith@localhost
-
UserPass: string
The LDAP base user password.Example:
password
Response
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : schema
Match All
Show Source
-
object
SuccessfulUpdateOperation
The response body for a successful update operation.
-
object
type
Nested Schema : SuccessfulUpdateOperation
Type:
object
The response body for a successful update operation.
Show Source
-
message: string
The response message.Example:
Updated 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 updated inclusion profile.
-
total: integer
The total number of results regardless of paging.Example:
1
Nested Schema : discoveryIncludesRead
Type:
Show Source
object
-
BaseDN: string
The LDAP base domain name.Example:
DC=localdomain,DC=local
-
CDPSeeds: string
The CDP seeds. For example, 10.10.10.1,hostname,172.16.10.1.Example:
oracle.doceng.json.BetterJsonNull@4e26040f
-
CIDR: string
The type of range expansion. Allowed Values:
- 1: Glob expansion
- 2: CIDR expansion
Example:oracle.doceng.json.BetterJsonNull@5065bdac
-
CIDRFlag: string
Whether to use CIDR (Enabled) or not (Disabled).Example:
oracle.doceng.json.BetterJsonNull@9a07409
-
DeviceZoneID: object
DeviceZoneID
The device zone name and ID.
-
DeviceZoneName: string
The device zone name.Example:
Default First Zone
-
Hops: integer
The number of iterations for CDP discovery.Example:
oracle.doceng.json.BetterJsonNull@477bea57
-
IPRange: string
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
-
ProfileID: integer
The discovery profile ID for individual CRUD operations.Example:
3
-
ProfileName: string
The discovery profile name.Example:
Example Active Directory Scan
-
ProfileStatus:
The profile status. The allowed values are:
- Enabled
- Disabled
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:
- Ping Scan
- Seed Scan>
- LDAP Scan
- CDP Scan
Example:LDAP Scan
-
ProfileTypeID: integer
The profile type ID. Allowed Values:
- 1: Ping Scan
- 2: Seed Scan
- 3: LDAP Scan
- 4: CDP Scan
Example:3
-
Query: string
The LDAP query text to produce server names.Example:
(objectClass=computer)
-
Seeds: string
The seeds. For example, 10.10.10.1,hostname,172.16.10.1.Example:
oracle.doceng.json.BetterJsonNull@6705b763
-
ServerName: string
The LDAP server FQDN host or IP address.Example:
ldap.localdomain.local
-
ServerPort: integer
The LDAP server port (TCP only).Example:
389
-
UserDN: string
The LDAP base user name.Example:
monolith@localhost
-
UserPass: string
The LDAP base user password.Example:
password
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.