IAM Actions:Create User

Search (SHIFT+S)

ECS Management API

ECS Object Service API

ECS API Changes

Create User

POST /iam?Action=CreateUser

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

Query Parameters

UserName	The name of the user to create.
Path	The path for the user. Optional, defaults to "/" and only "/" is allowed.
PermissionsBoundary	The ARN of the policy that is used to set the permissions boundary for the user.
Tags	A list of tags that you want to attach to the user being created.

Required Roles

This call has no restrictions.

Request Payload

No Request Payload

Response Body

Field	Description	Type	Notes
CreateUserResponse
CreateUserResult
User
Arn	Arn that identifies the user.	String
CreateDate	ISO 8601 format DateTime when user was created.	String
PasswordLastUsed	ISO 8601 DateTime when the password was last used.	String
Path	The path to the IAM User.	String
PermissionsBoundary
PermissionsBoundaryArn	The ARN of the policy set as permissions boundary.	String
PermissionsBoundaryType	The permissions boundary usage type that indicates what type of IAM resource is used as the permissions boundary for an entity. This data type can only have a value of Policy.	String
Tags	The list of Tags associated with the User.		0-* Elements
UserId	Unique Id associated with the User.	String
UserName	Simple name identifying the User.	String
ResponseMetadata
RequestId		String

Examples

Request

POST https://192.168.0.0:4443/iam?UserName=payroll2&Path=/&Tags.member.1.Key=Department&Tags.member.1.Value=Finance&Action=CreateUser
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:CreateUserResponse xmlns:ns2="none">
    <ResponseMetadata>
        <RequestId>0af9f5b8:171648dacb1:1a9f0:70</RequestId>
    </ResponseMetadata>
    <CreateUserResult>
        <User>
            <Arn>urn:ecs:iam::ns:user/payroll2</Arn>
            <CreateDate>2020-04-13T19:54:30Z</CreateDate>
            <Path>/</Path>
            <UserId>AIDA21BCE6940A8DE1EC</UserId>
            <UserName>payroll2</UserName>
        </User>
    </CreateUserResult>
</ns2:CreateUserResponse>

Request

POST https://192.168.0.0:4443/iam?UserName=payroll1&Path=/&Tags.member.1.Key=Department&Tags.member.1.Value=Finance&Action=CreateUser
Content-Type: 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:19c8c:48"
    },
    "CreateUserResult": {
        "User": {
            "Arn": "urn:ecs:iam::ns:user/payroll1",
            "CreateDate": "2020-04-13T18:59:45Z",
            "Path": "/",
            "UserId": "AIDA4E6FD3D4A86F3768",
            "UserName": "payroll1"
        }
    }
}

Request

curl -H $token -H "Content-Type: application/xml" -H "x-emc-namespace: <namespace>" -X POST https://$nodeIp:4443/iam?UserName=payroll2&Path=/&Tags.member.1.Key=Department&Tags.member.1.Value=Finance&Action=CreateUser

Response

HTTP/1.1 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:CreateUserResponse xmlns:ns2="none">
    <ResponseMetadata>
        <RequestId>0af9f5b8:171648dacb1:1a9f0:70</RequestId>
    </ResponseMetadata>
    <CreateUserResult>
        <User>
            <Arn>urn:ecs:iam::ns:user/payroll2</Arn>
            <CreateDate>2020-04-13T19:54:30Z</CreateDate>
            <Path>/</Path>
            <UserId>AIDA21BCE6940A8DE1EC</UserId>
            <UserName>payroll2</UserName>
        </User>
    </CreateUserResult>
</ns2:CreateUserResponse>