すべてのプロダクト
Search

このプロダクト

    Edge Security Acceleration:BatchCreateWafRules

    ドキュメントセンター

    Edge Security Acceleration:BatchCreateWafRules

    最終更新日:Jul 07, 2026

    指定された WAF 位相でルールをバッチ作成します。一度に複数のルールを作成し、これらのルールに共通の設定を構成できます。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    esa:BatchCreateWafRules

    create

    *サイト。

    acs:esa:{#regionId}:{#accountId}:site/{#SiteId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    SiteId

    integer

    必須

    サイトの ID。 ListSites 操作を呼び出してサイト ID を取得できます。

    1
    SiteVersion

    integer

    任意

    サイト構成のバージョン番号。バージョン管理が有効なサイトの場合、このパラメーターを使用して構成が効果を発揮するサイトバージョンを指定できます。デフォルト値は 0 です。

    0
    Phase

    string

    任意

    WAF ルールの実行位相。このバッチ操作は次の 2 つの位相のみをサポートします。その他の位相については、単一ルール操作の CreateWafRule または UpdateWafRule を使用してください。

    • http_anti_scan: スキャン保護ルール

    • http_bot: 高度モードボット

    説明

    注意: http_anti_scan および http_bot 位相はバッチ作成のみをサポートします。単一ルール操作の CreateWafRule はこれら 2 つの値を受け付けません。逆に、http_custom や http_whitelist などの他の位相は単一ルール操作でのみ作成可能であり、このバッチ操作は使用できません。

    必須制約: このパラメーターは仕様上オプション (required: false) とマークされていますが、このバッチ操作を呼び出す際は必須です。このパラメーターを指定しない場合、サービスは InvalidParameter(400) を返します。

    プラン前提条件: http_anti_scan にはサイトにHigh 以上のプランが必要です。Basic プランでこの操作を呼び出すと Phase.HttpAntiScan.NotSupport が返されます。この操作を呼び出す前にサイトのプランを確認してください。

    http_anti_scan
    RulesetId

    integer

    任意

    WAF ルールセットの ID。 ListWafRulesets 操作を呼び出してルールセット ID を取得できます。

    10000001
    Shared WafBatchRuleShared

    任意

    複数ルールの共有構成。複数ルールの共通プロパティを指定します。

    条件付き必須: このパラメーターは仕様上オプション (required: false) とマークされていますが、Phase=http_anti_scan の場合は必須です。このパラメーターを指定しない場合、サービスは InvalidParameter(400) を返します。

    サブフィールド要件: http_anti_scan 位相では、Shared に Name (ルール名) や Action (ルール操作) などの共有フィールドを含める必要があります。その他の位相では、Shared の必須サブフィールドは特定の位相によって異なります。

    Configs

    array

    任意

    ルール構成のリスト。各ルールの詳細な構成を指定します。

    各位相の必須サブフィールド (このバッチ操作でサポートされる 2 つの位相にのみ適用):

    • http_anti_scan: Type および ManagedList または RateLimit の少なくとも一方を指定する必要があります。

    • http_bot: 高度モードボットの構成を指定する必要があります。サブフィールドは WafRuleConfig データ構造で定義されています。

    説明

    注意: http_custom や http_whitelist などの他の位相では、このバッチ操作を使用できません。代わりに単一ルール操作の CreateWafRule を使用してください。サブフィールドの制約については、単一ルール操作のドキュメントに記載されています。

    説明

    Configs が指定されていないか、必須サブフィールドが欠落している場合、サービスは InvalidParameter(400) または Rule.Config.Malformed を返します。

    WafRuleConfig

    任意

    ルール構成。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答のスキーマ。

    RequestId

    string

    リクエスト ID。

    36af3fcc-43d0-441c-86b1-428951dc8225
    RulesetId

    integer

    WAF ルールセットの ID。 ListWafRulesets 操作を呼び出してルールセット ID を取得できます。

    10000001
    Ids

    array

    WAF ルールの ID。 ListWafRules 操作を呼び出してルール ID を取得できます。

    integer

    WAF ルールの ID。 ListWafRules 操作を呼び出してルール ID を取得できます。

    20000001

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "36af3fcc-43d0-441c-86b1-428951dc8225",
  "RulesetId": 10000001,
  "Ids": [
    20000001
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParameter The specified parameter is invalid. 入力パラメーターのフォーマット検証が失敗しました。有効な値を指定してください。
    400 InternalException Failed to call the service. Try again later or contact technical support. サービスの呼び出しに失敗しました。後でもう一度お試しいただくか、詳細についてはカスタマーサポートにお問い合わせください。
    400 SpecifiedVersionReadOnly The specified version number is read-only and cannot be modified. 指定されたバージョンは読み取り専用です。バージョン構成は変更できません。
    403 %s.NotSupport The specified resource type %s is not supported. 指定されたリソースタイプはサポートされていません。このリソースタイプを使用するには、連絡先までお問い合わせください。
    403 %s.OverQuota The quantity of %s exceeds the quota. リソース数がクォータ制限を超えています。クォータの引き上げをリクエストする場合は、連絡先までお問い合わせください。
    403 %s.WrongValueMatched The value of specified parameter %s can not pass the matching check. 需要手动添加日文描述
    403 Rule.Config.Malformed The format of the rule configuration is invalid.Check the configuration for syntax errors or structural inconsistencies and correct them to meet the requirements. 指定されたルール構成のフォーマットが正しくないか、必須のフォーマットに準拠していません。ルール構成に構文エラーや構造上の不整合がないか確認し、期待される構成スキーマに準拠するように修正してください。
    403 Rule.Config.Noncompliance The specified rule configuration does not meet the compliance requirements.Check and adjust your configurations. 指定されたルール構成が確立されたコンプライアンス基準を満たしていません。ルール設定に不一致や基準違反がないか確認し、すべてのルールが正しく検証されるように必要な調整を行ってください。
    403 Ruleset.Name.AlreadyExists The specified rule set name already exists.Try again with a unique name or modify the existing rule set name. 指定されたルールセット名は、システムのルール管理フレームワーク内に既に存在します。重複や既存のルールセットとの潜在的な競合を避けるため、一意の代替名を選択してください。既存のルールセットの名前を変更する場合は、新しい名前が一意であり、他の確立されたルールセットの識別子と競合しないことを確認してください。
    403 Site.NotExist The specified website does not exist or is not recognized by the system.Check whether the specified website identifier is valid and matches a website that is active, defined, and recognized by the system.If you want to add a new website, make sure that the creation and registration process is complete to integrate the website to the system. 指定されたサイトが存在しないか、現在システムによって認識されていません。サイト識別子が正確であり、システムの認識済みサイトネットワーク内で定義され、現在アクティブな読み取りが可能で、アクセス可能なサイトと一致することを確認してください。サイトが新規追加を目的としている場合は、システムに統合するための適切な作成または登録プロセスが完了していることを確認してください。
    403 Expression.Invalid The specified expression is invalid: %s. 指定された式が無効です。
    403 Ruleset.NotExist The specified rule set does not exist or has not been registered in the system.Check whether the specified rule set identifier is valid and matches a rule set that has been correctly defined and maintained by the system's rule set registry.If you want to add a new rule set, make sure that the creation and registration process is complete to bring the rule set into effect. 指定されたルールセットが存在しないか、現在のシステム構成に登録されていません。ルールセット識別子が正しく、システムのルールセットレジストリ内で正しく定義および維持されているルールセットを指していることを確認してください。ルールセットが新規エンティティである場合は、その作成および登録に必要な手順が正常に完了し、利用可能になっていることを確認してください。

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

    変更履歴

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