すべてのプロダクト
Search
ドキュメントセンター

Cloud Firewall:DescribeVpcFirewallCenDetail

最終更新日:Aug 01, 2026

Cloud Enterprise Network (CEN) インスタンス内のネットワークインスタンスと指定された VPC 間のトラフィックを保護する仮想非公開クラウド (VPC) ファイアウォールの詳細を照会します。

操作説明

この操作は、仮想非公開クラウド (VPC) ファイアウォールの詳細をクエリするために使用されます。VPC ファイアウォールは、CEN インスタンス内のネットワークインスタンス (VPC、仮想ボーダールーター (VBR)、Cloud Connect Network (CCN) を含む) と指定された VPC 間のトラフィックを保護します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

yundun-cloudfirewall:DescribeVpcFirewallCenDetail

get

*VpcFirewallCen。

acs:cloudfirewall::{#accountId}:vpcfirewallcen/{#VpcFirewallId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

Lang

string

任意

リクエストおよび応答の言語。有効な値:

zh

VpcFirewallId

string

必須

仮想非公開クラウド (VPC) ファイアウォールのインスタンス ID。

vfw-m5e7dbc4y****

NetworkInstanceId

string

任意

VPC ファイアウォールの作成に使用する VPC インスタンス ID。

vpc-2zefk9fbn8j7v585g****

レスポンスフィールド

フィールド

説明

object

ConnectType

string

仮想非公開クラウド (VPC) ファイアウォールの接続性タイプ。有効な値: cen (Cloud Enterprise Network を示します)。

cen

VpcFirewallName

string

仮想非公開クラウド (VPC) ファイアウォールのインスタンス名。

vpc-firewall-test

VpcFirewallId

string

仮想非公開クラウド (VPC) ファイアウォールのインスタンス ID。

vfw-m5e7dbc4y****

FirewallSwitchStatus

string

仮想非公開クラウド (VPC) ファイアウォールのスイッチステータス。有効な値:

opened

RequestId

string

リクエスト ID。

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

LocalVpc

object

VPC の詳細。

VpcId

string

VPC のインスタンス ID。

vpc-8vbwbo90rq0anm6t****

TransitRouterType

string

CEN トランジットルーター (CEN-TR) のバージョン。有効な値:

Basic

RouteMode

string

ルーティングモード。有効な値:

auto

NetworkInstanceId

string

VPC ファイアウォールの作成に使用する VPC インスタンス ID。

vpc-2zefk9fbn8j7v585g****

RegionNo

string

VPC のリージョン ID。

cn-hangzhou

ManualVSwitchId

string

ルーティングモードが手動の場合に指定される vSwitch の ID。

vsw-zeq4o875u****

OwnerId

string

VPC が属する Alibaba Cloud アカウントの UID。

158039427902****

NetworkInstanceType

string

ネットワークインスタンスのタイプ。有効な値: VPC

VPC

VpcName

string

VPC のインスタンス名。

vpc-firewall-test

SupportManualMode

string

ルーティングモードが手動モードをサポートしているかどうかを示します。有効な値:

0

TransitRouterId

string

CEN-TR のインスタンス ID。

tr-2zetwxskej633l3u1****

AttachmentId

string

ネットワークインスタンスの接続 ID。

tr-attach-sxig7bye51fid5****

NetworkInstanceName

string

ネットワークインスタンスの名前。

test-vpc

AttachmentName

string

ネットワークインスタンスの接続名。

local-test

VpcCidrTableList

array<object>

VPC の CIDR ブロックリスト。

array<object>

RouteTableId

string

VPC のルートテーブル ID。

vtb-1234

RouteEntryList

array<object>

VPC のルートエントリリスト。

object

NextHopInstanceId

string

VPC 内のネクストホップのインスタンス ID。

vrt-m5eb5me6c3l5sezae****

DestinationCidr

string

VPC の送信先 CIDR ブロック。

192.168.XX.XX/24

EniList

array<object>

ネットワークインターフェースコントローラー (NIC) リスト。

object

EniId

string

VPC 内のネットワークインターフェースのインスタンス ID。

eni-8vbhfosfqv2rff42****

EniPrivateIpAddress

string

VPC 内のネットワークインターフェースの非公開 IP。

192.168.XX.XX

EniVSwitchId

string

VPC 内のネットワークインターフェースの vSwitch ID。

vsw-wz9viido7j436b0n1****

EniZoneId

string

cn-hangzhou-i

DefendCidrList

array

仮想非公開クラウド (VPC) ファイアウォールによって保護される CIDR ブロック。

string

仮想非公開クラウド (VPC) ファイアウォールによって保護される CIDR ブロック。

10.0.XX.XX/24

FirewallVpc

object

ファイアウォールが使用する VPC。

VpcId

string

VPC インスタンス ID。

vpc-bp1245k5oagy2bp74****

VpcCidr

string

VPC の CIDR ブロック。

10.0.0.0/8

VswitchId

string

vSwitch ID。

vsw-bp1sqg9wms9wxcs1****

VswitchCidr

string

vSwitch の CIDR ブロック。

10.0.0.1/24

ZoneId deprecated

string

ファイアウォールのプライマリゾーン ID。

cn-hangzhou-i

AllowConfiguration

integer

CEN Basic Edition 用の VPC ファイアウォールを作成する際に、ファイアウォール VPC の CIDR ブロックの設定が許可されているかどうかを示します。有効な値:

0

VswitchZoneId

string

vSwitch のゾーン ID。

cn-hangzhou-i

StandbyZoneId deprecated

string

ファイアウォールのセカンダリゾーン ID。

cn-hangzhou-k

FirewallServiceMode

string

VPC ファイアウォールサービスのデプロイモード。有効な値: PrimaryStandby (アクティブ/スタンバイモード) および MultiPrimary (アクティブ/アクティブモード)。

PrimaryStandby

FirewallServiceZones

array

VPC ファイアウォールサービスが使用するゾーン ID。

string

VPC ファイアウォールサービスが使用するゾーン ID。

cn-hangzhou-i

成功レスポンス

JSONJSON

{
  "ConnectType": "cen。",
  "VpcFirewallName": "vpc-firewall-test",
  "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": "vpc-firewall-test",
    "SupportManualMode": "0",
    "TransitRouterId": "tr-2zetwxskej633l3u1****",
    "AttachmentId": "tr-attach-sxig7bye51fid5****",
    "NetworkInstanceName": "test-vpc。",
    "AttachmentName": "local-test。",
    "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****",
        "EniZoneId": "cn-hangzhou-i"
      }
    ],
    "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。",
    "FirewallServiceMode": "PrimaryStandby",
    "FirewallServiceZones": [
      "cn-hangzhou-i"
    ]
  }
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 ErrorAliUid The aliuid is invalid.
400 ErrorDBSelectError A database select error occurred.
400 ErrorVpcFirewallId The VPC firewall ID is invalid.
400 ErrorVpcFirewallExist The firewall has been configured and cannot be created repeatedly.
400 ErrorUnmarshalJSON An error occurred while parsing JSON.
400 ErrorDBTxError A database transaction error occurred.
400 ErrorVpcOpenApi vpc open api failed
400 ErrorInvalidMemberUid Member uid is invalid
400 ErrorVpcIdPara vpc id and firewall id parameter not exist.
400 ErrorFirewallNotFound Firewall not found
400 ErrorDBNoRow No rows in database.
400 ErrorUserNotFound User not found

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。