PowerScale OneFS API Reference

Create a session

You can authenticate to a OneFS API resource URI by creating a session cookie and a session. When you create a session, you extend your authentication to a node for multiple requests over a time.

1. Send a POST request to /session/1/session by specifying the JSON content-type in the request header. Also specify your username, password, and the service that you want to access in the request body. In the services property, specify platform for system configuration or namespace for file system access.

   Content-type: application/json
   Body:
   {
   "username": "<string>",
   "password": "<string>",
   "services": ["platform" | “namespace”]
   }

   If the server validates your username and password, a Set-Cookie header is returned.
2. Obtain the isisessid value from the Set-Cookie header.

   201 Created
   Content-Length:104
   Content-Type:application/json
   Date:Fri, 22 Feb 2013 19:08:36 GMT
   Set-Cookie:isisessid=12345678-abcd-1234-abcd-1234567890ab; path=/;
   HttpOnly; Secure
   Response Body:
   {
   "services":[
   "platform",
   "namespace"
   ],
   "timeout_absolute":14400,
   "timeout_inactive":900,
   "username":"user123"
   }

   This value authenticates the session when you send a request through a session cookie.