API ReferenceNew CentralGuidesMRT APIConfiguration API
GithubAirheads Developer Community
API Reference

Update existing SNMP profile configurations

SNMP profile to configure SNMP parameters.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
length ≤ 9999

SNMP profile name.

Query Params
string

LOCAL - To update local objects. SHARED - To update shared objects. Default - Defaults to SHARED if not provided

string

Scope at which local object needs to be updated. Mandatory if object-type = LOCAL. Should not be provided for object-type = SHARED.

string

Device function for which the local object needs to be updated. Mandatory if object_type = LOCAL. Should not be provided for object_type = SHARED.

Body Params

profilebody object

group
array of objects
length ≤ 2147483647

SNMPv3 User to Group entry.

group
string
enum

SNMP access restrictions for the ieee8021mib MIB

Show Details
ALLOWAllow the unsecured access to this MIB.
BLOCKBlock the unsecured access to this MIB.
Allowed:
string
enum

SNMP access restrictions for the hpicfMACsec MIB

Show Details
ALLOWAllow the unsecured access to this MIB.
BLOCKBlock the unsecured access to this MIB.
Allowed:
notify-group
array of objects
length ≤ 2147483647

List of SNMPv3 notify groups.

notify-group
param
array of objects
length ≤ 2147483647

List of SNMPv3 params.

param
string
enum

SNMP access restrictions for the switchauthmib MIB

Show Details
EXCLUDEMIB subtree excluded in SNMP view.
INCLUDEMIB subtree included in SNMP view.
Allowed:
target
array of objects
length ≤ 2147483647

List of SNMPv3 targets.

target
v3-community
array of objects
length ≤ 2147483647

List of SNMPv3 community.

v3-community
int32
0 to 65535
Defaults to 161

The SNMP server agent port

boolean

SNMPv3 Security Level.

boolean

SNMPv3 Security Level.

community
array of objects
length ≤ 2147483647

List of SNMP communities.

community
context
array of objects
length ≤ 2147483647

List of SNMP contexts.

context
string
length between 1 and 256

SNMP profile description.

boolean

Enables only the SNMPv3 mode of operation and disallows SNMP v1 and v2c.

int32
100 to 350
Defaults to 250

To set inform queue length. By default inform queue length set to 250.

string
enum

SNMP server listen mode.

Show Details
BOTHEnable SNMP Server on both OOBM and Data planes.
DATAEnable SNMP Server on Data Plane only.
MANAGEMENT_INTERFACEEnable SNMP Server on Management Interface only.
Allowed:
int32
0 to 255

Loopback interface.

string
length between 1 and 256

SNMP profile name.

notification-receiver
array of objects
length ≤ 2147483647

List of SNMP Notification receivers (traps or informs).

notification-receiver
remote-user
array of objects
length ≤ 2147483647

List of users on a remote SNMP engine who receives the inform notifications.

remote-user
length ≤ 9999

Source IP address of the SNMP response PDU.

boolean
Defaults to false

Enable SNMPv1 and SNMPv2c access properties.

snmp-response-source
array of objects
length ≤ 2147483647

Source IP/interface for SNMP responses

snmp-response-source
boolean
Defaults to false

On enabling this parameter source address of SNMP responses will be set to Controller IP.

snmp-trap-source
array of objects
length ≤ 2147483647

Source IP/interface for SNMP traps

snmp-trap-source
boolean
Defaults to false

Enable SNMP stats.

boolean
Defaults to true

To enable SNMP traps in system. By default traps are enabled.

int32
0 to 255

Loopback interface.

length ≤ 9999

Source address of SNMP notification responses.
Only ip-address type is supported for gateways

boolean

Enable SNMP unique request-id check.

user
array of objects
length ≤ 2147483647

List of SNMPv3 users.

user
boolean
Defaults to true

SNMPv1 version.

boolean
Defaults to true

SNMPv2c Version.

boolean
Defaults to false

SNMPv3 version.

view
array of objects
length ≤ 2147483647

List of SNMP MIB views.

view
vrf
array of strings
length ≤ 2147483647
vrf
int32
0 to 255

VRRP instance ID. This enables to use VRRP IP address
as source address in SNMP traps.
Only VRRP-ID or IP address as SNMP trap-source can be configured and not both.

Responses

Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json