Connexion à session

Une demande POST vide invoque une nouvelle session de connexion. En cas de réussite, un statut HTTP de 201 est renvoyé avec un objet JSON possédant un accès de propriété unique et contenant une liste des services de l'API RESTful disponibles.

Exemple de demande de connexion :

POST /api/access/v1 HTTP/1.1
Host: zfs-storage.example.com
X-Auth-User: root
X-Auth-Key: letmein-xxx

En cas de réussite de la connexion, le code de statut HTTP 201 (Created) est renvoyé avec un ID de session via l'en-tête HTTP X-Auth-Session. Le corps du texte de la réponse contient une liste des services accessibles via cette connexion.

En-tête de réponse :

HTTP/1.1 201 Created
X-Auth-Session: guigqpQRE4g89ngb
Content-Type: application/json
Content-Length: 378
X-Zfssa-Access-Api: 1.0

{
    "access": {
        "services":[{
            ...
        }]
    }
}