Edge Security の WAF フェーズ概要 - ESA

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:ListWafPhases

list

*Site

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
SiteId	integer	必須	サイト ID。 ListSites インターフェイスを呼び出すことで取得できます。	1
SiteVersion	integer	任意	サイトのバージョン。	0

レスポンスフィールド

フィールド	型	説明	例
	object	応答のスキーマ
RequestId	string	リクエスト ID。	36af3fcc-43d0-441c-86b1-428951dc8225
Phases	array<object>	WAF 操作フェーズのリスト。
	array<object>	WAF 操作フェーズの詳細。
Phase	string	WAF 操作フェーズの名前。	http_custom
Rulesets	array<object>	WAF ルールセットのリスト。
	object	WAF ルールセットの詳細。
Id	integer	WAF ルールセットの ID。	10000001
Name	string	WAF ルールセットの名前。	example
Shared	WafBatchRuleShared	WAF ルールセット内のルールの共有構成。
Rules	array	WAF ルールセット内のルール構成のリスト。
	WafRuleConfig	WAF ルールセット内のルール構成。

例

成功レスポンス

JSONJSON

{
  "RequestId": "36af3fcc-43d0-441c-86b1-428951dc8225",
  "Phases": [
    {
      "Phase": "http_custom",
      "Rulesets": [
        {
          "Id": 10000001,
          "Name": "example",
          "Shared": {
            "Target": "web",
            "Mode": "automatic",
            "CrossSiteId": 10000001,
            "Name": "example",
            "Match": {
              "Logic": "and",
              "Criteria": [
                {
                  "Logic": "and",
                  "Criteria": [
                    {
                      "Logic": "and",
                      "Criteria": [
                        {
                          "MatchType": "ip.src",
                          "MatchOperator": "eq",
                          "MatchValue": "1.1.1.1",
                          "Negate": true,
                          "ConvertToLower": true
                        }
                      ],
                      "MatchType": "ip.src",
                      "MatchOperator": "eq",
                      "MatchValue": "1.1.1.1",
                      "Negate": true,
                      "ConvertToLower": true
                    }
                  ],
                  "MatchType": "ip.src",
                  "MatchOperator": "eq",
                  "MatchValue": "1.1.1.1",
                  "Negate": true,
                  "ConvertToLower": true
                }
              ],
              "MatchType": "ip.src",
              "MatchOperator": "eq",
              "MatchValue": "1.1.1.1",
              "Negate": true,
              "ConvertToLower": true
            },
            "Action": "deny",
            "Actions": {
              "Response": {
                "Id": 50000001,
                "Code": 403
              }
            },
            "Expression": "ip.src eq 1.1.1.1"
          },
          "Rules": [
            {
              "Status": "on",
              "Action": "deny",
              "Actions": {
                "Response": {
                  "Id": 50000001,
                  "Code": 403
                },
                "Bypass": {
                  "Skip": "part",
                  "RegularRules": [
                    100001
                  ],
                  "CustomRules": [
                    20000001
                  ],
                  "RegularTypes": [
                    "sqli"
                  ],
                  "Tags": [
                    "http_custom"
                  ]
                }
              },
              "ManagedList": "intelligence_crawler",
              "ManagedRulesets": [
                {
                  "ProtectionLevel": 4,
                  "Action": "deny",
                  "ManagedRules": [
                    {
                      "Status": "on",
                      "Action": "deny",
                      "Id": 100001
                    }
                  ],
                  "AttackType": 11,
                  "NumberTotal": 100,
                  "NumberEnabled": 50
                }
              ],
              "Sigchl": [
                "sig"
              ],
              "Name": "example",
              "AppSdk": {
                "CustomSign": {
                  "Value": "examplesignvalue",
                  "Key": "sign"
                },
                "CustomSignStatus": "on",
                "FeatureAbnormal": [
                  "wxbb_invalid_sign"
                ]
              },
              "RateLimit": {
                "Characteristics": {
                  "Logic": "and",
                  "Criteria": [
                    {
                      "Logic": "and",
                      "Criteria": [
                        {
                          "Logic": "and",
                          "Criteria": [
                            {
                              "MatchType": "ip.src",
                              "MatchOperator": "eq",
                              "MatchValue": "1.1.1.1",
                              "Negate": true,
                              "ConvertToLower": true
                            }
                          ],
                          "MatchType": "ip.src",
                          "MatchOperator": "eq",
                          "MatchValue": "1.1.1.1",
                          "Negate": true,
                          "ConvertToLower": true
                        }
                      ],
                      "MatchType": "ip.src",
                      "MatchOperator": "eq",
                      "MatchValue": "1.1.1.1",
                      "Negate": true,
                      "ConvertToLower": true
                    }
                  ],
                  "MatchType": "ip.src",
                  "MatchOperator": "eq",
                  "MatchValue": "1.1.1.1",
                  "Negate": true,
                  "ConvertToLower": true
                },
                "OnHit": true,
                "TTL": 10,
                "Threshold": {
                  "ManagedRulesBlocked": 10,
                  "DistinctManagedRules": 10,
                  "ResponseStatus": {
                    "Ratio": 10,
                    "Count": 10,
                    "Code": 404
                  },
                  "Traffic": "10Gb",
                  "Request": 10
                },
                "Interval": 10
              },
              "Type": "http_custom",
              "AppPackage": {
                "PackageSigns": [
                  {
                    "Sign": "sign",
                    "Name": "name"
                  }
                ]
              },
              "ManagedGroupId": 30000001,
              "Timer": {
                "Scopes": "permanent",
                "Zone": 8,
                "Periods": [
                  {
                    "Start": "2025-01-01T00:00:00Z",
                    "End": "2025-01-01T01:00:00Z"
                  }
                ],
                "WeeklyPeriods": [
                  {
                    "Days": "1",
                    "DailyPeriods": [
                      {
                        "Start": "00:00:00",
                        "End": "01:00:00"
                      }
                    ]
                  }
                ]
              },
              "Expression": "ip.src eq 10.0.0.1",
              "SecurityLevel": {
                "Value": "low"
              },
              "Value": "10.0.0.1",
              "Id": 20000001,
              "Notes": "example notes"
            }
          ]
        }
      ]
    }
  ]
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidParameter	The specified parameter is invalid.
400	InternalException	Failed to call the service. Try again later or contact technical support.

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

変更履歴

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