All Products
Search
Document Center

Resource Access Management:ListUsersForGroup

Last Updated:Jul 25, 2024

Queries Resource Access Management (RAM) users in a RAM user group.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
GroupNamestringYes

The name of the RAM user group.

Test-Team
MarkerstringNo

The pagination token that is used in the next request to retrieve a new page of results. You do not need to specify this parameter for the first request.``

When you call the operation for the first time, if the total number of returned entries exceeds the value of MaxItems, the entries are truncated. The system returns entries based on the value of MaxItems and does not return the excess entries. In this case, the value of the response parameter IsTruncated is true, and Marker is returned. In the next call, you can use the value of Marker and maintain the settings of the other request parameters to query the excess entries. You can repeat the call until the value of IsTruncated becomes false. This way, all entries are returned.

EXAMPLE
MaxItemsintegerNo

The number of entries per page.

Valid values: 1 to 100.

Default value: 100.

100

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The request ID.

789FF581-B3C8-43A8-9115-54304B46D05C
IsTruncatedboolean

Indicates whether the response is truncated. Valid values:

  • true
  • false
true
Markerstring

The pagination token that is used in the next request to retrieve a new page of results.

Note This parameter is returned only when IsTruncated is true.
EXAMPLE
Usersarray<object>

The information about the RAM users.

object
UserPrincipalNamestring

The logon name of the RAM user.

test@example.onaliyun.com
DisplayNamestring

The display name of the RAM user.

test
UserIdstring

The ID of the RAM user.

20732900249392****
JoinDatestring

The time when the RAM user was added to the RAM user group. The time is displayed in UTC.

2020-10-20T06:57:00Z

Examples

Sample success responses

JSONformat

{
  "RequestId": "789FF581-B3C8-43A8-9115-54304B46D05C",
  "IsTruncated": true,
  "Marker": "EXAMPLE",
  "Users": {
    "User": [
      {
        "UserPrincipalName": "test@example.onaliyun.com",
        "DisplayName": "test",
        "UserId": "20732900249392****",
        "JoinDate": "2020-10-20T06:57:00Z"
      }
    ]
  }
}

Error codes

For a list of error codes, visit the Service error codes.