全部產品
Search
文件中心

Cloud Firewall:DescribeVpcFirewallDetail - 查詢VPC邊界防火牆的詳情

更新時間:Apr 21, 2026

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

介面說明

本介面用於擷取 VPC 邊界防火牆的詳細資料。該 VPC 邊界防火牆是防護通過Express Connect串連的兩個 VPC 之間的流量。 調用本介面前,必須已經調用 CreateVpcFirewallConfigure 介面建立了 VPC 邊界防火牆。

QPS 限制

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

調試

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

調試

授權資訊

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

請求參數

名稱

類型

必填

描述

樣本值

Lang

string

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

  • zh(預設):中文。

  • en:英文。

zh

Lang

string

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

  • zh(預設):中文。

  • en:英文。

zh

VpcFirewallId

string

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

說明

您可以調用 DescribeVpcFirewallList 介面查詢 VPC 邊界防火牆的執行個體 ID。

vfw-m5e7dbc4y****

LocalVpcId

string

本端 VPC 的執行個體 ID。

vpc-8vbwbo90rq0anm6t****

PeerVpcId

string

對端 VPC 的執行個體 ID。

vpc-90rq0anm6t8vbwbo****

返回參數

名稱

類型

描述

樣本值

object

ConnectType

string

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

expressconnect

VpcFirewallId

string

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

vfw-m5e7dbc4y****

RequestId

string

本次請求的 ID。

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

Bandwidth

integer

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

2

VpcFirewallName

string

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

vpc-firewall-test

FirewallSwitchStatus

string

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

  • opened:已開啟。

  • closed:已關閉。

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

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

opened

LocalVpc

object

本端 VPC 的詳細資料。

VpcId

string

本端 VPC 的執行個體 ID。

vpc-8vbwbo90rq0anm6t****

VpcName

string

本端 VPC 的執行個體名稱。

vpc-test-instancel

RegionNo

string

本端 VPC 所屬地區 ID。

cn-hangzhou

EniPrivateIpAddress

string

本端 VPC 中彈性網卡私網 IP。

192.168.XX.XX

RouterInterfaceId

string

本端 VPC 中路由器介面 ID。

vrt-m5eb5me6c3l5sezae****

EniId

string

本端 VPC 中彈性網卡的執行個體 ID。

eni-8vbhfosfqv2rff42****

VpcCidrTableList

array<object>

本端 VPC 的網段列表資訊。

array<object>

RouteTableId

string

本端 VPC 的路由表 ID。

vtb-1234

RouteEntryList

array<object>

本端 VPC 的路由條目列表。

object

NextHopInstanceId

string

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

vrt-m5eb5me6c3l5sezae****

DestinationCidr

string

本端 VPC 的目標網段。

192.168.XX.XX/24

PeerVpc

object

對端 VPC 的詳細資料。

VpcId

string

對端 VPC 的執行個體 ID。

vpc-90rq0anm6t8vbwbo****

VpcName

string

對端 VPC 的執行個體名稱。

test-vpc2

RegionNo

string

對端 VPC 所屬地區 ID。

cn-hangzhou

EniPrivateIpAddress

string

對端 VPC 中彈性網卡私網 IP。

192.168.XX.XX

RouterInterfaceId

string

對端 VPC 中路由器介面 ID。

vrt-m5eb5me6c3l5sezae****

EniId

string

對端 VPC 中彈性網卡的執行個體 ID。

eni-8vbhfosfqv2rff42****

VpcCidrTableList

array<object>

對端 VPC 的網段列表資訊。

array<object>

RouteTableId

string

對端 VPC 的路由表 ID。

vtb-1256

RouteEntryList

array<object>

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

object

NextHopInstanceId

string

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

vrt-m5eb5me6c3l5sezae****

DestinationCidr

string

對端 VPC 的目標網段。

192.168.XX.XX/24

MemberUid

string

Cloud Firewall成員帳號的 UID。

258039427902****

樣本

正常返回樣本

JSON格式

{
  "ConnectType": "expressconnect",
  "VpcFirewallId": "vfw-m5e7dbc4y****",
  "RequestId": "850A84D6-0DE4-4797-A1E8-00090125g4d2",
  "Bandwidth": 2,
  "VpcFirewallName": "vpc-firewall-test",
  "FirewallSwitchStatus": "opened",
  "LocalVpc": {
    "VpcId": "vpc-8vbwbo90rq0anm6t****",
    "VpcName": "vpc-test-instancel",
    "RegionNo": "cn-hangzhou",
    "EniPrivateIpAddress": "192.168.XX.XX",
    "RouterInterfaceId": "vrt-m5eb5me6c3l5sezae****",
    "EniId": "eni-8vbhfosfqv2rff42****",
    "VpcCidrTableList": [
      {
        "RouteTableId": "vtb-1234",
        "RouteEntryList": [
          {
            "NextHopInstanceId": "vrt-m5eb5me6c3l5sezae****",
            "DestinationCidr": "192.168.XX.XX/24"
          }
        ]
      }
    ]
  },
  "PeerVpc": {
    "VpcId": "vpc-90rq0anm6t8vbwbo****",
    "VpcName": "test-vpc2",
    "RegionNo": "cn-hangzhou",
    "EniPrivateIpAddress": "192.168.XX.XX",
    "RouterInterfaceId": "vrt-m5eb5me6c3l5sezae****",
    "EniId": "eni-8vbhfosfqv2rff42****",
    "VpcCidrTableList": [
      {
        "RouteTableId": "vtb-1256",
        "RouteEntryList": [
          {
            "NextHopInstanceId": "vrt-m5eb5me6c3l5sezae****",
            "DestinationCidr": "192.168.XX.XX/24"
          }
        ]
      }
    ]
  },
  "MemberUid": "258039427902****"
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 ErrorAliUid The aliuid is invalid. 無效的使用者id
400 ErrorFirewallNotFound Firewall not found 防火牆不存在
400 ErrorDBSelectError A database select error occurred. 內部錯誤:資料庫查詢錯誤
400 ErrorInvalidMemberUid Member uid is invalid 成員帳號錯誤.
400 ErrorFirewallStatus firewall status error. 防火牆狀態錯誤,請稍後再試。
400 ErrorVpcIdPara vpc id and firewall id parameter not exist. 防火牆VPC參數錯誤,請重新選擇。
400 ErrorLocalVpcIdPeerVpcIdError local vpc id and peer vpc id cannot be empty at the same time. 防火牆VPC參數錯誤,請重新選擇。

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

變更歷史

更多資訊,參考變更詳情