IAM Actions:List Users

Search (SHIFT+S)

ECS Management API

ECS Object Service API

ECS API Changes

List Users

POST /iam?Action=ListUsers

Lists the IAM users in user's namespace or x-emc-namespace header if provided. Path prefix is not supported.

Query Parameters

Marker	Marker is obtained from paginated response from the previous query. Use this only if the response indicates it is truncated.
MaxItems	Indicates the maximum number of elements to be returned in the response.
PathPrefix	Path prefix for filtering the results. Optional, default to "/". Only "/" is allowed.

Required Roles

This call has no restrictions.

Request Payload

No Request Payload

Response Body

Field	Description	Type	Notes
ListUsersResponse
ListUsersResult
Users	Get users		0-* Elements
IsTruncated	A flag that indicates whether there are more items to return.	Boolean
Marker	When isTruncated is true, this element needs to be sent in the Marker parameter for subsequent pagination requests.	String
ResponseMetadata
RequestId		String

Examples

Request

POST https://192.168.0.0::4443/iam?Action=ListUsers

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:ListUsersResponse xmlns:ns2="none">
    <ResponseMetadata>
        <RequestId>0af9f5b8:171648dacb1:1abcc:23</RequestId>
    </ResponseMetadata>
    <ListUsersResult>
        <Users>
            <member>
                <Arn>urn:ecs:iam::ns:user/payroll1</Arn>
                <CreateDate>2020-04-13T18:59:45Z</CreateDate>
                <Path>/</Path>
                <UserId>AIDA4E6FD3D4A86F3768</UserId>
                <UserName>payroll1</UserName>
            </member>
        </Users>
        <IsTruncated>false</IsTruncated>
        <Marker></Marker>
    </ListUsersResult>
</ns2:ListUsersResponse>

Request

POST https://192.168.0.0::4443/iam?Action=ListUsers
Accept: aplication/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:1ad3a:18"
    },
    "ListUsersResult": {
        "Users": [
            {
                "Arn": "urn:ecs:iam::ns:user/payroll1",
                "CreateDate": "2020-04-13T18:59:45Z",
                "Path": "/",
                "UserId": "AIDA4E6FD3D4A86F3768",
                "UserName": "payroll1"
            },
            {
                "Arn": "urn:ecs:iam::ns:user/payroll2",
                "CreateDate": "2020-04-13T19:54:30Z",
                "Path": "/",
                "UserId": "AIDA21BCE6940A8DE1EC",
                "UserName": "payroll2"
            }
        ],
        "IsTruncated": false,
        "Marker": ""
    }
}

Request

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

Response

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

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:ListUsersResponse xmlns:ns2="none">
    <ResponseMetadata>
        <RequestId>0af9f5b8:171648dacb1:1abcc:23</RequestId>
    </ResponseMetadata>
    <ListUsersResult>
        <Users>
            <member>
                <Arn>urn:ecs:iam::ns:user/payroll1</Arn>
                <CreateDate>2020-04-13T18:59:45Z</CreateDate>
                <Path>/</Path>
                <UserId>AIDA4E6FD3D4A86F3768</UserId>
                <UserName>payroll1</UserName>
            </member>
        </Users>
        <IsTruncated>false</IsTruncated>
        <Marker></Marker>
    </ListUsersResult>
</ns2:ListUsersResponse>