IAM Actions:Get User

Search (SHIFT+S)

ECS Management API

ECS Object Service API

ECS API Changes

Get User

POST GetUser

Returns the information about the specified IAM User in the caller's namespace or x-emc-namespace header if provided.

Query Parameters

UserName	The name of the user to retrieve.

Required Roles

This call has no restrictions.

Request Payload

No Request Payload

Response Body

Field	Description	Type	Notes
GetUserResponse
GetUserResult
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=User1&Action=GetUser
Accept: 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:GetUserResponse xmlns:ns2="none">
    <ResponseMetadata>
        <RequestId>0af9f5b8:17178fe9282:9df1:176</RequestId>
    </ResponseMetadata>
    <GetUserResult>
        <User>
            <Arn>urn:ecs:iam::ns:user/User1</Arn>
            <CreateDate>2020-04-15T15:17:15Z</CreateDate>
            <Path>/</Path>
            <PermissionsBoundary>
                <PermissionsBoundaryArn>urn:ecs:iam:::policy/IAMReadOnlyAccess</PermissionsBoundaryArn>
                <PermissionsBoundaryType>Policy</PermissionsBoundaryType>
            </PermissionsBoundary>
            <Tags/>
            <UserId>AIDA7079A32D6242C3A4</UserId>
            <UserName>User1</UserName>
        </User>
    </GetUserResult>
</ns2:GetUserResponse>

Request

POST https://192.168.0.0:4443/iam?UserName=User1&Action=GetUser
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:17178fe9282:a8f9:0"
    },
    "GetUserResult": {
        "User": {
            "Arn": "urn:ecs:iam::ns:user/User1",
            "CreateDate": "2020-04-15T15:17:15Z",
            "Path": "/",
            "PermissionsBoundary": {
                "PermissionsBoundaryArn": "urn:ecs:iam:::policy/IAMReadOnlyAccess",
                "PermissionsBoundaryType": "Policy"
            },
            "Tags": [],
            "UserId": "AIDA7079A32D6242C3A4",
            "UserName": "User1"
        }
    }
}