REST API - get
  1. Operations
  2. appliance
  3. techpreview
  4. monitoring
  5. snmp

appliance techpreview monitoring snmp: get

Return an SNMP agent configuration.

Request:

HTTP request

GET https://{server}/rest/appliance/techpreview/monitoring/snmp
No request parameters

Response:

HTTP Status Code: 200

Representation:

{
    "value" : {
        "syslocation" : "string",
        "syscontact" : "string",
        "privacy" : "AES128",
        "notraps" : [
            "string",
            "string"
        ],
        "pid" : "string",
        "remoteusers" : [
            {
                "privacy" : "AES128",
                "auth_key" : "string",
                "sec_level" : "none",
                "priv_key" : "string",
                "username" : "string",
                "authentication" : "none",
                "engineid" : "string"
            },
            {
                "privacy" : "AES128",
                "auth_key" : "string",
                "sec_level" : "none",
                "priv_key" : "string",
                "username" : "string",
                "authentication" : "none",
                "engineid" : "string"
            }
        ],
        "targets" : [
            {
                "port" : 1,
                "ip" : "string",
                "community" : "string"
            },
            {
                "port" : 1,
                "ip" : "string",
                "community" : "string"
            }
        ],
        "users" : [
            {
                "auth_key" : "string",
                "sec_level" : "none",
                "priv_key" : "string",
                "username" : "string"
            },
            {
                "auth_key" : "string",
                "sec_level" : "none",
                "priv_key" : "string",
                "username" : "string"
            }
        ],
        "v3targets" : [
            {
                "port" : 1,
                "ip" : "string",
                "type" : "inform",
                "sec_level" : "none",
                "user" : "string"
            },
            {
                "port" : 1,
                "ip" : "string",
                "type" : "inform",
                "sec_level" : "none",
                "user" : "string"
            }
        ],
        "port" : 1,
        "enable" : true,
        "loglevel" : "string",
        "authentication" : "none",
        "communities" : [
            "string",
            "string"
        ],
        "engineid" : "string"
    }
}

Response Type:

Name Type Description
bold = required
value SNMP_config_read_only SNMP config structure.
value.authentication string Set the default authentication protocol. Values can be none, MD5, or SHA1.

Defines SNMP authentication protocols Value is one of:
none: NONE
SHA1: SHA1
MD5: MD5
value.communities string[] Set up to ten communities, each of no more than 64 characters long. The format is: community1[,community2,...]. This setting overwrites any previous settings.
value.enable boolean Set enable to true/false
value.engineid string Set SNMPv3 engine ID.
value.loglevel string System Agent syslog logging level: debug|info|warning|error.
value.notraps string[] Comma-separated list of trap OIDs (object identifiers) for traps not to be sent by the agent. Use 'reset' to clear the setting.
value.port long Set up a UDP port which the SNMP agent uses to listen on for polling requests. The default UDP port is 161.
value.privacy string Set the default privacy protocol.

Defines SNMP privacy protocols Value is one of:
AES128: AES128
none: NONE
value.syscontact string System contact string as presented in sysContact.0. Up to 255 characters long.
value.syslocation string System location string as presented in sysLocation.0. Up to 255 characters long.
value.targets SNM_pv1_trap_target[] Set up to three targets to which to send SNMPv1 traps.
value.users SNMP_user[] Set up to five local users.
value.remoteusers SNMP_remote_user[] Set up remote users.
value.v3targets SNM_pv3_target[] Set up to three SNMPv3 notification targets. Format is: ip-or-hostname[@port]/remote-user/security-level/trap|inform[,...].
value.pid string Set up pid

Errors:

HTTP Status Code Type Description
500 error Generic error