全部產品
Search
文件中心

Cloud Firewall:DescribeVpcFirewallList - 擷取Express Connect防火牆列表

更新時間:Apr 21, 2026

查詢VPC邊界防火牆(防護通過Express Connect串連的兩個VPC之間的流量)的資訊。

介面說明

本介面一般用於分頁查詢 VPC 邊界防火牆的資訊。該 VPC 邊界防火牆是防護通過Express Connect串連兩個 VPC 之間的流量。

QPS 限制

本介面的單使用者 QPS 限制為 10 次/秒。超過限制,API 呼叫將會被限流,這可能影響您的業務,請合理調用。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

Lang

string

請求和接收訊息的語言類型。取值:

  • zh(預設):中文。

  • en:英文。

zh

Lang

string

請求和接收訊息的語言類型。取值:

  • zh(預設):中文。

  • en:英文。

zh

RegionNo

string

VPC 所在的地區 ID。

說明

關於Cloud Firewall支援地區的詳細資料,請參見支援的地區

cn-hangzhou

VpcId

string

VPC 執行個體 ID。

vpc-8vbwbo90rq0anm6t****

FirewallSwitchStatus

string

VPC 邊界防火牆的狀態。取值:

  • opened:已開啟。

  • closed:已關閉。

  • notconfigured:表示暫未配置 VPC 邊界防火牆。

  • configured:表示已配置 VPC 邊界防火牆。

說明

不設定該參數表示查詢所有狀態的 VPC 邊界防火牆。

opened

VpcFirewallId

string

VPC 邊界防火牆的執行個體 ID。

vfw-m5e7dbc4y****

VpcFirewallName

string

VPC 邊界防火牆的執行個體名稱。

test-vpc-firewall

CurrentPage

string

分頁查詢時,設定當前頁面的頁碼。

預設值為 1,表示返回第 1 頁資料。

1

PageSize

string

分頁查詢時,設定每頁包含 VPC 邊界防火牆的數量。

預設值為 10,表示每頁包含 10 條結果。最大值為 50

10

MemberUid

string

當前阿里雲帳號的成員帳號 UID。

258039427902****

ConnectSubType

string

串連子類型。取值:

  • vpc2vpc:Express Connect。

  • vpcpeer:對等串連。

vpcpeer

PeerUid

string

對端 VPC 雲帳號 UID。

258039427902****

返回參數

名稱

類型

描述

樣本值

object

VPC 防火牆的列表。

TotalCount

integer

VPC 邊界防火牆的總數量。

10

RequestId

string

本次請求的 ID。

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

VpcFirewalls

array<object>

VPC 邊界防火牆的詳細資料。

array<object>

VPC 邊界防火牆的詳細資料。

ConnectType

string

VPC 邊界防火牆的互連類型。取值:expressconnect,表示Express Connect。

expressconnect

VpcFirewallId

string

VPC 邊界防火牆的執行個體 ID。

vfw-m5e7dbc4y****

RegionStatus

string

地區開放狀態。取值:

  • enable:已開放,表示該地區允許配置 VPC 邊界防火牆。

  • disable:未開放,表示該地區不允許配置 VPC 邊界防火牆。

enable

Bandwidth

integer

Express Connect的頻寬規格。單位:Mbps。

2

VpcFirewallName

string

VPC 邊界防火牆的執行個體名稱。

test-firewall

FirewallSwitchStatus

string

VPC 邊界防火牆開關的狀態。取值:

  • opened:已開啟。

  • closed:已關閉。

  • notconfigured:表示暫未配置 VPC 邊界防火牆。

opened

LocalVpc

object

本端 VPC 的詳細資料。

VpcName

string

本端 VPC 的執行個體名稱。

test-vpc1

VpcId

string

本端 VPC 的執行個體 ID。

vpc-8vbwbo90rq0anm6t****

AuthorizationStatus

string

本端 VPC 的授權狀態。取值:authorized,表示已授權。

authorized

OwnerId

integer

本端 VPC 所屬阿里雲帳號的 UID。

158039427902****

RegionNo

string

本端 VPC 所屬地區 ID。

cn-hangzhou

VpcCidrTableList

array<object>

本端 VPC 的網段列表資訊。

array<object>

本端 VPC 的網段列表資訊。

RouteTableId

string

本端 VPC 的路由表 ID。

vtb-1234

RouteEntryList

array<object>

本端 VPC 的路由條目列表。

object

本端 VPC 的路由條目列表。

NextHopInstanceId

string

本端 VPC 的下一跳執行個體 ID。

vrt-m5eb5me6c3l5sezae****

DestinationCidr

string

本端 VPC 的目標網段。

192.168.XX.XX/24

PeerVpc

object

對端 VPC 的詳細資料。

VpcName

string

對端 VPC 的執行個體名稱。

test-vpc2

VpcId

string

對端 VPC 的執行個體 ID。

