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操作のグループ"}