ListGroups

Interface description

　Lists all user groups.

Request parameters

Action

• Type: String
• Required: Yes
• Description: Operation name. Value: ListGroups

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

Groups

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

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.

Required permissions

Action

ram:ListGroups

Resource

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

Operation examples

Request example

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

Return example

XML format

<ListGroupsResponse>
  <RequestId>065527AA-2F2E-AD7C-7484-F2626CFE4934</RequestId>
  <IsTruncated>true</IsTruncated>
  <Marker>EXAMPLE</Marker>
  <Groups>
    <Group>
      <GroupName>Dev-Team</GroupName>
      <Comments>Development team</Comments>
      <CreateDate>2015-01-23T12:33:18Z</CreateDate>
      <UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
    </Group>
    <Group>
      <GroupName>QA-Team</GroupName>
      <Comments>Test team</Comments>
      <CreateDate>2015-02-18T17:22:08Z</CreateDate>
      <UpdateDate>2015-02-18T17:22:08Z</UpdateDate>
    </Group>
  </Groups>
</ListGroupsResponse>

JSON format

{
    "RequestId": "065527AA-2F2E-AD7C-7484-F2626CFE4934",
    "IsTruncated": true,
    "Marker": "EXAMPLE",
    "Groups": {
        "Group": [
            {
                "GroupName": "Dev-Team",
                "Comments": "Development team",
                "CreateDate" : "2015-01-23T12:33:18Z",
                "UpdateDate" : "2015-01-23T12:33:18Z"
            },
            {
                "GroupName": "QA-Team",
                "Comments": "Test team",
                "CreateDate" : "2015-02-18T17:22:08Z",
                "UpdateDate" : "2015-02-18T17:22:08Z"
            }
        ]
    }
}