调用DescribeVpcFirewallList接口,查询VPC边界防火墙(防护通过高速通道连接的两个VPC之间的流量)的信息。

使用说明

本接口一般用于分页查询VPC边界防火墙的信息。该VPC边界防火墙是防护通过高速通道连接两个VPC之间的流量。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用将会被限流,这可能影响您的业务,请合理调用。

调试

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

请求参数

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

系统规定参数。取值:DescribeVpcFirewallList

Lang String zh

请求和接收消息的语言类型。取值:

  • zh(默认):中文。
  • en:英文。
RegionNo String cn-hangzhou

VPC所在的地域ID。

说明 关于云防火墙支持地域的详细信息,请参见支持的地域
VpcId String vpc-8vbwbo90rq0anm6t****

VPC实例ID。

FirewallSwitchStatus String opened

VPC边界防火墙的状态。取值:

  • opened:已开启。
  • closed:已关闭。
  • notconfigured:表示暂未配置VPC边界防火墙。
  • configured:表示已配置VPC边界防火墙。
说明 不设置该参数表示查询所有状态的VPC边界防火墙。
VpcFirewallId String vfw-m5e7dbc4y****

VPC边界防火墙的实例ID。

VpcFirewallName String 测试环境防火墙

VPC边界防火墙的实例名称。

CurrentPage String 1

分页查询时,设置当前页面的页码。

默认值为1,表示返回第1页数据。

PageSize String 10

分页查询时,设置每页包含VPC边界防火墙的数量。

默认值为10,表示每页包含10条结果。最大值为50

MemberUid String 258039427902****

当前阿里云账号的成员账号UID。

返回数据

名称 类型 示例值 描述
TotalCount Integer 10

VPC边界防火墙的总数量。

RequestId String 850A84D6-0DE4-4797-A1E8-00090125k8g2

本次请求的ID。

VpcFirewalls Array of Data

VPC边界防火墙的详细信息。

ConnectType String expressconnect

VPC边界防火墙的互通类型。取值:expressconnect,表示高速通道。

VpcFirewallId String vfw-m5e7dbc4y****

VPC边界防火墙的实例ID。

RegionStatus String enable

地域开放状态。取值:

  • enable:已开放,表示该地域允许配置VPC边界防火墙。
  • disable:未开放,表示该地域不允许配置VPC边界防火墙。
Bandwidth Integer 2

高速通道的带宽规格。单位:Mbps。

VpcFirewallName String 测试防火墙

VPC边界防火墙的实例名称。

FirewallSwitchStatus String opened

VPC边界防火墙开关的状态。取值:

  • opened:已开启。
  • closed:已关闭。
  • notconfigured:表示暂未配置VPC边界防火墙。
LocalVpc Object

本端VPC的详细信息。

VpcName String 测试用实例

本端VPC的实例名称。

VpcId String vpc-8vbwbo90rq0anm6t****

本端VPC的实例ID。

AuthorizationStatus String authorized

本端VPC的授权状态。取值:authorized,表示已授权。

OwnerId Long 158039427902****

本端VPC所属阿里云账号的UID。

RegionNo String cn-hangzhou

本端VPC所属地域ID。

VpcCidrTableList Array of cidrTable

本端VPC的网段列表信息。

RouteTableId String vtb-1234

本端VPC的路由表ID。

RouteEntryList Array of routeEntry

本端VPC的路由条目列表。

NextHopInstanceId String vrt-m5eb5me6c3l5sezae****

本端VPC的下一跳实例ID。

DestinationCidr String 192.168.XX.XX/24

本端VPC的目标网段。

PeerVpc Object

对端VPC的详细信息。

VpcName String 测试vpc2

对端VPC的实例名称。

VpcId String vpc-8vbwbo90rq0anm6t****

对端VPC的实例ID。

AuthorizationStatus String authorized

对端VPC的授权状态。取值:authorized,表示已授权。

OwnerId Long 158039427902****

对端VPC所属的阿里云账号的UID。

RegionNo String cn-hangzhou

对端VPC所属地域ID。

VpcCidrTableList Array of cidrTable

对端VPC网段列表信息。

RouteTableId String vtb-1256

对端VPC的路由表ID。

RouteEntryList Array of routeEntry

对端VPC路由条目列表信息。

NextHopInstanceId String vrt-m5eb5me6c3l5sezae****

对端VPC的下一跳实例ID。

DestinationCidr String 192.168.XX.XX/24

对端VPC的目标网段。

IpsConfig Object

IPS配置信息。

BasicRules Integer 1

基础规则开关。取值:

  • 1:开启状态。
  • 0:关闭状态。
EnableAllPatch Integer 1

虚拟补丁开关。取值:

  • 1:开启状态。
  • 0:关闭状态。
