# 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:

    - Authorization – Les identifiants de l’utilisateur

  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