単一 API 呼び出しによる WAF ルール一括更新 - Edge Security Acceleration - Alibaba Cloud - Edge Security Acceleration

指定された 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:BatchUpdateWafRules

update

*サイト。

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
SiteId	integer	必須	サイトの ID。 ListSites 操作を呼び出してサイト ID を取得できます。	1
SiteVersion	integer	任意	サイト構成のバージョン番号。バージョン管理が有効なサイトの場合、このパラメーターを使用して構成が効果を発揮するサイトバージョンを指定できます。デフォルト値は 0 です。	0
Phase	string	任意	WAF ルール実行の位相。このバッチ操作でサポートされるのは以下の 2 つの位相のみです。その他の位相については、単一ルール操作 `UpdateWafRule` を使用してください: `http_anti_scan`: スキャン保護ルール `http_bot`: 高度モードボット説明注: `http_anti_scan` および `http_bot` 位相は一括更新のみをサポートします。単一ルール操作 `UpdateWafRule` はこれら 2 つの値を受け付けません。逆に、`http_custom` や `http_whitelist` などの他の位相は、このバッチ操作ではなく単一ルール操作を使用してのみ更新できます。必須制約: このパラメーターは仕様上オプション (required: false) とマークされていますが、このバッチ操作を呼び出す際は必須です。Phase パラメーターがないとサーバーは対象のルールセットを特定できず、指定されていない場合は `InvalidParameter(400)` を返します。	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` (ルール名)、`Expression` (マッチ式)、`Action` (ルール操作) を含める必要があります。その他の位相では、Shared の必須サブフィールドは特定の位相によって異なります。
Configs	array	任意	ルール構成のリスト。各ルールの詳細なスキャン構成を指定します。各位相の必須サブフィールド (このバッチ操作でサポートされる 2 つの位相にのみ適用): `http_anti_scan`: `Type` および `ManagedList` または `RateLimit` の少なくとも一方を指定する必要があります。 `http_bot`: 高度モードボットの構成を指定する必要があります。サブフィールドは `WafRuleConfig` データ構造で定義されています。説明注: `http_custom` や `http_whitelist` などの他の位相では、このバッチ操作を使用できません。代わりに単一ルール操作 `UpdateWafRule` を使用してください。これらの位相のサブフィールド制約については、単一ルール操作のドキュメントに記載されています。説明重要: `Configs` が欠落しているか、サブフィールドが不完全な場合、サーバーは `InvalidParameter(400)` または `Rule.Config.Malformed` を返します。	10000001
	WafRuleConfig	任意	ルールの構成。

レスポンスフィールド

フィールド	型	説明	例
	object	応答のスキーマ。
RequestId	string	リクエストの ID。	36af3fcc-43d0-441c-86b1-428951dc8225

例

成功レスポンス

JSONJSON

{
  "RequestId": "36af3fcc-43d0-441c-86b1-428951dc8225"
}

エラーコード

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	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.	指定されたルールセットが存在しないか、現在のシステム構成に登録されていません。ルールセット識別子が正しく、システムのルールセットレジストリ内で正しく定義および維持されているルールセットを指していることを確認してください。ルールセットが新規エンティティである場合は、その作成および登録に必要な手順が正常に完了し、利用可能になっていることを確認してください。
403	Expression.Invalid	The specified expression is invalid: %s.	指定された式が無効です。

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

変更履歴

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