Lists all RAM user groups.

Debug

Use OpenAPI Explorer to perform debug operations and generate SDK code examples.

Request parameters

Parameter Type Required? Example value Description
Action String Yes ListGroups

The name of this action.

Value: ListGroups
Marker String No EXAMPLE The marker. If part of a response is intercepted, you can use this parameter to obtain the intercepted content.
MaxItems Integer No 100

The number of permitted response items. If a response is intercepted when it reaches the maximum value of this parameter, the value of IsTruncated is true.

Value range: 1 to 1,000

Default value: 100

Response parameters

Parameter Type Example value Description
Group N/A N/A The information that relates to a RAM user group.
└Comments String Development team The comment.
└CreateDate String 2015-01-23T12:33:18Z The date and time when a RAM user group was created.
└GroupName String Dev-Team The RAM user group name.
└UpdateDate String 2015-01-23T12:33:18Z The date and time when a RAM user group was modified.
IsTruncated Boolean true Indicates whether a response is intercepted.
Marker String EXAMPLE This parameter is available only when the value of IsTruncated is true. In which case, you can call this action and use the specific marker to obtain the intercepted content.
RequestId String 065527AA-2F2E-AD7C-7484-F2626CFE4934 The request ID.

Example

Request example

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

Response 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 development</Comments>
      <CreateDate>2015-02-18T17:22:08Z</CreateDate>
      <UpdateDate>2015-02-18T17:22:08Z</UpdateDate>
    </Group>
  </Groups>
</ListGroupsResponse>

JSON format 

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

Errors

For a list of error codes, visit the API Error Center.