RunMode Integer 0

IPS防御模式。取值:

  • 1:拦截模式。
  • 0:观察模式。
MemberUid String 258039427902****

阿里云成员账号的UID。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeVpcFirewallList
&Lang=zh
&RegionNo=cn-hangzhou
&VpcId=vpc-8vbwbo90rq0anm6t****
&FirewallSwitchStatus=opened
&VpcFirewallId=vfw-m5e7dbc4y****
&VpcFirewallName=测试环境防火墙
&CurrentPage=1
&PageSize=10
&MemberUid=258039427902****
&公共请求参数

正常返回示例

XML格式

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

<DescribeVpcFirewallListResponse>
    <TotalCount>10</TotalCount>
    <RequestId>850A84D6-0DE4-4797-A1E8-00090125k8g2</RequestId>
    <VpcFirewalls>
        <ConnectType>expressconnect</ConnectType>
        <VpcFirewallId>vfw-m5e7dbc4y****</VpcFirewallId>
        <RegionStatus>enable</RegionStatus>
        <Bandwidth>2</Bandwidth>
        <VpcFirewallName>测试防火墙</VpcFirewallName>
        <FirewallSwitchStatus>opened</FirewallSwitchStatus>
        <LocalVpc>
            <VpcName>测试用实例</VpcName>
            <VpcId>vpc-8vbwbo90rq0anm6t****</VpcId>
            <AuthorizationStatus>authorized</AuthorizationStatus>
            <RegionNo>cn-hangzhou</RegionNo>
            <VpcCidrTableList>
                <RouteTableId>vtb-1234</RouteTableId>
                <RouteEntryList>
                    <NextHopInstanceId>vrt-m5eb5me6c3l5sezae****</NextHopInstanceId>
                    <DestinationCidr>192.168.XX.XX/24</DestinationCidr>
                </RouteEntryList>
            </VpcCidrTableList>
        </LocalVpc>
        <PeerVpc>
            <VpcName>测试vpc2</VpcName>
            <VpcId>vpc-8vbwbo90rq0anm6t****</VpcId>
            <AuthorizationStatus>authorized</AuthorizationStatus>
            <RegionNo>cn-hangzhou</RegionNo>
            <VpcCidrTableList>
                <RouteTableId>vtb-1256</RouteTableId>
                <RouteEntryList>
                    <NextHopInstanceId>vrt-m5eb5me6c3l5sezae****</NextHopInstanceId>
                    <DestinationCidr>192.168.XX.XX/24</DestinationCidr>
                </RouteEntryList>
            </VpcCidrTableList>
        </PeerVpc>
        <IpsConfig>
            <BasicRules>1</BasicRules>
            <EnableAllPatch>1</EnableAllPatch>
            <RunMode>0</RunMode>
        </IpsConfig>
        <MemberUid>258039427902****</MemberUid>
    </VpcFirewalls>
</DescribeVpcFirewallListResponse>

JSON格式

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

{
  "TotalCount" : 10,
  "RequestId" : "850A84D6-0DE4-4797-A1E8-00090125k8g2",
  "VpcFirewalls" : [ {
    "ConnectType" : "expressconnect",
    "VpcFirewallId" : "vfw-m5e7dbc4y****",
    "RegionStatus" : "enable",
    "Bandwidth" : 2,
    "VpcFirewallName" : "测试防火墙",
    "FirewallSwitchStatus" : "opened",
    "LocalVpc" : {
      "VpcName" : "测试用实例",
      "VpcId" : "vpc-8vbwbo90rq0anm6t****",
      "AuthorizationStatus" : "authorized",
      "RegionNo" : "cn-hangzhou",
      "VpcCidrTableList" : [ {
        "RouteTableId" : "vtb-1234",
        "RouteEntryList" : [ {
          "NextHopInstanceId" : "vrt-m5eb5me6c3l5sezae****",
          "DestinationCidr" : "192.168.XX.XX/24"
        } ]
      } ]
    },
    "PeerVpc" : {
      "VpcName" : "测试vpc2",
      "VpcId" : "vpc-8vbwbo90rq0anm6t****",
      "AuthorizationStatus" : "authorized",
      "RegionNo" : "cn-hangzhou",
      "VpcCidrTableList" : [ {
        "RouteTableId" : "vtb-1256",
        "RouteEntryList" : [ {
          "NextHopInstanceId" : "vrt-m5eb5me6c3l5sezae****",
          "DestinationCidr" : "192.168.XX.XX/24"
        } ]
      } ]
    },
    "IpsConfig" : {
      "BasicRules" : 1,
      "EnableAllPatch" : 1,
      "RunMode" : 0
    },
    "MemberUid" : "258039427902****"
  } ]
}