Create an SNMP Access Profile
post
/api/discovery/Snmp
Creates a new SNMP access profile.
The minimum required properties in the request body are:
The minimum required properties in the request body are:
- Description
- DeviceZoneID
- MTU
- PriorityOrder
- SNMPPort
- SNMPVersion
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Nested Schema : schema
Type:
Show Source
object
-
AuthPassword: string
The SNMP v3 user authentication password.Example:
*****
-
AuthProtocol: string
The SNMP v3 authentication protocol.Example:
oracle.doceng.json.BetterJsonNull@13809363
-
Community: string
The SNMP v1 or v2 community string.Example:
public
-
Description: string
The SNMP Access Profile description.
To avoid confusion with numeric IDs, the description 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:Default Public
-
DeviceZoneID: integer
The device zone ID.Example:
1
-
EngineID: integer
The engine ID. The default is 1.Example:
oracle.doceng.json.BetterJsonNull@c7cf8c4
-
MTU: integer
The maximum transmission unit (MTU) size. The default value is 1472 bytes.Example:
1472
-
PriorityOrder: integer
The profile priority order. A lower value means a higher priority, the lowest value is first in the order.Example:
0
-
PrivPassword: string
The SNMP v3 user privacy password.Example:
*****
-
PrivProtocol: string
The SNMP v3 privacy protocol.Example:
oracle.doceng.json.BetterJsonNull@12eaa2cd
-
SecurityLevel: integer
The SNMP security level for SNMP v3 authentication. Allowed values are:
- 0: Not Applicable
- 1: No Authentication and No Privacy
- 2: Authentication and No Privacy
- 3: Authentication and Privacy
Example:oracle.doceng.json.BetterJsonNull@20f6b6e0
-
SNMPPort: integer
The SNMP UDP port. The default is 161.Example:
161
-
SNMPVersion: integer
The SNMP version. Allowed values are:
- 1
- 2
- 3
Example:2
-
Username: string
The SNMP v3 user name.Example:
oracle.doceng.json.BetterJsonNull@3a45308f
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 SNMP access profile.
-
total: integer
The total number of results regardless of paging.Example:
1
Nested Schema : discoverySNMPRead
Type:
Show Source
object
-
AuthPassword: string
The SNMP v3 user authentication password.Example:
*****
-
AuthProtocol: string
The SNMP v3 authentication protocol.Example:
oracle.doceng.json.BetterJsonNull@13809363
-
Community: string
The SNMP v1 or v2 community string.Example:
public
-
Description: string
The SNMP Access Profile description.Example:
Default Public
-
DeviceCount: integer
The number of devices that match the SNMP access profile.Example:
0
-
DeviceSNMPAccessID: integer
The device SNMP access ID.Example:
1
-
DeviceZoneID: integer
The device zone ID.Example:
1
-
DeviceZoneName: string
The device zone name.Example:
Default First Zone
-
EngineID: integer
The engine ID. The default is 1.Example:
oracle.doceng.json.BetterJsonNull@c7cf8c4
-
MTU: integer
The maximum transmission unit (MTU) size. The default value is 1472 bytes.Example:
1472
-
PriorityOrder: integer
The profile priority order. A lower value means a higher priority, the lowest value is first in the order.Example:
0
-
PrivPassword: string
The SNMP v3 user privacy password.Example:
*****
-
PrivProtocol: string
The SNMP v3 privacy protocol.Example:
oracle.doceng.json.BetterJsonNull@12eaa2cd
-
SecurityLevel: integer
The SNMP security level for SNMP v3 authentication. Allowed values are:
- 0: Not Applicable
- 1: No Authentication and No Privacy
- 2: Authentication and No Privacy
- 3: Authentication and Privacy
Example:oracle.doceng.json.BetterJsonNull@20f6b6e0
-
SNMPPort: integer
The SNMP UDP port. The default is 161.Example:
161
-
SNMPVersion: integer
The SNMP version. Allowed values are:
- 1
- 2
- 3
Example:2
-
Username: string
The SNMP v3 user name.Example:
oracle.doceng.json.BetterJsonNull@3a45308f
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.