Lister les comptes locaux

GET /api/servers/(string: server_name)/accounts

Renvoie une liste des comptes du serveur donné en fonction des paramètres fournis.

En-têtes de requête:

• Authorization – Les identifiants de l’utilisateur

Paramètres:

• limit (int) – Le nombre maximum de résultats souhaités (défaut: 20)

• offset (int) – Le numéro du premier résultat souhaité (défaut: 0)

• sort ([login+|login-]) – Le paramètre selon lequel les comptes seront triés (défaut: login+)

Status Codes:

• 200 OK – La liste a été renvoyée avec succès

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

• 401 Unauthorized – Authentification d’utilisateur invalide

Objet JSON de réponse:

• localAccounts (array) – La liste des comptes demandés

Tableau d’objets JSON de réponse:

• login (string) – Le login du compte

• authMethods (array) – La liste des valeurs utilisées par le client pour s’authentifier auprès de la gateway quand il se connecte à celle-ci.

• authorizedRules (object) –

  Les règles que le compte est autorisé à utiliser pour les transferts.

  • sending (array of string) - Les règles d’envoi.

  • reception (array of string) - Les règles de réception.

• ipAddresses (array) – Une liste des adresses IP autorisées pour le compte.

Exemple de requête

GET https://my_waarp_gateway.net/api/servers/sftp_server/accounts?limit=10&sort=name- HTTP/1.1
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

Exemple de réponse

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 147

{
  "localAccounts": [{
    "login": "tutu",
    "authMethods": ["password"],
    "authorizedRules": {
      "sending": ["règle_envoi_1", "règle_envoi_2"],
      "reception": ["règle_récep_1", "règle_récep_2"]
    },
    "ipAddresses": ["1.2.3.4", "5.6.7.8"]
  },{
    "login": "toto",
    "authMethods": ["password", "toto_public_key"],
    "authorizedRules": {
      "sending": ["règle_envoi_1", "règle_envoi_2"],
      "reception": ["règle_récep_1", "règle_récep_2"]
    }
  }]
}