调用ListGroups接口查询用户组列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListGroups

要执行的操作。取值：ListGroups。
Marker String 否 EXAMPLE

当请求的返回结果被截断时，可以使用Marker获取从当前截断位置之后的内容。

MaxItems Integer 否 100

指定返回结果的条数，当返回结果达到MaxItems限制被截断时，返回参数IsTruncated将等于true。

取值范围：1 ~ 1000，默认值：100。

返回数据

名称 类型 示例值 描述
Groups Array of Group

用户组信息。
Group
Comments String 开发团队

备注信息。
CreateDate String 2015-01-23T12:33:18Z

创建时间。
GroupId String g-FpMEHiMysofp****

用户组ID。
GroupName String Dev-Team

用户组名称。
UpdateDate String 2015-01-23T12:33:18Z

更新时间。
IsTruncated Boolean true

请求返回结果是否被截断。
Marker String EXAMPLE

当IsTruncated为true时才有此字段，当返回true时，需要继续调用此接口，并且使用Marker获取截断后的内容。

RequestId String 065527AA-2F2E-AD7C-7484-F2626CFE4934

请求ID。

示例

请求示例

https://ram.aliyuncs.com/?Action=ListGroups
&<公共请求参数>

正常返回示例

XML 格式 

<ListGroupsResponse>
	  <RequestId>065527AA-2F2E-AD7C-7484-F2626CFE4934</RequestId>
	  <IsTruncated>true</IsTruncated>
	  <Marker>EXAMPLE</Marker>
	  <Groups>
		    <Group>
			      <GroupName>Dev-Team</GroupName>
			      <Comments>开发团队</Comments>
			      <CreateDate>2015-01-23T12:33:18Z</CreateDate>
			      <UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
			      <GroupId>g-FpMEHiMysofp****</GroupId>
		    </Group>
		    <Group>
			      <GroupName>QA-Team</GroupName>
			      <Comments>测试团队</Comments>
			      <CreateDate>2015-02-18T17:22:08Z</CreateDate>
			      <UpdateDate>2015-02-18T17:22:08Z</UpdateDate>
			      <GroupId>g-zYtroLrgbZR1****</GroupId>
		    </Group>
	  </Groups>
</ListGroupsResponse>

JSON 格式 

{
    "RequestId": "065527AA-2F2E-AD7C-7484-F2626CFE4934",
    "IsTruncated": true,
    "Marker": "EXAMPLE",
    "Groups": {
        "Group": [
            {
                "GroupName": "Dev-Team",
                "Comments": "开发团队",
                "CreateDate" : "2015-01-23T12:33:18Z",
                "UpdateDate" : "2015-01-23T12:33:18Z",
                "GroupId": "g-FpMEHiMysofp****"
            },
            {
                "GroupName": "QA-Team",
                "Comments": "测试团队",
                "CreateDate" : "2015-02-18T17:22:08Z",
                "UpdateDate" : "2015-02-18T17:22:08Z",
                "GroupId": "g-zYtroLrgbZR1****"
            }
        ]
    }
}

错误码

访问错误中心查看更多错误码。