すべてのプロダクト
Search

このプロダクト

    Cloud Firewall:CreateVpcFirewallControlPolicy

    ドキュメントセンター

    Cloud Firewall:CreateVpcFirewallControlPolicy

    最終更新日:Jul 20, 2026

    指定された VPC ファイアウォールポリシーグループにアクセス制御ポリシーを追加します。

    操作説明

    この操作は、指定された VPC ファイアウォールポリシーグループにアクセス制御ポリシーを追加するために使用されます。VPC ファイアウォールが Cloud Enterprise Network (CEN) インスタンスを介して接続された 2 つの VPC 間のトラフィックを保護する場合と、Express Connect 回線を介して接続された 2 つの VPC 間のトラフィックを保護する場合では、異なるアクセス制御ポリシーが使用されます。

    QPS 制限

    この操作の単一ユーザー QPS 制限は、1 秒あたり 10 回の呼び出しです。呼び出し回数が制限を超えると速度制限がトリガーされ、ビジネスに影響を与える可能性があります。この操作は適切に呼び出してください。

    今すぐお試しください

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

    create

    *VpcFirewallControlPolicy。

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Lang

    string

    任意

    リクエストおよびレスポンスの言語。有効な値:

    • zh (デフォルト): 中国語

    • en: 英語

    zh
    AclAction

    string

    必須

    VPC ファイアウォールのアクセス制御ポリシーにおいて、Cloud Firewall がトラフィックに対して実行する操作。有効な値:

    • accept: トラフィックを許可します。

    • drop: トラフィックを拒否します。

    • log: トラフィックを監視します。

    accept。
    ApplicationName deprecated

    string

    任意

    VPC ファイアウォールのアクセス制御ポリシーでサポートされるアプリケーションタイプ。有効な値:

    • FTP

    • HTTP

    • HTTPS

    • MySQL

    • SMTP

    • SMTPS

    • RDP

    • VNC

    • SSH

    • Redis

    • MQTT

    • MongoDB

    • Memcache

    • SSL

    • ANY: すべてのアプリケーションタイプ

    HTTP。
    Description

    string

    必須

    VPC ファイアウォールのアクセス制御ポリシーの説明。

    test。
    DestPort

    string

    任意

    トラフィックアクセス用の VPC ファイアウォールのアクセス制御ポリシーにおける宛先ポート。

    説明

    DestPortType が port に設定されている場合、このパラメーターを設定します。Proto が TCP/UDP/ICMP に設定されている場合、DestPort (DestPortType=port) または DestPortGroup (DestPortType=group) のいずれかが条件付きで必須です。それ以外の場合、ErrorParametersDestPort(400) が返されます。

    80
    Destination

    string

    必須

    トラフィックアクセス用の VPC ファイアウォールのアクセス制御ポリシーにおける送信先アドレス。有効な値:

    • DestinationType が net に設定されている場合、Destination の値は送信先 CIDR ブロックです。

    • DestinationType が group に設定されている場合、Destination の値は送信先アドレス帳の名前です。

    • DestinationType が domain に設定されている場合、Destination の値は送信先ドメイン名です。

    10.2.XX.XX/24
    DestinationType

    string

    必須

    VPC ファイアウォールのアクセス制御ポリシーにおける送信先アドレスのタイプ。有効な値:

    • net: 送信先 CIDR ブロック

    • group: 送信先アドレス帳

    • domain: 送信先ドメイン名

    net。
    VpcFirewallId

    string

    必須

    VPC ファイアウォールのアクセス制御ポリシーグループの ID。

    • VPC ファイアウォールが CEN インスタンスを介して接続された 2 つの VPC 間のトラフィックを保護する場合、このパラメーターの値は CEN インスタンス ID です。

    • VPC ファイアウォールが Express Connect 回線を介して接続された 2 つの VPC 間のトラフィックを保護する場合、このパラメーターの値は VPC ファイアウォールインスタンス ID です。

    説明

    ID をクエリするには、 DescribeVpcFirewallAclGroupList 操作を呼び出します。

    vfw-a42bbb7b887148c9****
    Proto

    string

    必須

    VPC ファイアウォールのアクセス制御ポリシーにおけるトラフィックアクセスのセキュリティプロトコルタイプ。有効な値:

    • ANY: 任意のプロトコルタイプ

    • TCP

    • UDP

    • ICMP

    TCP。
    Source

    string

    必須

    VPC ファイアウォールのアクセス制御ポリシーにおけるソースアドレス。

    • SourceType が net に設定されている場合、Source の値はソース CIDR ブロックです。

    • SourceType が group に設定されている場合、Source の値はソースアドレス帳の名前です。

    10.2.XX.XX/24
    SourceType

    string

    必須

    VPC ファイアウォールのアクセス制御ポリシーにおけるソースアドレスのタイプ。有効な値:

    • net: ソース CIDR ブロック

    • group: ソースアドレス帳

    net。
    NewOrder

    string

    必須

    VPC ファイアウォールのアクセス制御ポリシーの優先度。

    優先度の値は 1 から始まり、増分ごとに増加します。値が小さいほど優先度が高くなります。

    1
    DestPortType

    string

    任意

    VPC ファイアウォールのアクセス制御ポリシーにおけるトラフィックアクセスの宛先ポートのタイプ。有効な値:

    • port: ポート

    • group: ポートアドレス帳

    port。
    DestPortGroup

    string

    任意

    VPC ファイアウォールのアクセス制御ポリシーにおけるトラフィックアクセスの宛先ポートアドレス帳の名前。

    説明

    DestPortType が group に設定されている場合、このパラメーターを設定します。

    my_port_group。
    MemberUid

    string

    任意

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

    258039427902****
    Release

    string

    任意

    アクセス制御ポリシーを有効にするかどうかを指定します。ポリシーは作成後、デフォルトで有効になります。有効な値:

    • true: アクセス制御ポリシーを有効にします。

    • false: アクセス制御ポリシーを有効にしません。

    true。
    ApplicationNameList

    array

    任意

    アクセス制御ポリシーでサポートされるアプリケーションタイプ。

    string

    任意

    アクセス制御ポリシーでサポートされるアプリケーションタイプ。有効な値:

    • FTP

    • HTTP

    • HTTPS

    • Memcache

    • MongoDB

    • MQTT

    • MySQL

    • RDP

    • Redis

    • SMTP

    • SMTPS

    • SSH

    • SSL_No_Cert

    • SSL

    • VNC

    • ANY: すべてのアプリケーションタイプ

    説明

    サポートされるアプリケーションタイプは、プロトコルタイプ (Proto) の値によって異なります。Proto が TCP に設定されている場合、ApplicationNameList は上記のすべてのアプリケーションタイプをサポートします。["HTTP","HTTPS",……] のフォーマットを使用します。Proto が UDP、ICMP、または ANY に設定されている場合、ApplicationNameList は ANY のみをサポートします。ApplicationNameList または ApplicationName のいずれかを指定する必要があります。両方を空にすることはできません。ApplicationNameList と ApplicationName の両方が指定されている場合、ApplicationNameList が優先されます。

    [ "ANY" ]
    RepeatType

    string

    任意

    アクセス制御ポリシーのポリシー有効期間の繰り返し頻度のタイプ。有効な値:

    • Permanent (デフォルト): 常時

    • None: 1 回のみ

    • Daily: 毎日

    • Weekly: 毎週

    • Monthly: 毎月

    列挙値:

    • Daily :

      毎日。

    • Monthly :

      毎月。

    • Permanent :

      常時。

    • Weekly :

      毎週。

    • None :

      1 回のみ。

    Permanent。
    RepeatDays

    array

    任意

    アクセス制御ポリシーが効果を持つ曜日または日付。

    • RepeatType が Permanent、None、または Daily に設定されている場合、RepeatDays は空のコレクションです。 例: []

    • RepeatType が Weekly に設定されている場合、RepeatDays を空にすることはできません。 例: [0, 6]

    説明

    RepeatType が Weekly に設定されている場合、RepeatDays に重複する値は指定できません。

    • RepeatType が Monthly に設定されている場合、RepeatDays を空にすることはできません。 例: [1, 31]

    説明

    RepeatType が Monthly に設定されている場合、RepeatDays に重複する値は指定できません。

    integer

    任意

    アクセス制御ポリシーのポリシー有効期間の繰り返し頻度の曜日または日付。

    説明

    RepeatType が Weekly に設定されている場合、有効な値は 0 ～ 6 です。週は日曜日に始まります。 RepeatType が Monthly に設定されている場合、有効な値は 1 ～ 31 です。

    1
    RepeatStartTime

    string

    任意

    アクセス制御ポリシーのポリシー有効期間の繰り返し開始時刻。例: 08:00。値は正時または 30 分単位である必要があり、繰り返し終了時刻より少なくとも 30 分前でなければなりません。

    説明

    RepeatType が Permanent または None に設定されている場合、RepeatStartTime は空です。RepeatType が Daily、Weekly、または Monthly に設定されている場合、RepeatStartTime には値が必要です。フォーマット: HH:MM (24 時間時計)。例: 08:00。

    08:00
    RepeatEndTime

    string

    任意

    アクセス制御ポリシーのポリシー有効期間の繰り返し終了時刻。例: 23:30。値は正時または 30 分単位である必要があり、繰り返し開始時刻より少なくとも 30 分後でなければなりません。

    説明

    RepeatType が Permanent または None に設定されている場合、RepeatEndTime は空です。RepeatType が Daily、Weekly、または Monthly に設定されている場合、RepeatEndTime には値が必要です。フォーマット: HH:MM (24 時間時計)。例: 08:00。

    23:30
    StartTime

    integer

    任意

    アクセス制御ポリシーのポリシー有効期間の開始時刻。値は秒単位の UNIX タイムスタンプです。値は正時または 30 分単位である必要があり、終了時刻より少なくとも 30 分前でなければなりません。

    説明

    RepeatType が Permanent に設定されている場合、StartTime は空です。RepeatType が None、Daily、Weekly、または Monthly に設定されている場合、StartTime には値が必要です。

    1694761200
    EndTime

    integer

    任意

    アクセス制御ポリシーのポリシー有効期間の終了時刻。値は秒単位の UNIX タイムスタンプです。値は正時または 30 分単位である必要があり、開始時刻より少なくとも 30 分後でなければなりません。

    説明

    RepeatType が Permanent に設定されている場合、EndTime は空です。RepeatType が None、Daily、Weekly、または Monthly に設定されている場合、EndTime には値が必要です。

    1694764800
    DomainResolveType

    string

    任意

    アクセス制御ポリシーのドメイン名の解像度メソッド。有効な値:

    • FQDN: FQDN ベース

    • DNS: DNS ベースの動的名前解決

    • FQDN_AND_DNS: FQDN および DNS ベースの動的名前解決

    FQDN。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    AclUuid

    string

    アクセス制御ポリシーの一意の ID。

    00281255-d220-4db1-8f4f-c4df221ad84c
    RequestId

    string

    リクエスト ID。

    CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D。

    例

    成功レスポンス

    JSONJSON

    {
  "AclUuid": "00281255-d220-4db1-8f4f-c4df221ad84c",
  "RequestId": "CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 ErrorParametersUid The aliUid parameter is invalid.
    400 ErrorUUIDNew The UUID is invalid.
    400 ErrorParametersSource The source is invalid.
    400 ErrorParametersDestination The Destination parameter is invalid.
    400 ErrorParametersProto The protocol is invalid.
    400 ErrorParametersDestPort The dst_port is invalid.
    400 ErrorParametersAction The action is invalid.
    400 ErrorDBSelect An error occurred while querying database.
    400 ErrorParameters A parameter error occurred.
    400 ErrorAddressCountExceed The maximum number of addresses is exceeded.
    400 ErrorParametersNewOrder The newOrder is invalid.
    400 ErrorDBInsert An error occurred while performing an insert operation in the database.
    400 ErrorDBDelete An error occurred while deleting the database.
    400 ErrorRecordLog An error occurred while updating the operation log.
    400 ErrorParameterIpVersion The IP version is invalid.
    400 ErrorParametersDirection The direction is invalid.
    400 ErrorDomainResolve An error occurred while resolving the domain.
    400 ErrorAclExtendedCountExceed ACL or extended ACL rules are not matched.
    400 ErrorAclDomainAnyCountExceed The number of resolved domain names cannot exceed 200. ACL configuration can be continued for HTTP, HTTPS, SMTP, SMTPS, and SSL applications.
    400 ErrorMarshalJSON An error occurred. Try again later.
    400 ErrorParametersFtpNotSupport domain destination not support ftp.
    400 ErrorParametersApplicationName Specified parameter ApplicationName is not valid.
    400 ErrorParametersApplicationNameList Specified parameter ApplicationNameList is not valid.
    400 ErrorAddressGroupNotExist The address group does not exist.

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

    変更履歴

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