保護ルールエンジン機能の保護ルールグループと、特定のドメイン名のインテリジェントルールホスティング機能のステータスを設定します。

使用上の注意

SetDomainRuleGroup操作を呼び出して、保護ルールエンジン機能の保護ルールグループと、特定のドメイン名のインテリジェントルールホスティング機能のステータスを設定できます。

保護ルールグループを構成するときは、Web Application Firewall (WAF) が提供する緩い、中程度、または厳密な保護ルールグループを使用できます。 カスタム保護ルールグループを使用することもできます。

重要 Youを作成できませんカスタム保護ルールによるグループ通話、API操作。 ドメイン名のカスタム保護ルールグループを設定するには、WAFコンソールにログインし、[システム管理] > [保護ルールグループ] を選択します。 保護ルールグループ］ページで、カスタム保護ルールグループを作成し、そのIDを記録します。次に、SetDomainRuleGroup操作を呼び出して、ドメイン名に対するカスタム保護ルールグループを設定します。

制限事項

この操作は、1アカウントにつき1秒間に10回まで呼び出すことができます。1秒間に呼び出す回数が制限を超えた場合、スロットリングが発生します。その結果、お客様の業務に支障をきたす可能性があります。この操作を呼び出すときは、制限に注意することをお勧めします。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 SetDomainRuleGroup

実行する操作です。 Set the value to SetDomainRuleGroup.

Domains String 必須 ["www.aliyundoc.com"]

保護ルールグループを設定するドメイン名のリストです。値はJSON配列で構成される文字列です。

複数のドメイン名を指定することができます。["<Domain name 1>","<Domain name 2>",...]のフォーマットで表示されます。

注 You can call the DescribeDomainList オペレーションを使用して、WAFによって保護されているすべてのドメイン名を照会します。
RuleGroupId Long 必須 1012

ドメイン名に設定されている保護ルールグループのID。 設定可能な値は以下のとおりです。

  • 1011: 組み込みの厳密なルールグループ
  • 1012: 組み込みの中ルールグループ
  • 1013: 組み込みの緩いルールグループ

また、カスタムルールグループのIDを設定することができます。

注 カスタムルールグループのIDを取得するには、WAFコンソールにログインし、[システム管理]> [保護ルールグループ] を選択します。
WafVersion Long 任意 1

Theバージョン番号現在の構成、実装するために使用楽観ロック。

InstanceId String 必須 waf-cn-tl32ast****

WAFインスタンスのID。

注 DescribeInstanceInfo操作を呼び出して、WAFインスタンスのIDを照会できます。
ResourceGroupId String 任意 rg-acfm2pz25js ****

resource Managementでドメイン名が属するリソースグループのID。

このパラメータを指定しない場合、WAFインスタンスはデフォルトのリソースグループに属します。.

WafAiStatus Integer 任意 1

インテリジェントルールのホスティング機能のステータス。 設定可能な値は以下のとおりです。

  • 0: 無効
  • 1: enabled. デフォルト値です。

インテリジェントルールホスティング機能は、過去のネットワークトラフィックのパターンを自動的に学習し、特定のシナリオで通常のリクエストをブロックする可能性のある保護ルールを特定し、その保護ルールをWeb侵入防御のためのホワイトリストに追加します。通常のリクエストをブロックするリスクが解消された後、インテリジェントルールホスティング機能はホワイトリストから保護ルールを削除します。

Alibaba Cloud APIのすべての操作には、共通のリクエストパラメータを含める必要があります。共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

サンプルリクエストの詳細については、このトピックの「例」を参照してください。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String D7861F61-5B61-46CE-A47C-6B19160D5EB0

リクエストの ID です。

例

リクエストの例

http(s)://[Endpoint]/?Action=SetDomainRuleGroup
&ドメイン=["www.aliyundoc.com"]
&RuleGroupId=1012
&InstanceId=waf-cn-tl32ast ****
&共通リクエストパラメータ

正常に処理された場合のレスポンス例

XML 形式 

HTTP/1.1 200 OK
Content-Type:application/xml

<SetDomainRuleGroupResponse>
    <RequestId>D7861F61-5B61-46CE-A47C-6B19160D5EB0</RequestId>
</SetDomainRuleGroupResponse>

JSON 形式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "D7861F61-5B61-46CE-A47C-6B19160D5EB0"
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。