调用ListAcls查询某一个地域的ACL列表。

调试

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

请求参数

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

要执行的操作。取值：ListAcls。

AclIds Array of String 否 nacl-hp34s2h0xx1ht4nwo****

ACL ID。一次最多支持查询20个ACL ID。
AclNames Array of String 否 test-acl

ACL名称。一次最多支持查询10个ACL名称。
ResourceGroupId String 否 rg-atstuj3rtopty****

资源组ID，根据设置的资源组ID来过滤。
NextToken String 否 FFmyTO70tTpLG6I3FmYAXGKPd****

是否拥有下一次查询的令牌（Token）。取值：

  • 第一次查询和没有下一次查询时，均无需填写。
  • 如果有下一次查询，取值为上一次API调用返回的NextToken值。
MaxResults Integer 否 50

本次读取的最大数据记录数量，此参数为可选参数。取值范围：1~100。默认值：20。

返回数据

名称 类型 示例值 描述
Acls Array of Acl

ACL列表。
AclId String nacl-hp34s2h0xx1ht4nwo****

ACL ID。
AclName String test-acl

ACL名称。
AclStatus String Available

ACL状态。取值：

  • Creating：创建中。
  • Available：正常可用状态。
  • Configuring：配置中。
AddressIPVersion String IPv4

ACL IP版本。取值：IPv4。

ResourceGroupId String rg-atstuj3rtopty****

资源组ID。
ConfigManagedEnabled Boolean false

配置管理开关。取值：

  • true：开启配置管理。
  • false：未开启配置管理。
MaxResults Integer 20

本次读取的最大数据记录数量，此参数为可选参数，取值1~100。参数传入为空时，默认值为20。

NextToken String FFmyTO70t****

是否拥有下一次查询的令牌（Token）。取值：

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值，该取值表示下一次查询开始的令牌。
RequestId String 593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3

请求ID。
TotalCount Integer 10

本次请求条件下的数据总量。

示例

请求示例

http(s)://[Endpoint]/?Action=ListAcls
&AclIds=["nacl-hp34s2h0xx1ht4nwo****"]
&AclNames=["test-acl"]
&ResourceGroupId=rg-atstuj3rtopty****
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&MaxResults=50
&公共请求参数

正常返回示例

XML格式 

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

<ListAclsResponse>
    <Acls>
        <AclId>nacl-hp34s2h0xx1ht4nwo****</AclId>
        <AclName>test-acl</AclName>
        <AclStatus>Available</AclStatus>
        <AddressIPVersion>IPv4</AddressIPVersion>
        <ResourceGroupId>rg-atstuj3rtopty****</ResourceGroupId>
        <ConfigManagedEnabled>false</ConfigManagedEnabled>
    </Acls>
    <MaxResults>20</MaxResults>
    <NextToken>FFmyTO70t****</NextToken>
    <RequestId>593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3</RequestId>
    <TotalCount>10</TotalCount>
</ListAclsResponse>

JSON格式 

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

{
  "Acls" : [ {
    "AclId" : "nacl-hp34s2h0xx1ht4nwo****",
    "AclName" : "test-acl",
    "AclStatus" : "Available",
    "AddressIPVersion" : "IPv4",
    "ResourceGroupId" : "rg-atstuj3rtopty****",
    "ConfigManagedEnabled" : false
  } ],
  "MaxResults" : 20,
  "NextToken" : "FFmyTO70t****",
  "RequestId" : "593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3",
  "TotalCount" : 10
}

错误码

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