すべてのプロダクト
Search

このプロダクト

    Cloud Firewall:CreateVpcFirewallConfigure

    ドキュメントセンター

    Cloud Firewall:CreateVpcFirewallConfigure

    最終更新日:Jun 18, 2026

    Express Connect経由で接続された2つのVPC間のトラフィックを保護する仮想プライベートクラウド（VPC）ファイアウォールを作成します。

    操作説明

    このオペレーションは、VPCファイアウォールを作成するために使用されます。この仮想プライベートクラウド（VPC）ファイアウォールは、Express Connect 経由で接続された2つのVPC 間のトラフィックを保護します。このVPCファイアウォールは、リージョン間トラフィック、アカウント間トラフィック、またはVPCと仮想ボーダールーター（VBR）間のトラフィックの保護をサポートしていません。詳細については、VPCファイアウォールの制限を参照してください。

    レート制限

    このオペレーションのシングルユーザーQPS 制限は、1 秒あたり10 回の呼び出しです。この制限を超えると、API 呼び出しがスロットリングされ、ビジネスに影響を与える可能性があります。呼び出しを適切に管理してください。

    今すぐお試しください

    この 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:CreateVpcFirewallConfigure

    create

    *VpcFirewall

    acs:cloudfirewall::{#accountId}:vpcfirewall/*

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Lang

    string

    任意

    リクエストとレスポンスの言語。有効な値：

    • zh（デフォルト）：中国語。

    • en：英語。

    zh
    VpcFirewallName

    string

    必須

    仮想プライベートクラウド（VPC）ファイアウォールのインスタンス名。

    test-vpc-firewall
    LocalVpcId

    string

    必須

    ローカルVPCのインスタンスID。

    vpc-8vbwbo90rq0anm6t****
    LocalVpcRegion

    string

    必須

    ローカルVPCのリージョンID。

    説明

    Cloud Firewallがサポートするリージョンの詳細については、サポートされるリージョンを参照してください。

    cn-hangzhou
    PeerVpcId

    string

    必須

    ピアVPCのインスタンスID。

    vpc-wb8vbo90rq0anm6t****
    PeerVpcRegion

    string

    必須

    ピアVPCのリージョンID。

    説明

    Cloud Firewallがサポートするリージョンの詳細については、サポートされるリージョンを参照してください。

    cn-shanghai
    FirewallSwitch

    string

    必須

    VPCファイアウォール作成後の有効化ステータスの設定。有効な値：

    • open（デフォルト）：VPCファイアウォール作成後、保護が自動的に有効になります。

    • close：VPCファイアウォール作成後、保護は自動的に有効になりません。 ModifyVpcFirewallSwitchStatus オペレーションを呼び出して保護を有効にできます。

    open
    LocalVpcCidrTableList

    string

    必須

    ローカルVPCのCIDRブロックリスト（JSON 形式）。このパラメーターには以下のフィールドが含まれます：

    • RouteTableId：ローカルVPCのルートテーブルID。

    • RouteEntryList：JSON 形式で指定します。このフィールドにはDestinationCidr（ローカルVPCの宛先 CIDRブロック）とNextHopInstanceId（ローカルVPCのネクストホップインスタンスID）が含まれます。

    [{"RouteTableId":"vtb-1234","RouteEntryList":[{"DestinationCidr":"192.168.XX.XX/24","NextHopInstanceId":"vrt-m5eb5me6c3l5sezae****"}]},{"RouteTableId":"vtb-1235","RouteEntryList":[{"DestinationCidr":"192.168.XX.XX/24","NextHopInstanceId":"vrt-m5eb5me6c3l5sezae****"}]}]
    PeerVpcCidrTableList

    string

    必須

    ピアVPCのCIDRブロックリスト（JSON 形式）。このパラメーターには以下のフィールドが含まれます：

    • RouteTableId：ピアVPCのルートテーブルID。

    • RouteEntryList：JSON 形式で指定します。このフィールドにはDestinationCidr（ピアVPCの宛先 CIDRブロック）とNextHopInstanceId（ピアVPCのネクストホップインスタンスID）が含まれます。

    [{"RouteTableId":"vtb-1234","RouteEntryList":[{"DestinationCidr":"192.168.XX.XX/24","NextHopInstanceId":"vrt-m5eb5me6c3l5sezae****"}]},{"RouteTableId":"vtb-1235","RouteEntryList":[{"DestinationCidr":"192.168.XX.XX/24","NextHopInstanceId":"vrt-m5eb5me6c3l5sezae****"}]}]
    MemberUid

    string

    任意

    Alibaba Cloudメンバーアカウントの UID。

    258039427902****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    VpcFirewallId

    string

    仮想プライベートクラウド（VPC）ファイアウォールのインスタンスID。

    vfw-m5e7dbc4y****
    RequestId

    string

    リクエストID。

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

    例

    成功レスポンス

    JSONJSON

    {
  "VpcFirewallId": "vfw-m5e7dbc4y****",
  "RequestId": "850A84D6-0DE4-4797-A1E8-00090125h4j6"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 ErrorAliUid Aliuid invalid.
    400 ErrorInvalidMemberUid Member uid is invalid
    400 ErrorFirewallName Firewall name invalid.
    400 ErrorVpcFirewallExist Vpc firewall already exist.
    400 ErrorVpcIdError Vpc ID invalid.
    400 ErrorRegionNoError Region invalid.
    400 ErrorDestCidrError The destination CIDR block is invalid.
    400 ErrorDestCidrEmpty The target network segment is empty and cannot be created
    400 ErrorSameCidrIp The same network segment cannot be configured repeatedly. Please reselect the network segment.
    400 ErrorDBSelectError A database select error occurred.
    400 ErrorCidrFormat Cidr ip format error.
    400 ErrorCidrIpAddress cidr ip error.
    400 ErrorCustomRouteEntryMax custom route exceeds maximum limit.
    400 ErrorVpcFirewallNotFound Vpc firewall not found.
    400 ErrorInvalidMemberUidStatus invalid member uid status.
    400 ErrorGeneralInstanceSpecFull Cloud Firewall instance specifications are full.
    400 ErrorBandwidthPenalty Cloud Firewall bandwidth is being overused.
    400 ErrorCenVpcEcConflict The cloud enterprise network VPC conflicts with the Express Connect VPC.
    400 ErrorFirewallQuotaNotEmpty The quota for VPC firewalls is exceeded.
    400 ErrorRouteTableIdNotFound Route table id not found.

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

    変更履歴

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