全部產品
Search
文件中心

Cloud Firewall:DescribeVpcFirewallCenDetail - 查詢VPC邊界防火牆的詳細資料

更新時間:Dec 09, 2025

查詢VPC邊界防火牆(防護雲企業網內的網路執行個體和指定VPC之間的互訪流量)的詳細資料。

介面說明

本介面一般用於擷取 VPC 邊界防火牆的詳細資料。該 VPC 邊界防火牆是防護雲企業網內的網路執行個體(網路執行個體包含 VPC、VBR 和 CCN)和指定 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。

說明

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

vfw-m5e7dbc4y****

NetworkInstanceId

string

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

vpc-2zefk9fbn8j7v585g****

返回參數

名稱

類型

描述

樣本值

object

ConnectType

string

VPC 邊界防火牆的互連類型。取值:cen,表示雲企業網。

cen

VpcFirewallName

string

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

測試防火牆

VpcFirewallId

string

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

vfw-m5e7dbc4y****

FirewallSwitchStatus

string

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

  • opened:已開啟。

  • closed:已關閉。

  • notconfigured:未配置。

opened

RequestId

string

本次請求的 ID。

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

LocalVpc

object

VPC 的詳細資料。

VpcId

string

VPC 的執行個體 ID。

vpc-8vbwbo90rq0anm6t****

TransitRouterType

string

雲企業網轉寄路由器(CEN-TR)的版本。取值:

  • Basic:基礎版。

  • Enterprise:企業版。

Basic

RouteMode

string

路由模式,。取值:

  • auto:表示自動模式。

  • manual:表示手動模式。

auto

NetworkInstanceId

string

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

vpc-2zefk9fbn8j7v585g****

RegionNo

string

VPC 所屬地區 ID。

cn-hangzhou

ManualVSwitchId

string

路由模式為手動模式時指定的 vSwitch 的 ID。

vsw-zeq4o875u****

OwnerId

string

VPC 所屬阿里雲賬戶的 UID。

158039427902****

NetworkInstanceType

string

網路執行個體的類型。取值:VPC

VPC

VpcName

string

VPC 的執行個體名稱。

測試用執行個體

SupportManualMode

string

路由模式是否支援手動模式。取值:

  • 1:支援。

  • 0:不支援。

0

TransitRouterId

string

CEN-TR 的執行個體 ID。

tr-2zetwxskej633l3u1****

AttachmentId

string

網路執行個體的串連 ID。

tr-attach-sxig7bye51fid5****

NetworkInstanceName

string

網路執行個體的名稱。

測試業務vpc

AttachmentName

string

網路執行個體的串連名稱

本地測試

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

EniList

array<object>

彈性網卡列表。

object

EniId

string

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

eni-8vbhfosfqv2rff42****

EniPrivateIpAddress

string

VPC 中彈性網卡的私網 IP。

192.168.XX.XX

EniVSwitchId

string

VPC 中彈性網卡的虛擬交換器 ID。

vsw-wz9viido7j436b0n1****

DefendCidrList

array

VPC 邊界防火牆防護的網段列表。

string

VPC 邊界防火牆防護的網段。

10.0.XX.XX/24

FirewallVpc

object

防火牆所使用 VPC。

VpcId

string

VPC 執行個體 ID。

vpc-bp1245k5oagy2bp74****

VpcCidr

string

VPC 的網段。

10.0.0.0/8

VswitchId

string

虛擬交換器 ID。

vsw-bp1sqg9wms9wxcs1****

VswitchCidr

string

虛擬交換器的網段。

10.0.0.1/24

ZoneId

string

防火牆主可用性區域 ID。

cn-hangzhou-i

AllowConfiguration

integer

CEN 基礎版建立 VPC 防火牆時是否允許配置防火牆 VPC 網段。取值:

  • 1:允許。

  • 0:不允許。

0

VswitchZoneId

string

虛擬交換器的可用性區域 ID

cn-hangzhou-i

StandbyZoneId

string

防火牆備可用性區域 ID。

cn-hangzhou-k

樣本

正常返回樣本

JSON格式

{
  "ConnectType": "cen",
  "VpcFirewallName": "測試防火牆",
  "VpcFirewallId": "vfw-m5e7dbc4y****",
  "FirewallSwitchStatus": "opened",
  "RequestId": "850A84D6-0DE4-4797-A1E8-00090125g4d2",
  "LocalVpc": {
    "VpcId": "vpc-8vbwbo90rq0anm6t****",
    "TransitRouterType": "Basic",
    "RouteMode": "auto",
    "NetworkInstanceId": "vpc-2zefk9fbn8j7v585g****",
    "RegionNo": "cn-hangzhou",
    "ManualVSwitchId": "vsw-zeq4o875u****",
    "OwnerId": "158039427902****",
    "NetworkInstanceType": "VPC",
    "VpcName": "測試用執行個體",
    "SupportManualMode": "0",
    "TransitRouterId": "tr-2zetwxskej633l3u1****",
    "AttachmentId": "tr-attach-sxig7bye51fid5****",
    "NetworkInstanceName": "測試業務vpc",
    "AttachmentName": "本地測試",
    "VpcCidrTableList": [
      {
        "RouteTableId": "vtb-1234",
        "RouteEntryList": [
          {
            "NextHopInstanceId": "vrt-m5eb5me6c3l5sezae****",
            "DestinationCidr": "192.168.XX.XX/24"
          }
        ]
      }
    ],
    "EniList": [
      {
        "EniId": "eni-8vbhfosfqv2rff42****",
        "EniPrivateIpAddress": "192.168.XX.XX",
        "EniVSwitchId": "vsw-wz9viido7j436b0n1****"
      }
    ],
    "DefendCidrList": [
      "10.0.XX.XX/24"
    ]
  },
  "FirewallVpc": {
    "VpcId": "vpc-bp1245k5oagy2bp74****",
    "VpcCidr": "10.0.0.0/8",
    "VswitchId": "vsw-bp1sqg9wms9wxcs1****",
    "VswitchCidr": "10.0.0.1/24",
    "ZoneId": "cn-hangzhou-i",
    "AllowConfiguration": 0,
    "VswitchZoneId": "cn-hangzhou-i",
    "StandbyZoneId": "cn-hangzhou-k"
  }
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 ErrorAliUid The aliuid is invalid. 無效的使用者id
400 ErrorDBSelectError A database select error occurred. 內部錯誤:資料庫查詢錯誤
400 ErrorVpcFirewallId The VPC firewall ID is invalid. 無效的VPC防火牆ID。
400 ErrorVpcFirewallExist The firewall has been configured and cannot be created repeatedly. 防火牆已配置,不能重複建立
400 ErrorUnmarshalJSON An error occurred while parsing JSON. 內部錯誤:JSON解碼錯誤
400 ErrorDBTxError A database transaction error occurred. 內部錯誤:資料庫事務錯誤
400 ErrorVpcOpenApi vpc open api failed 調用 VPC API 失敗
400 ErrorInvalidMemberUid Member uid is invalid 成員帳號錯誤.
400 ErrorVpcIdPara vpc id and firewall id parameter not exist. 防火牆VPC參數錯誤,請重新選擇。
400 ErrorFirewallNotFound Firewall not found 防火牆不存在
400 ErrorDBNoRow No rows in database. 沒有資料
400 ErrorUserNotFound User not found 使用者不存在.

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

變更歷史

更多資訊,參考變更詳情