Create Group

グループを作成します。

マルチリージョンを利用する顧客がローカル利用者管理で本APIを実行した場合、403エラーとなります。

追加されたグループが他の使用リージョンに同期されるまで一定時間が必要です。

APIエンドポイント

リージョン	APIエンドポイント
西日本リージョン3の場合	https://identity.gls.cloud.global.fujitsu.com
東日本リージョン3の場合	https://identity.gls.cloud.global.fujitsu.com

HTTPメソッドとURI

POST

/v3/groups/

HTTPステータスコード

正常時：201

エラー時：400, 401, 403, 404, 500, 504

リクエストパラメータの説明

名前	In	Type	デフォルト値 /必須指定	Description
Content-type	header	string	必須	MIME仕様で定義されているコンテントの形式を示します。 「application/json」を指定します。
Accept	header	string	任意	MIME仕様で定義されているアクセプトの形式を示します。 「application/json」を指定します（省略可）。
X-Auth-Token	header	string	必須	有効な認証トークン
group	body	object	必須	グループオブジェクト
description	body	string	任意	グループの説明 最大255文字
domain_id	body	string	必須	ドメインID 省略した場合、デフォルトドメインが入力されます。
name	body	string	必須	グループ名

レスポンスボディ（正常系）の説明

名前	Type	Description
group	object	グループオブジェクト
description	string	グループの説明
domain_id	string	ドメインID
id	string	グループID
links	object	グループへのリンク情報
name	string	グループ名

リクエスト例

      {
         "group": {
           "description": " Developers cleared for work on secret projects",
           "domain_id": "--domain-id--",
           "name": " Secure Developers"
         }
       }

レスポンス例

      {
         "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"
         }
       }