Modifier le serveur SNMP

PUT /api/snmp/server

Modifie la configuration du serveur SNMP. Si le serveur existe déjà, les champs omis resteront inchangés. Si le serveur SNMP n’existe pas, il sera créé.

En-têtes de requête:
Objet JSON de requête:
  • localUDPAddress (string) – L’adresse UDP locale du serveur (port inclus).

  • community (string) – [SNMPv2 uniquement] La valeur de communauté (ou mot de passe) du serveur. Par défaut, la valeur « public » est utilisée.

  • v3Only (bool) – Indique si le serveur ne doit accepter uniquement que les requêtes SNMPv3. Par défaut, le serveur accepte SNMPv2 et SNMPv3.

  • v3Username (string) – [SNMPv3 uniquement] Le nom d’utilisateur.

  • v3AuthProtocol (string) – [SNMPv3 uniquement] L’algorithme d’authentification utilisé. Les valeurs acceptées sont : MD5, SHA, SHA-224, SHA-256, SHA-384 et SHA-512.

  • v3AuthPassphrase (string) – [SNMPv3 uniquement] La passphrase d’authentification.

  • v3PrivProtocol (string) – [SNMPv3 uniquement] L’algorithme de confidentialité utilisé. Les valeurs acceptées sont : DES, AES, AES-192, AES-192C, AES-256 et AES-256C.

  • v3PrivPassphrase (string) – [SNMPv3 uniquement] La passphrase de confidentialité.

Status Codes:
  • 201 Created – Le serveur a été créé/modifié avec succès

  • 400 Bad Request – Un ou plusieurs des paramètres de la requête sont invalides

  • 401 Unauthorized – Authentification d’utilisateur invalide

En-têtes de réponse:
  • Location – Le chemin d’accès au serveur SNMP.

Exemple de requête

PUT https://my_waarp_gateway.net/api/snmp/server HTTP/1.1
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
Content-Length: 242

{
    "localUDPAddress": "0.0.0.0:161"
    "community": "public"
    "v3Only": false
    "v3Username": "waarp"
    "v3AuthProtocol": "SHA-256"
    "v3AuthPassphrase": "sesame"
    "v3PrivProtocol": "AES-256"
    "v3PrivPassphrase": "foobar"
}

Exemple de réponse

HTTP/1.1 201 CREATED
Location: https://my_waarp_gateway.net/api/snmp/server