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": "Portal READ Only Permission"
}
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": "Portal READ Only Permission"
 }' 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":"Portal READ Only Permission"}