6.4.2. IAMグループを作成する

IAMロールやユーザーと紐付けるIAMグループを作成します。IAMグループ作成時のエンドポイントとパラメータは以下のとおりです。
エンドポイント
POST {api_endpoint}/api/v2/iam/groups
パラメータ
contract_id(任意) システム契約ID(デフォルトではAPI実行ユーザーのシステム契約ID)
iam_group_name IAMグループの名前
description(任意) IAMグループの説明

管理機能のGET操作を許可するIAMグループ作成のリクエストボディと、実際のリクエスト例は以下のとおりです。

 {
     "contract_id": "econXXXXXXXXX",
     "iam_group_name": "sss_get_group",
     "description": "管理機能のGET操作を許可するグループ"
}
curl -1 -i -X POST \
-H "X-Auth-Token:d62c36383ec14532a325387da7149373" \
-H "Content-Type:application/json" \
-d \
'{
     "contract_id": "econXXXXXXXXX",
     "iam_group_name": "sss_get_group",
     "description": "管理機能のGET操作を許可するグループ"
 }' https://sss-jp1-ecl.api.ntt.com/api/v2/iam/groups
IAMグループ作成成功時のレスポンス例
IAMグループ作成成功時にレスポンスとして返ってくる iam_group_id は、IAMロールやユーザーとの紐付け・紐付け解除の際に必要となります。
HTTP/1.1 201 Created
Date: Wed, 17 Aug 2016 02:19:35 GMT
Content-Type: application/json
Content-Length: 155
Connection: keep-alive
Set-Cookie: TS0183560f=01cce65ce1cca6bcd11f9c77577dsf99e3fd13f01375ed8d06e2ea709491f357fd560a3f74; Path=/

{"contract_id":"econXXXXXXXXX","iam_group_id":"09d98eda-6421-11e6-9827-e1e34fb8c324","iam_group_name":"sss_get_group","description":"管理機能のGET操作のグループ"}