REST API - set

appliance techpreview monitoring snmp: set

Set SNMP configuration.

Request:

HTTP request

PUT https://{server}/rest/appliance/techpreview/monitoring/snmp

Request Body Structure:

{
    "config"{
        "syslocation""string",
        "syscontact""string",
        "privacy""AES128",
        "notraps"[
            "string",
            "string"
        ],
        "remoteusers"[
            "string",
            "string"
        ],
        "targets"[
            "string",
            "string"
        ],
        "users"[
            "string",
            "string"
        ],
        "v3targets"[
            "string",
            "string"
        ],
        "port"1,
        "loglevel""string",
        "authentication""none",
        "communities"[
            "string",
            "string"
        ],
        "engineid""string"
    }
}

Request Body Parameters:

Name Type Description
bold = required
config SNMP_config SNMP configuration.
config.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

config.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.

config.engineid string Set SNMPv3 engine ID. The engine ID must contain 5 to 32 hexadecimal characters. "0x" and colon (:) are removed from the ID.

config.loglevel string System Agent syslog logging level: debug|info|warning|error.

config.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.

config.port long Set up a UDP port which the SNMP agent uses to listen on for polling requests. The default UDP port is 161.

config.privacy string Set the default privacy protocol. Values: none or AES128.

Defines SNMP privacy protocols Value is one of:
AES128: AES128
none: NONE

config.remoteusers string[] Set up to five inform user IDs. The format is: user/auth-proto/-|auth-hash/priv-proto/-|priv-hash/engine-id[,...]. Here, user must be maximum 32 characters long; auth-proto is none, MD5 or SHA1; priv-proto is none or AES; '-' indicates no hash; engine-id is a hexadecimal string '0x0-9a-f' and must be up to 32 characters long.

config.syscontact string System contact string as presented in sysContact.0. Up to 255 characters long.

config.syslocation string System location string as presented in sysLocation.0. Up to 255 characters long.

config.targets string[] Set up to three targets to which to send SNMPv1 traps. The format is: ip-or-hostname[@port]/community[,...]. The default port is UDP 162. This setting overwrites any previous settings.

config.users string[] Set up to five local users. The format is: user/-|auth-hash/-|priv-hash/model[,...]. Here user is maximum 32 characters long; '-' indicates no hash; model is one of none, auth or priv.

config.v3targets string[] Set up to three SNMPv3 notification targets. Format is: ip-or-hostname[@port]/remote-user/security-level/trap|inform[,...].

Response:

HTTP Status Code: 200

None

Errors:

HTTP Status Code Type Description
500 error Generic error