List API V3 versions (GET /v3)

Lists information about Identity API v3 versions.

Request headers

Content-type

Indicates the format of content defined in the MIME specification.

Specify application/json. (required)

Data type Cardinality
xsd:string 1..1

Accept

Indicates the accept format defined in the MIME specification.

Specify application/json. (optional)

Data type Cardinality
xsd:string 1..1

Request parameters

None

Response headers

HTTP status code

Returns the HTTP status code of the request.

One of the following values will be returned.

200:
Normal completion
400:
Invalid access (invalid parameter, etc.)
401:
Authentication error
403:
Cannot access (no privileges)
404:
No applicable resources
409:
Data conflict occurred
500:
Unexpected error
501:
Has not been implemented
503:
Cannot use service
Data type Cardinality
int 1..1

Vary

By setting or changing the following header, notification is given that expressions can be requested in a different file format.

X-Auth-Token

Data type Cardinality
xsd:string 1..1

Content-Type

Indicates the format of content defined in the MIME specification.

application/json

Data type Cardinality
xsd:string 1..1

Content-Length

Indicates the length of an entity in bytes.

Data type Cardinality
int 1..1

Date

Indicates the date when the request was created.

Data type Cardinality
date 1..1

Response elements

version

version object

Data type Cardinality Parent element Child element
Element 1..1 None status

updated

media-types

id

links

status

Version status
stable:
Stable
experimental:
Not yet a stable release
Data type Cardinality Parent element Child element
xsd:string 1..1 version None

updated

Last update datetime

Data type Cardinality Parent element Child element
xsd:string 1..1 version None

media-types

media-types object

Data type Cardinality Parent element Child element
Element 1::1 version (media-type)

(media-type)

media-type object (object name is not displayed)

Data type Cardinality Parent element Child element
Element 1::2 (media-types) base

type

base

Support media base

Data type Cardinality Parent element Child element
xsd:string 1..1 (media-type) None

type

Support media type

Data type Cardinality Parent element Child element
xsd:string 1..1 (media-type) None

id

Version ID

Always returns "v3.0".

Data type Cardinality Parent element Child element
xsd:string 1..1 version None

links

Version link information

Data type Cardinality Parent element Child element
xsd:string 1..1 version href

rel

Example of request


GET /v3

Example of response


HTTP/1.1 200 OK
Vary: X-Auth-Token
Content-Type: application/json
Content-Length: 335
Date: Tue, 02 Sep 2014 00:05:22 GMT

{
    "version": {
        "status": "stable",
        "updated": "2013-03-06T00:00:00Z",
        "media-types": [
            {
                "base": "application/json",
                "type": "application/vnd.openstack.identity-v3+json"
            },
            {
                "base": "application/xml",
                "type": "application/vnd.openstack.identity-v3+xml"
            }
        ],
        "id": "v3.0",
        "links": [
            {
                "href": "http://identity.jp-east-1.cloud.global.fujitsu.com/v3/",
                "rel": "self"
            }
        ]
    }
}