ListUsers

Last Updated: Aug 26, 2016

Interface description

 Lists all RAM users.

Request parameters

Action

  • Name: Action
  • Type: String
  • Required: Yes
  • Description: Required system parameter. The parameter value is “ListUsers”.

Marker

  • Name: Marker
  • Type: String
  • Required: No
  • Description: If a return result is intercepted, you can use “Marker” to obtain the followed content in the return result.

MaxItems

  • Name: MaxIer
  • Type: Integer
  • Required: No
  • Value range: [1 - 1000]
  • Default value: “100”
  • Description: Quantity of return result items. If a return result is intercepted when it reaches the “MaxItems” restriction, the value of the return parameter IsTruncated will be true.

Return parameters

IsTruncated

  • Type: Boolean
  • Description: Whether a return result is intercepted.

Marker

  • Type: String
  • Description: This parameter is available only when the value of the parameter IsTruncated is true. In this case, you need to invoke this interface and use Marker to obtain the content following the intercepted part in the return result.

Users

  • Type: User Type Array
  • Description: User information set.

Required permissions

Action

ram:ListUsers

Resource

acs:ram:*:${AccountId}:user/*

Operation examples

Request example

  1. https://ram.aliyuncs.com/?Action=ListUsers
  2. &<Public request parameters>

Return example

XML format

  1. <ListUsersResponse>
  2. <RequestId>4B450CA1-36E8-4AA2-8461-86B42BF4CC4E</RequestId>
  3. <Users>
  4. <User>
  5. <UserId>1227489245380721</UserId>
  6. <UserName>zhangqiang</UserName>
  7. <DisplayName>zhangqiang</DisplayName>
  8. <MobilePhone>86-18600008888</MobilePhone>
  9. <Email>zhangqiang@example.com</Email>
  10. <Comments>This is a cloud computing engineer.</Comments>
  11. <CreateDate>2015-01-23T12:33:18Z</CreateDate>
  12. <UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
  13. </User>
  14. <User>
  15. <UserId>1406498224724456</UserId>
  16. <UserName>lili</UserName>
  17. <DisplayName>lili</DisplayName>
  18. <MobilePhone>86-18600009999</MobilePhone>
  19. <Email>lili@example.com</Email>
  20. <Comments>Permission administrator</Comments>
  21. <CreateDate>2015-02-18T17:22:08Z</CreateDate>
  22. <UpdateDate>2015-02-18T17:22:08Z</UpdateDate>
  23. </User>
  24. </Users>
  25. <IsTruncated>true</IsTruncated>
  26. <Marker>EXAMPLE</Marker>
  27. </ListUsersResponse>

JSON format

  1. {
  2. "RequestId" : "4B450CA1-36E8-4AA2-8461-86B42BF4CC4E",
  3. "IsTruncated": true,
  4. "Marker": "EXAMPLE",
  5. "Users" : {
  6. "User" : [
  7. {
  8. "UserId" : "1227489245380721",
  9. "UserName" : "zhangqiang",
  10. "DisplayName": "zhangqiang",
  11. "MobilePhone": "86-18600008888",
  12. "Email": "zhangqiang@example.com",
  13. "Comments": "This is a cloud computing engineer".
  14. "CreateDate" : "2015-01-23T12:33:18Z",
  15. "UpdateDate" : "2015-01-23T12:33:18Z"
  16. },
  17. {
  18. "UserId" : "1406498224724456",
  19. "UserName" : "lili",
  20. "DisplayName": "lili",
  21. "MobilePhone": "86-18600009999",
  22. "Email": "lili@example.com",
  23. "Comments": "Permission administrator"
  24. "CreateDate" : "2015-02-18T17:22:08Z",
  25. "UpdateDate" : "2015-02-18T17:22:08Z"
  26. }
  27. ]
  28. }
  29. }
Thank you! We've received your feedback.