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
etSHA-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
etAES-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