Creating IAM GroupΒΆ

Create IAM Group that links to IAM Role or an user. The end point and parameters below are used:
End point:
POST {api_endpoint}/api/v2/iam/groups
Parameter

contract_id (optional):

Contract ID (at default, the API execution user's Contract ID).

iam_group_name:

Name of IAM Group

description (optional):

Explanation about IAM Group.

Examples of a request body that creates the IAM Group allowing GET operation of Management Function and its actual request:

 {
     "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
Example of the response at successful IAM Group creating:
The response iam_group_id , which appears when the IAM Group is successfully created, is necessary when linking it with IAM Role or the user and deleting this.
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"}