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 betrue
.
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
istrue
. In this case, you need to invoke this interface and useMarker
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"
}
]
}
}