API V3バージョン情報の表示　(GET /v3/)

Request Headers

Content-type

MIME仕様で定義されているコンテントの形式を示す。

application/jsonを指定する。（必須項目）

Data Type	Cardinality
xsd:string	1..1

Accept

MIME仕様で定義されているアクセプトの形式を示す。

application/jsonを指定する。（省略可）

Data Type	Cardinality
xsd:string	1..1

Request Parameter

なし

Response Headers

HTTPステータスコード

リクエストのHTTPステータスコードを返却する。

以下の値を返却する。

200：: 正常終了
400：: 不正なアクセス（パラメーター不正等）
401：: 認証エラー
403：: アクセス不可(権限がない)
404：: 該当資源なし
409：: データ競合が発生
500：: 予期せぬエラー
501：: 実装されていない
503：: サービス利用不可

Data Type	Cardinality
int	1..1

Vary

以下のヘッダーを設定または変更することで、別のファイル形式で表現を要求できることを通知する。

X-Auth-Token

Data Type	Cardinality
xsd:string	1..1

Content-Type

MIME仕様で定義されているコンテントの形式を示す。

application/json

Data Type	Cardinality
xsd:string	1..1

Content-Length

エンティティの長さをバイトで示す。

Data Type	Cardinality
int	1..1

Date

作成された日付を示す。

Data Type	Cardinality
date	1..1

Response Elements

version

versionオブジェクト

Data Type	Cardinality	Parent Element	Child Element(s)
Element	1..1	なし	status updated media-types id links

Data Type

Cardinality

Parent Element

Child Element(s)

Element

1..1

なし

status

updated

media-types

id

links

status

バージョンのステータス

stable：: 安定
experimental：: まだ安定版ではない

Data Type	Cardinality	Parent Element	Child Element(s)
xsd:string	1..1	version	None

updated

最終更新日時

Data Type	Cardinality	Parent Element	Child Element(s)
xsd:string	1..1	version	None

media-types

media-typesオブジェクト

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

(media-type)

media-typeオブジェクト（無名オブジェクト）

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

base

サポートメディアのbase

Data Type	Cardinality	Parent Element	Child Element(s)
xsd:string	1..1	(media-type)	None

type

サポートメディアのtype

Data Type	Cardinality	Parent Element	Child Element(s)
xsd:string	1..1	(media-type)	None

id

バージョンID

v3.0が設定される。

Data Type	Cardinality	Parent Element	Child Element(s)
xsd:string	1..1	version	None

links

バージョンのリンク情報

Data Type	Cardinality	Parent Element	Child Element(s)
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"
            }
        ]
    }
}

API V3バージョン情報の表示 (GET /v3/)