调用DescribeAccessControlLists接口查询已创建的访问控制策略组。

调试

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

请求参数

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

系统规定参数。取值:DescribeAccessControlLists

RegionId String cn-hangzhou

访问控制策略组的地域ID。

您可以通过调用DescribeRegions接口查询地域ID。

AclName String rule1

访问控制策略组名称。访问控制策略组名称。长度限制为1~80个字符,只支持中文、字母、数字和半角句号(.)、短划线(-)、正斜线(/)和下划线(_)。访问控制策略组名称必须为地域内唯一。访问控制策略组名称支持模糊查询。

AddressIPVersion String ipv4

访问控制策略组绑定的实例的IP类型。取值:

  • ipv4:负载均衡实例的IP地址是IPv4类型。
  • ipv6:负载均衡实例的IP地址是IPv6类型。
PageSize Integer 10

分页查询时每页的行数,最大值:50,默认值:10

PageNumber Integer 1

列表的页码,默认值:1

ResourceGroupId String rg-atstuj3rtop*****

企业资源组ID。

返回数据

名称 类型 示例值 描述
PageNumber Integer 1

实例列表页码,起始值1,默认值:1

PageSize Integer 10

单页结果数量。

默认值:50

RequestId String 3CB646EF-6147-4566-A9D9-CE8FBE86F971

请求ID。

TotalCount Integer 1

已创建的访问控制组策略组个数。

Count Integer 1

当前页展示的访问控制策略组个数。

Acls Array of Acl

查询到的访问控制策略组列表。

Acl
AclId String acl-bp1l0kk4gxce43k*****

访问控制策略组ID。

AddressIPVersion String ipv4

关联的负载均衡实例的IP地址类型。

AclName String rule1

访问控制策略组名称。

ResourceGroupId String rg-jfenf***********

资源组ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeAccessControlLists
&RegionId=cn-hangzhou
&AclName=rule1
&AddressIPVersion=ipv4
&PageSize=10
&PageNumber=1
&ResourceGroupId=rg-atstuj3rtop*****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeAccessControlListsResponse>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
    <RequestId>3CB646EF-6147-4566-A9D9-CE8FBE86F971</RequestId>
    <TotalCount>1</TotalCount>
    <Count>1</Count>
    <Acls>
        <AclId>acl-bp1l0kk4gxce43k*****</AclId>
        <AddressIPVersion>ipv4</AddressIPVersion>
        <AclName>rule1</AclName>
        <ResourceGroupId>rg-jfenf***********</ResourceGroupId>
    </Acls>
</DescribeAccessControlListsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PageNumber" : 1,
  "PageSize" : 10,
  "RequestId" : "3CB646EF-6147-4566-A9D9-CE8FBE86F971",
  "TotalCount" : 1,
  "Count" : 1,
  "Acls" : [ {
    "AclId" : "acl-bp1l0kk4gxce43k*****",
    "AddressIPVersion" : "ipv4",
    "AclName" : "rule1",
    "ResourceGroupId" : "rg-jfenf***********"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidResourceGroupId.NotFound The specified ResourceGroupId is not found. 指定的资源组不存在。

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