グループの追加 (POST /v3/groups)
グループを追加する。
マルチリージョンを利用する顧客がローカル利用者管理で本APIを実行した場合、403エラーとなる。
追加したグループが全リージョンに反映されるまで、最大10分程度が必要となる。
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
group
groupオブジェクト（必須項目）
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| Element | 1..1 | なし | description
domain_id name |
description
グループの説明
入力値
- 最大255文字
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| xsd:string | 0..1 | group | None |
domain_id
ドメインID（必須項目）
省略時した場合、デフォルトドメインが入力される。
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| xsd:string | 1..1 | group | None |
name
グループ名（必須項目）
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| xsd:string | 1..1 | group | None |
Response Headers
HTTPステータスコード
リクエストのHTTPステータスコードを返却する。
以下の値を返却する。
- 201：
- 正常終了
- 400：
- リクエスト形式に誤りがある。
必須パラメーターが指定されていない等。
- 401：
- トークンが有効ではない。
- 403：
- 要求されたアクションを実行する権限がない。
- 404：
- 指定されたdomain_idが見つからない。
- 500：
- 内部エラーが発生。
- 504：
- 一定時間内に処理が完了しなかった。
| Data Type | Cardinality |
|---|---|
| int | 1..1 |
Response Elements
group
groupオブジェクト
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| Element | 1..1 | なし | description
domain_id id links name |
description
グループの説明
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| xsd:string | 1..1 | group | None |
domain_id
ドメインID
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| xsd:string | 1..1 | group | None |
id
グループID
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| xsd:string | 1..1 | group | None |
links
グループのリンク情報
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| Element | 1..1 | group | self |
name
グループ名
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| xsd:string | 1..1 | group | None |
Example of Request
{
"group": {
"description": " Developers cleared for work on secret projects",
"domain_id": "--domain-id--",
"name": " Secure Developers"
}
}
Example of Response
{
"group": {
"description": "Developers cleared for work on secret projects",
"domain_id": "--domain-id--",
"id": "--group-id--",
"links": {
"self": "http://identity.gls.cloud.global.fujitsu.com/v3/groups/--group-id--"
},
"name": "Secure Developers"
}
}