ログインセッション

空の POST リクエストは、新しいログインセッションをリクエストします。成功すると、使用可能な RESTful API サービスのリストが格納された単一プロパティー「access」を持つ JSON オブジェクトとともに、HTTP ステータス 201 が返されます。

ログインリクエストの例:

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

ログインに成功すると、HTTP ステータス 201 (Created) と、X-Auth-Session HTTP ヘッダーを介してセッション ID を返します。レスポンス本文には、このログインを介してアクセス可能なサービスのリストが含まれます。

レスポンスヘッダー:

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

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