调用DescribeAccessGroups接口查询权限组信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeAccessGroups | 接口名称。 固定取值:DescribeAccessGroups |
AccessGroupName | String | 否 | DEFAULT_VPC_GROUP_NAME | 权限组名称。 限制:
|
PageSize | Integer | 否 | 2 | 每个分页包含的权限组个数。 取值范围:1~100 默认值:10 |
PageNumber | Integer | 否 | 1 | 列表的分页页码。 起始值(默认值):1 |
UseUTCDateTime | Boolean | 否 | true | 指定返回的时间是否按照UTC标准格式表示。 取值:
|
FileSystemType | String | 否 | standard | 文件系统类型。 取值:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
AccessGroups | Array of AccessGroup | 权限组信息集合。 |
|
AccessGroup | |||
AccessGroupName | String | DEFAULT_VPC_GROUP_NAME | 权限组名称。 |
Description | String | This is a test access group. | 权限组描述信息。 |
CreateTime | String | 2020-01-05T16:00:00Z | 权限组的创建时间。 |
AccessGroupType | String | Vpc | 权限组类型。 包括:
|
RuleCount | Integer | 0 | 此权限组中包含的权限组规则数量。 |
MountTargetCount | Integer | 0 | 应用此权限组的挂载点数量。 |
TotalCount | Integer | 1 | 权限组的总个数。 |
RequestId | String | 2514F97E-FFF0-4A1F-BF04-729CEAC6**** | 请求ID。 |
PageSize | Integer | 2 | 每个分页包含的权限组个数。 |
PageNumber | Integer | 1 | 列表的分页页码。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeAccessGroups
&AccessGroupName=DEFAULT_VPC_GROUP_NAME
&PageSize=2
&PageNumber=1
&UseUTCDateTime=true
&FileSystemType=standard
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeAccessGroupsResponse>
<AccessGroups>
<AccessGroupName>DEFAULT_VPC_GROUP_NAME</AccessGroupName>
<Description>This is a test access group.</Description>
<CreateTime>2020-01-05T16:00:00Z</CreateTime>
<AccessGroupType>Vpc</AccessGroupType>
<RuleCount>0</RuleCount>
<MountTargetCount>0</MountTargetCount>
</AccessGroups>
<TotalCount>1</TotalCount>
<RequestId>2514F97E-FFF0-4A1F-BF04-729CEAC6****</RequestId>
<PageSize>2</PageSize>
<PageNumber>1</PageNumber>
</DescribeAccessGroupsResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"AccessGroups" : [ {
"AccessGroupName" : "DEFAULT_VPC_GROUP_NAME",
"Description" : "This is a test access group.",
"CreateTime" : "2020-01-05T16:00:00Z",
"AccessGroupType" : "Vpc",
"RuleCount" : 0,
"MountTargetCount" : 0
} ],
"TotalCount" : 1,
"RequestId" : "2514F97E-FFF0-4A1F-BF04-729CEAC6****",
"PageSize" : 2,
"PageNumber" : 1
}
错误码
访问错误中心查看更多错误码。