Jump to

• Request
• Response
• Examples

Authenticate a user

get

/auth/v1.0/

Authenticates a user with the storage service.

Request

Header Parameters

• X-Auth-Key(optional): string
  The password for the user ID. You must specify either X-Auth-Key or X-Storage-Pass.
• X-Auth-User(optional): string
  The user ID to authenticate. You must specify either X-Auth-User or X-Storage-User. The value for X-Auth-User can contain the friendly user Id or the permanent user id.
• X-Storage-Pass(optional): string
  The password for the user ID. You must specify either X-Auth-Key or X-Storage-Pass.
• X-Storage-User(optional): string
  The user ID to authenticate. You must specify either X-Auth-User or X-Storage-User. The value for X-Storage-User can contain the friendly user Id or the permanent user id.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Authentication succeeded

Headers

• Content-Length: integer
  Minimum Value: 0

  Maximum Value: 0

  Always zero (0) for a successful request.
• Content-Type: string
  The default MIME type for the content.
• Date: string(date-time)
  The transaction date and time.

  The date and time stamp format is ISO 8601:

  CCYY-MM-DDThh:mm:ss±hh:mm

  For example, 2015-08-27T09:49:58-05:00.

  The ±hh:mm value, if included, is the time zone as an offset from UTC. In the previous example, the offset value is -05:00.

• X-Auth-Token: string
  Authentication token
• X-Storage-Token: string
  Storage token
• X-Storage-Url: string(url)
  The storage URL for the account
• X-Trans-Id: string(uuid)
  A unique transaction identifier for this request. Your service provider might need this value if you report a problem.

401 Response

Unauthorized

Headers

• Content-Length: integer
  Minimum Value: 0

  The length of the error text in the response body.
• Content-Type: string
  The MIME type of the error text in the response body.

Back to Top

Examples

cURL Command

The following example shows how to get an authentication token for a user in Oracle Cloud Infrastructure Object Storage Classic by submitting a GET request on the REST resource using cURL. For more information about cURL, see Use cURL.

curl -v -X GET \
     -H "X-Storage-User: myservice-bar:myUsername" \
     -H "X-Storage-Pass: myPassword" \
     https://foo.storage.oraclecloud.com/auth/v1.0

Sample Response

The following is a sample response of this command:

HTTP/1.1 200 OK
Date: Fri, 06 Mar 2015 11:44:29 GMT
X-Storage-Url: https://foo.storage.oraclecloud.com/v1/myservice-bar
X-Storage-Token: AUTH_tk209f7f2ea1265a0d3f29d28a2dc8ced6
X-Auth-Token: AUTH_tk209f7f2ea1265a0d3f29d28a2dc8ced6
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx23a1084b8c674fdeae8d4-0054f982ac

Back to Top