プロジェクトの追加 (POST /v3/projects)

プロジェクトを追加する。

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

X-Auth-Token

有効な認証トークン

Data Type Cardinality
xsd:string 1..1

Request Parameter

project

projectオブジェクト(必須項目)

Data Type Cardinality Parent Element Child Element(s)
Element 1..1 なし description

domain_id

enabled

name

description

プロジェクトの説明

入力値
  • 最大255文字
Data Type Cardinality Parent Element Child Element(s)
xsd:string 0..1 project None

domain_id

ドメインID(必須項目)

省略時はデフォルトドメインが指定されたことになるため、利用者は必ず指定する必要がある。

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

enabled

有効設定

省略時は有効が設定される

入力値
  • 有効:true
  • 無効:false
Data Type Cardinality Parent Element Child Element(s)
xsd:boolean 0..1 project None

name

プロジェクト名(必須項目)

入力値
  • 4~64文字
  • 半角英数字および以下の記号が使用可能

    プラス(+)、等号(=)、カンマ(,)、ピリオド(.)、アットマーク(@)、ダッシュ(-)、アンダーバー(_)

  • 大文字小文字の区別なし
Data Type Cardinality Parent Element Child Element(s)
xsd:string 1..1 project None

Response Headers

HTTPステータスコード

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

以下の値を返却する。

201:
正常終了
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

project

projectオブジェクト

Data Type Cardinality Parent Element Child Element(s)
Element 1..1 なし description

domain_id

enabled

id

links

name

description

プロジェクトの説明

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

domain_id

ドメインID

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

enabled

有効設定

Data Type Cardinality Parent Element Child Element(s)
xsd:boolean 1..1 project project

id

プロジェクトID

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

links

プロジェクトのリンク情報

Data Type Cardinality Parent Element Child Element(s)
Element 1..1 project self

name

プロジェクト名

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

Example of Request


POST /v3/projects
X-Auth-Token: MIIIHgYJKoZIhvcNAQcCoIIIDzCCCAsCAQExC(省略)

{
    "project": {
        "description": "my create project",
        "domain_id": "--domain-id--",
        "enabled": true,
        "name": "projectname"
    }
}       
     

Example of Response


HTTP/1.1 201 Created
Vary: X-Auth-Token
Content-Type: application/json
Content-Length: 258
Date: Tue, 02 Sep 2014 01:13:18 GMT

{
    "project": {
        "description": "my create project",
        "domain_id": "--domain-id--",
        "enabled": true,
        "id": "--project-id--",
        "links": {
            "self": "http://identity.jp-east-1.cloud.global.fujitsu.com/v3/projects/--project-id--"
        },
        "name": "projectname"
    }
}