vpc-8vbwbo90rq0anm6t****

AuthorizationStatus

string

對端 VPC 的授權狀態。取值:authorized,表示已授權。

authorized

OwnerId

integer

對端 VPC 所屬的阿里雲帳號的 UID。

158039427902****

RegionNo

string

對端 VPC 所屬地區 ID。

cn-hangzhou

VpcCidrTableList

array<object>

對端 VPC 網段列表資訊。

array<object>

對端 VPC 網段列表資訊。

RouteTableId

string

對端 VPC 的路由表 ID。

vtb-1256

RouteEntryList

array<object>

對端 VPC 路由條目列表資訊。

object

對端 VPC 路由條目列表資訊。

NextHopInstanceId

string

對端 VPC 的下一跳執行個體 ID。

vrt-m5eb5me6c3l5sezae****

DestinationCidr

string

對端 VPC 的目標網段。

192.168.XX.XX/24

IpsConfig

object

IPS 配置資訊。

BasicRules

integer

基礎規則開關。取值:

  • 1:開啟狀態。

  • 0:關閉狀態。

1

EnableAllPatch

integer

虛擬補丁開關。取值:

  • 1:開啟狀態。

  • 0:關閉狀態。

1

RunMode

integer

IPS 防禦模式。取值:

  • 1:攔截模式。

  • 0:觀察模式。

0

RuleClass

integer

IPS 規則群組。取值:

  • 1:寬鬆規則群組。

  • 2:中等規則群組。

  • 3:嚴格規則群組。

1

MemberUid

string

阿里雲成員帳號的 UID。

258039427902****

ResultCode

string

建立 VPC 邊界防火牆的操作結果代碼。取值:

  • Unauthorized:表示存在未授權的 VPC, 不允許建立 VPC 邊界防火牆。

  • RegionDisable:表示 VPC 所在的地區是 VPC 邊界防火牆不支援的地區, 不允許建立 VPC 邊界防火牆。

  • Null 字元串:表示該網路執行個體可以正常建立 VPC 邊界防火牆。

Unauthorized

ConnectSubType

string

串連子類型。取值:

  • vpc2vpc:Express Connect。

  • vpcpeer:對等串連。

vpcpeer

AclConfig

object

ACL 引擎模式。

StrictMode

integer

是否啟用strict 模式

  • 1:啟用strict 模式

  • 0:禁用strict 模式

1

樣本

正常返回樣本

JSON格式

{
  "TotalCount": 10,
  "RequestId": "850A84D6-0DE4-4797-A1E8-00090125k8g2",
  "VpcFirewalls": [
    {
      "ConnectType": "expressconnect",
      "VpcFirewallId": "vfw-m5e7dbc4y****",
      "RegionStatus": "enable",
      "Bandwidth": 2,
      "VpcFirewallName": "test-firewall",
      "FirewallSwitchStatus": "opened",
      "LocalVpc": {
        "VpcName": "test-vpc1",
        "VpcId": "vpc-8vbwbo90rq0anm6t****",
        "AuthorizationStatus": "authorized",
        "OwnerId": 0,
        "RegionNo": "cn-hangzhou",
        "VpcCidrTableList": [
          {
            "RouteTableId": "vtb-1234",
            "RouteEntryList": [
              {
                "NextHopInstanceId": "vrt-m5eb5me6c3l5sezae****",
                "DestinationCidr": "192.168.XX.XX/24"
              }
            ]
          }
        ]
      },
      "PeerVpc": {
        "VpcName": "test-vpc2",
        "VpcId": "vpc-8vbwbo90rq0anm6t****",
        "AuthorizationStatus": "authorized",
        "OwnerId": 0,
        "RegionNo": "cn-hangzhou",
        "VpcCidrTableList": [
          {
            "RouteTableId": "vtb-1256",
            "RouteEntryList": [
              {
                "NextHopInstanceId": "vrt-m5eb5me6c3l5sezae****",
                "DestinationCidr": "192.168.XX.XX/24"
              }
            ]
          }
        ]
      },
      "IpsConfig": {
        "BasicRules": 1,
        "EnableAllPatch": 1,
        "RunMode": 0,
        "RuleClass": 1
      },
      "MemberUid": "258039427902****",
      "ResultCode": "Unauthorized",
      "ConnectSubType": "vpcpeer",
      "AclConfig": {
        "StrictMode": 1
      }
    }
  ]
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 ErrorDBSelectError A database select error occurred. 內部錯誤:資料庫查詢錯誤
400 ErrorPageNo Either page number or page size is invalid. 無效的page number 或者 page size
400 ErrorUnmarshalJSON An error occurred while parsing JSON. 內部錯誤:JSON解碼錯誤
400 ErrorAliUid Aliuid invalid. aliuid無效
400 ErrorFirewallStatus Firewall status error, please try again later. 防火牆狀態錯誤,請稍後再試

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情