IAM Actions:Create Group

Search (SHIFT+S)

ECS Management API

ECS Object Service API

ECS API Changes

Create Group

POST /iam?Action=CreateGroup

Creates a new IAM Group in the caller's namespace or x-emc-namespace header if provided.

Query Parameters

GroupName	The name of the group to create.
Path	The path for the group. Optional, defaults to "/" and only "/" is allowed.

Required Roles

This call has no restrictions.

Request Payload

No Request Payload

Response Body

Field	Description	Type	Notes
CreateGroupResponse
CreateGroupResult
Group
GroupName	Simple name identifying the Group.	String
Arn	Arn that identifies the Group.	String
GroupId	Unique Id associated with the Group.	String
Path	The path to the IAM Group.	String
CreateDate	ISO 8601 format DateTime when group was created.	String
ResponseMetadata
RequestId		String

Examples

Request

POST https://192.168.0.0::4443/iam?GroupName=iamFinanceGroup2&Path=/&Action=CreateGroup
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
x-emc-namespace: <namespace>

Response

HTTP/1.1 200 OK
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:CreateGroupResponse xmlns:ns2="none">
    <ResponseMetadata>
        <RequestId>0af9f5b8:171648dacb1:1ad3a:0</RequestId>
    </ResponseMetadata>
    <CreateGroupResult>
        <Group>
            <Arn>urn:ecs:iam::ns:group/iamFinanceGroup2</Arn>
            <CreateDate>2020-04-13T19:56:39Z</CreateDate>
            <GroupId>AGPAC470F6C1E9E196E1</GroupId>
            <GroupName>iamFinanceGroup2</GroupName>
            <Path>/</Path>
        </Group>
    </CreateGroupResult>
</ns2:CreateGroupResponse>

Request

POST https://192.168.0.0::4443/iam?GroupName=iamFinanceGroup&Path=/&Action=CreateGroup
Accept: application/json
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
x-emc-namespace: <namespace>

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
    "ResponseMetadata": {
        "RequestId": "0af9f5b8:171648dacb1:19ea1:d"
    },
    "CreateGroupResult": {
        "Group": {
            "GroupName": "iamFinanceGroup",
            "Arn": "urn:ecs:iam::ns:group/iamFinanceGroup",
            "GroupId": "AGPA6CBEB03207E74FF2",
            "Path": "/",
            "CreateDate": "2020-04-13T19:04:45Z"
        }
    }
}

Request

curl -H $token -H "Content-Type: application/xml" -H "x-emc-namespace: <namespace>" -X POST https://$nodeIp:4443/iam?GroupName=iamFinanceGroup2&Path=/&Action=CreateGroup

Response

HTTP/1.1 200 OK
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:CreateGroupResponse xmlns:ns2="none">
    <ResponseMetadata>
        <RequestId>0af9f5b8:171648dacb1:1ad3a:0</RequestId>
    </ResponseMetadata>
    <CreateGroupResult>
        <Group>
            <Arn>urn:ecs:iam::ns:group/iamFinanceGroup2</Arn>
            <CreateDate>2020-04-13T19:56:39Z</CreateDate>
            <GroupId>AGPAC470F6C1E9E196E1</GroupId>
            <GroupName>iamFinanceGroup2</GroupName>
            <Path>/</Path>
        </Group>
    </CreateGroupResult>
</ns2:CreateGroupResponse>