私有网络VPC

查询ACL规则

说明:本手册请求结构与请求示例中的服务域名(Host)均为举例,实际使用时请替换为项目自定义的服务域名

描述

查询ACL规则信息。系统为用户创建了2条默认ACL规则(无id)。其中入站和出站各一条,规则内容均为全入全出。默认规则,不支持更改和删除。

请求结构

GET /v{version}/acl/rule?marker={marker}&maxKeys={maxKeys}&subnetId={subnetId} HTTP/1.1
Host: bcc.cnhzpro.agilecloud.com
Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
version String URL参数 API版本号
marker String Query参数 批量获取列表的查询的起始位置,是一个由系统生成的字符串
maxKeys Integer Query参数 每页包含的最大数量,最大数量通常不超过1000。缺省值为1000
subnetId String Query参数 所属subnet的ID

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 描述
marker String 标记查询的起始位置
isTruncated boolean true表示后面还有数据,false表示已经是最后一页
nextMarker String 获取下一页所需要传递的marker值。当isTruncated为false时,该域不出现
maxKeys Integer 每页包含的最大数量
aclRules List<AclRule> ACL规则信息组成的集合

请求示例

GET /v1/acl/rule?marker=ar-ik9p9zq6u5ry&maxKeys=1&subnetId=sbn-svz99ha4a40w HTTP/1.1
Host: bcc.cnhzpro.agilecloud.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-03-11T04:17:29Z/3600/  host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Thu, 16 Mar 2017 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

{
    "nextMarker": "ar-Iy8p6arqenI7",
    "marker": "ar-ik9p9zq6u5ry",
    "maxKeys": 1,
    "isTruncated": true,
    "aclRules":[
        {
          "id":"ar-ik9p9zq6u5ry",
          "subnetId":"sbn-svz99ha4a40w",
          "description":"",
          "protocol":"tcp",
          "sourceIpAddress":"192.168.0.0",
          "destinationIpAddress":"192.168.0.0/20",
          "sourcePort":"1-65535",
          "destinationPort":"443",
          "position":2,
          "direction":"ingress",
                 "ipVersion":4,
          "action":"allow"
        }
      ]
}
上一篇
删除ACL规则
下一篇
查询ACL