Policies - Create Or Update

Usługa:: Front Door Service

Wersja interfejsu API:: 2025-10-01

Utwórz lub zaktualizuj zasady o określonej nazwie zestawu reguł w grupie zasobów.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/FrontDoorWebApplicationFirewallPolicies/{policyName}?api-version=2025-10-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
policyName	path	True	string maxLength: 128	Nazwa zasady zapory aplikacji sieci Web.
resourceGroupName	path	True	string minLength: 1 maxLength: 80 pattern: ^[a-zA-Z0-9_\-\.]*[^\.]$	Nazwa grupy zasobów w ramach subskrypcji platformy Azure.
subscriptionId	path	True	string	Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.
api-version	query	True	string	Wersja interfejsu API klienta.

Treść żądania

Nazwa	Typ	Opis
etag	string	Pobiera unikatowy ciąg tylko do odczytu, który zmienia się za każdym razem, gdy zasób zostanie zaktualizowany.
location	string	Lokalizacja zasobu.
properties.customRules	CustomRuleList	Opisuje reguły niestandardowe wewnątrz zasad.
properties.managedRules	ManagedRuleSetList	Opisuje reguły zarządzane wewnątrz zasad.
properties.policySettings	PolicySettings	W tym artykule opisano ustawienia zasady.
sku	Sku	Warstwa cenowa zasad zapory aplikacji internetowej. Wartość domyślna to Classic_AzureFrontDoor, jeśli nie zostanie określona.
tags	object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	WebApplicationFirewallPolicy	OK. Żądanie zakończyło się pomyślnie.
201 Created	WebApplicationFirewallPolicy	Created. Żądanie zostało spełnione i została utworzona nowa polityka ochrony.
202 Accepted	WebApplicationFirewallPolicy	Akceptowane. Żądanie zostało zaakceptowane do przetworzenia, a operacja zostanie zakończona asynchronicznie.
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	Podszywać się pod Twoje konto użytkownika

Przykłady

Creates specific policy

Przykładowe żądanie

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/FrontDoorWebApplicationFirewallPolicies/Policy1?api-version=2025-10-01

{
  "location": "WestUs",
  "properties": {
    "policySettings": {
      "enabledState": "Enabled",
      "mode": "Prevention",
      "redirectUrl": "http://www.bing.com",
      "customBlockResponseStatusCode": 429,
      "customBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg==",
      "requestBodyCheck": "Disabled",
      "javascriptChallengeExpirationInMinutes": 30,
      "captchaExpirationInMinutes": 30,
      "logScrubbing": {
        "state": "Enabled",
        "scrubbingRules": [
          {
            "matchVariable": "RequestIPAddress",
            "selectorMatchOperator": "EqualsAny",
            "selector": null,
            "state": "Enabled"
          }
        ]
      }
    },
    "customRules": {
      "rules": [
        {
          "name": "Rule1",
          "priority": 1,
          "ruleType": "RateLimitRule",
          "rateLimitThreshold": 1000,
          "matchConditions": [
            {
              "matchVariable": "RemoteAddr",
              "operator": "IPMatch",
              "matchValue": [
                "192.168.1.0/24",
                "10.0.0.0/24"
              ]
            }
          ],
          "action": "Block"
        },
        {
          "name": "Rule2",
          "priority": 2,
          "ruleType": "MatchRule",
          "matchConditions": [
            {
              "matchVariable": "RemoteAddr",
              "operator": "GeoMatch",
              "matchValue": [
                "CH"
              ]
            },
            {
              "matchVariable": "RequestHeader",
              "operator": "Contains",
              "selector": "UserAgent",
              "matchValue": [
                "windows"
              ],
              "transforms": [
                "Lowercase"
              ]
            }
          ],
          "action": "Block"
        },
        {
          "name": "Rule3",
          "priority": 1,
          "ruleType": "RateLimitRule",
          "rateLimitThreshold": 1000,
          "matchConditions": [
            {
              "matchVariable": "RemoteAddr",
              "operator": "ServiceTagMatch",
              "matchValue": [
                "AzureBackup",
                "AzureBotService"
              ]
            }
          ],
          "action": "CAPTCHA"
        }
      ]
    },
    "managedRules": {
      "managedRuleSets": [
        {
          "ruleSetType": "DefaultRuleSet",
          "ruleSetVersion": "1.0",
          "ruleSetAction": "Block",
          "exclusions": [
            {
              "matchVariable": "RequestHeaderNames",
              "selectorMatchOperator": "Equals",
              "selector": "User-Agent"
            }
          ],
          "ruleGroupOverrides": [
            {
              "ruleGroupName": "SQLI",
              "exclusions": [
                {
                  "matchVariable": "RequestCookieNames",
                  "selectorMatchOperator": "StartsWith",
                  "selector": "token"
                }
              ],
              "rules": [
                {
                  "ruleId": "942100",
                  "enabledState": "Enabled",
                  "action": "Redirect",
                  "exclusions": [
                    {
                      "matchVariable": "QueryStringArgNames",
                      "selectorMatchOperator": "Equals",
                      "selector": "query"
                    }
                  ]
                },
                {
                  "ruleId": "942110",
                  "enabledState": "Disabled"
                }
              ]
            }
          ]
        },
        {
          "ruleSetType": "Microsoft_HTTPDDoSRuleSet",
          "ruleSetVersion": "1.0",
          "ruleGroupOverrides": [
            {
              "ruleGroupName": "ExcessiveRequests",
              "rules": [
                {
                  "ruleId": "500100",
                  "enabledState": "Enabled",
                  "action": "Block",
                  "sensitivity": "High"
                }
              ]
            }
          ]
        }
      ]
    }
  },
  "sku": {
    "name": "Premium_AzureFrontDoor"
  }
}

Przykładowa odpowiedź

Kod stanu:: 200

{
  "name": "Policy1",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/FrontDoorWebApplicationFirewallPolicies/Policy1",
  "type": "Microsoft.Network/frontdoorwebapplicationfirewallpolicies",
  "tags": {
    "key1": "value1",
    "key2": "value2"
  },
  "location": "WestUs",
  "properties": {
    "resourceState": "Enabled",
    "provisioningState": "Succeeded",
    "policySettings": {
      "enabledState": "Enabled",
      "mode": "Prevention",
      "redirectUrl": "http://www.bing.com",
      "customBlockResponseStatusCode": 429,
      "customBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg==",
      "requestBodyCheck": "Disabled",
      "javascriptChallengeExpirationInMinutes": 30,
      "logScrubbing": {
        "state": "Enabled",
        "scrubbingRules": [
          {
            "matchVariable": "RequestIPAddress",
            "selectorMatchOperator": "EqualsAny",
            "selector": null,
            "state": "Enabled"
          }
        ]
      }
    },
    "customRules": {
      "rules": [
        {
          "name": "Rule1",
          "priority": 1,
          "enabledState": "Enabled",
          "ruleType": "RateLimitRule",
          "rateLimitDurationInMinutes": 0,
          "rateLimitThreshold": 1000,
          "matchConditions": [
            {
              "matchVariable": "RemoteAddr",
              "selector": null,
              "operator": "IPMatch",
              "negateCondition": false,
              "matchValue": [
                "192.168.1.0/24",
                "10.0.0.0/24"
              ],
              "transforms": []
            }
          ],
          "action": "Block"
        },
        {
          "name": "Rule2",
          "priority": 2,
          "enabledState": "Enabled",
          "ruleType": "MatchRule",
          "rateLimitDurationInMinutes": 0,
          "rateLimitThreshold": 0,
          "matchConditions": [
            {
              "matchVariable": "RemoteAddr",
              "selector": null,
              "operator": "GeoMatch",
              "negateCondition": false,
              "matchValue": [
                "CH"
              ]
            },
            {
              "matchVariable": "RequestHeader",
              "selector": "UserAgent",
              "operator": "Contains",
              "negateCondition": false,
              "matchValue": [
                "windows"
              ],
              "transforms": [
                "Lowercase"
              ]
            }
          ],
          "action": "Block"
        },
        {
          "name": "rule3",
          "enabledState": null,
          "priority": 1,
          "ruleType": "RateLimitRule",
          "rateLimitDurationInMinutes": null,
          "rateLimitThreshold": 1000,
          "matchConditions": [
            {
              "matchVariable": "RemoteAddr",
              "selector": null,
              "operator": "ServiceTagMatch",
              "negateCondition": false,
              "matchValue": [
                "AzureBackup",
                "AzureBotService"
              ],
              "transforms": []
            }
          ],
          "action": "CAPTCHA"
        }
      ]
    },
    "managedRules": {
      "managedRuleSets": [
        {
          "ruleSetType": "DefaultRuleSet",
          "ruleSetVersion": "1.0",
          "ruleSetAction": "Block",
          "exclusions": [
            {
              "matchVariable": "RequestHeaderNames",
              "selectorMatchOperator": "Equals",
              "selector": "User-Agent"
            }
          ],
          "ruleGroupOverrides": [
            {
              "ruleGroupName": "SQLI",
              "exclusions": [
                {
                  "matchVariable": "RequestCookieNames",
                  "selectorMatchOperator": "StartsWith",
                  "selector": "token"
                }
              ],
              "rules": [
                {
                  "ruleId": "942100",
                  "enabledState": "Enabled",
                  "action": "Redirect",
                  "exclusions": [
                    {
                      "matchVariable": "QueryStringArgNames",
                      "selectorMatchOperator": "Equals",
                      "selector": "query"
                    }
                  ]
                },
                {
                  "ruleId": "942110",
                  "enabledState": "Disabled"
                }
              ]
            }
          ]
        },
        {
          "ruleSetType": "Microsoft_HTTPDDoSRuleSet",
          "ruleSetVersion": "1.0",
          "ruleGroupOverrides": [
            {
              "ruleGroupName": "ExcessiveRequests",
              "rules": [
                {
                  "ruleId": "500100",
                  "enabledState": "Enabled",
                  "action": "Block",
                  "sensitivity": "High"
                }
              ]
            }
          ]
        }
      ]
    },
    "frontendEndpointLinks": [],
    "securityPolicyLinks": []
  },
  "sku": {
    "name": "Premium_AzureFrontDoor"
  }
}

Kod stanu:: 201

{
  "name": "Policy1",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/FrontDoorWebApplicationFirewallPolicies/Policy1",
  "type": "Microsoft.Network/frontdoorwebapplicationfirewallpolicies",
  "tags": {
    "key1": "value1",
    "key2": "value2"
  },
  "location": "WestUs",
  "properties": {
    "resourceState": "Enabled",
    "provisioningState": "Succeeded",
    "policySettings": {
      "enabledState": "Enabled",
      "mode": "Prevention",
      "redirectUrl": "http://www.bing.com",
      "customBlockResponseStatusCode": 429,
      "customBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg==",
      "requestBodyCheck": "Disabled",
      "logScrubbing": {
        "state": "Enabled",
        "scrubbingRules": [
          {
            "matchVariable": "RequestIPAddress",
            "selectorMatchOperator": "EqualsAny",
            "selector": null,
            "state": "Enabled"
          }
        ]
      }
    },
    "customRules": {
      "rules": [
        {
          "name": "Rule1",
          "priority": 1,
          "enabledState": "Enabled",
          "ruleType": "RateLimitRule",
          "rateLimitDurationInMinutes": 0,
          "rateLimitThreshold": 1000,
          "matchConditions": [
            {
              "matchVariable": "RemoteAddr",
              "selector": null,
              "operator": "IPMatch",
              "negateCondition": false,
              "matchValue": [
                "192.168.1.0/24",
                "10.0.0.0/24"
              ],
              "transforms": []
            }
          ],
          "action": "Block"
        },
        {
          "name": "Rule2",
          "priority": 2,
          "enabledState": "Enabled",
          "ruleType": "MatchRule",
          "rateLimitDurationInMinutes": 0,
          "rateLimitThreshold": 0,
          "matchConditions": [
            {
              "matchVariable": "RemoteAddr",
              "selector": null,
              "operator": "GeoMatch",
              "negateCondition": false,
              "matchValue": [
                "CH"
              ]
            },
            {
              "matchVariable": "RequestHeader",
              "selector": "UserAgent",
              "operator": "Contains",
              "negateCondition": false,
              "matchValue": [
                "windows"
              ],
              "transforms": [
                "Lowercase"
              ]
            }
          ],
          "action": "Block"
        }
      ]
    },
    "managedRules": {
      "managedRuleSets": [
        {
          "ruleSetType": "DefaultRuleSet",
          "ruleSetVersion": "1.0",
          "exclusions": [
            {
              "matchVariable": "RequestHeaderNames",
              "selectorMatchOperator": "Equals",
              "selector": "User-Agent"
            }
          ],
          "ruleGroupOverrides": [
            {
              "ruleGroupName": "SQLI",
              "exclusions": [
                {
                  "matchVariable": "RequestCookieNames",
                  "selectorMatchOperator": "StartsWith",
                  "selector": "token"
                }
              ],
              "rules": [
                {
                  "ruleId": "942100",
                  "enabledState": "Enabled",
                  "action": "Redirect",
                  "exclusions": [
                    {
                      "matchVariable": "QueryStringArgNames",
                      "selectorMatchOperator": "Equals",
                      "selector": "query"
                    }
                  ]
                },
                {
                  "ruleId": "942110",
                  "enabledState": "Disabled"
                }
              ]
            }
          ]
        }
      ]
    },
    "frontendEndpointLinks": [],
    "securityPolicyLinks": []
  },
  "sku": {
    "name": "Classic_AzureFrontDoor"
  }
}

Kod stanu:: 202

{
  "name": "Policy1",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/FrontDoorWebApplicationFirewallPolicies/Policy1",
  "type": "Microsoft.Network/frontdoorwebapplicationfirewallpolicies",
  "tags": {
    "key1": "value1",
    "key2": "value2"
  },
  "location": "WestUs",
  "properties": {
    "resourceState": "Enabled",
    "provisioningState": "Succeeded",
    "policySettings": {
      "enabledState": "Enabled",
      "mode": "Prevention",
      "redirectUrl": "http://www.bing.com",
      "customBlockResponseStatusCode": 429,
      "customBlockResponseBody": "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg==",
      "requestBodyCheck": "Disabled",
      "logScrubbing": {
        "state": "Enabled",
        "scrubbingRules": [
          {
            "matchVariable": "RequestIPAddress",
            "selectorMatchOperator": "EqualsAny",
            "selector": null,
            "state": "Enabled"
          }
        ]
      }
    },
    "customRules": {
      "rules": [
        {
          "name": "Rule1",
          "priority": 1,
          "enabledState": "Enabled",
          "ruleType": "RateLimitRule",
          "rateLimitDurationInMinutes": 0,
          "rateLimitThreshold": 1000,
          "matchConditions": [
            {
              "matchVariable": "RemoteAddr",
              "selector": null,
              "operator": "IPMatch",
              "negateCondition": false,
              "matchValue": [
                "192.168.1.0/24",
                "10.0.0.0/24"
              ],
              "transforms": []
            }
          ],
          "action": "Block"
        },
        {
          "name": "Rule2",
          "priority": 2,
          "enabledState": "Enabled",
          "ruleType": "MatchRule",
          "rateLimitDurationInMinutes": 0,
          "rateLimitThreshold": 0,
          "matchConditions": [
            {
              "matchVariable": "RemoteAddr",
              "selector": null,
              "operator": "GeoMatch",
              "negateCondition": false,
              "matchValue": [
                "CH"
              ]
            },
            {
              "matchVariable": "RequestHeader",
              "selector": "UserAgent",
              "operator": "Contains",
              "negateCondition": false,
              "matchValue": [
                "windows"
              ],
              "transforms": [
                "Lowercase"
              ]
            }
          ],
          "action": "Block"
        }
      ]
    },
    "managedRules": {
      "managedRuleSets": [
        {
          "ruleSetType": "DefaultRuleSet",
          "ruleSetVersion": "1.0",
          "ruleSetAction": "Block",
          "exclusions": [
            {
              "matchVariable": "RequestHeaderNames",
              "selectorMatchOperator": "Equals",
              "selector": "User-Agent"
            }
          ],
          "ruleGroupOverrides": [
            {
              "ruleGroupName": "SQLI",
              "exclusions": [
                {
                  "matchVariable": "RequestCookieNames",
                  "selectorMatchOperator": "StartsWith",
                  "selector": "token"
                }
              ],
              "rules": [
                {
                  "ruleId": "942100",
                  "enabledState": "Enabled",
                  "action": "Redirect",
                  "exclusions": [
                    {
                      "matchVariable": "QueryStringArgNames",
                      "selectorMatchOperator": "Equals",
                      "selector": "query"
                    }
                  ]
                },
                {
                  "ruleId": "942110",
                  "enabledState": "Disabled"
                }
              ]
            }
          ]
        },
        {
          "ruleSetType": "Microsoft_HTTPDDoSRuleSet",
          "ruleSetVersion": "1.0",
          "ruleGroupOverrides": [
            {
              "ruleGroupName": "ExcessiveRequests",
              "rules": [
                {
                  "ruleId": "500100",
                  "enabledState": "Enabled",
                  "action": "Block",
                  "sensitivity": "High"
                }
              ]
            }
          ]
        }
      ]
    },
    "frontendEndpointLinks": [],
    "securityPolicyLinks": []
  },
  "sku": {
    "name": "Premium_AzureFrontDoor"
  }
}

Definicje

Nazwa	Opis
scrubbingRuleEntryMatchOperator	Gdy element matchVariable jest kolekcją, należy pracować na selektorze, aby określić, które elementy w kolekcji mają zastosowanie do tej reguły.
scrubbingRuleEntryState	Definiuje stan reguły czyszczenia dziennika. Wartość domyślna jest włączona.
ActionType	Definiuje akcję, która ma zostać wykonana w przypadku dopasowania reguły.
CustomRule	Definiuje zawartość reguły aplikacji internetowej
CustomRuleEnabledState	Opisuje, czy reguła niestandardowa jest w stanie włączonym lub wyłączonym. Wartość domyślna to Włączone, jeśli nie zostanie określona.
CustomRuleList	Definiuje zawartość reguł niestandardowych
ErrorResponse	Odpowiedź o błędzie wskazuje, że usługa Front Door nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.
FrontendEndpointLink	Definiuje identyfikator zasobu dla punktu końcowego frontonu.
GroupByVariable	Opisuje zmienne dostępne do grupowania żądań limitu szybkości
ManagedRuleEnabledState	Opisuje, czy reguła zarządzana jest w stanie włączonym lub wyłączonym.
ManagedRuleExclusion	Wyklucz zmienne z oceny reguły zarządzanej.
ManagedRuleExclusionMatchVariable	Typ zmiennej, która ma zostać wykluczona.
ManagedRuleExclusionSelectorMatchOperator	Operator porównania, który ma być stosowany do selektora podczas określania, do których elementów w kolekcji ma zastosowanie to wykluczenie.
ManagedRuleGroupOverride	Definiuje ustawienie zastąpienia zarządzanej grupy reguł.
ManagedRuleOverride	Definiuje ustawienie zastąpienia zarządzanej grupy reguł.
ManagedRuleSet	Definiuje zarządzany zestaw reguł.
ManagedRuleSetActionType	Definiuje akcję, która ma być wykonywana po osiągnięciu progu oceny zestawu reguł zarządzanych.
ManagedRuleSetList	Definiuje listę zarządzanych zestawów reguł dla zasady.
MatchCondition	Zdefiniuj warunek dopasowania.
MatchVariable	Zmienna żądania do porównania.
Operator	Typ porównania, który ma być używany do dopasowywania do wartości zmiennej.
PolicyEnabledState	Opisuje, czy zasady są w stanie włączonym, czy wyłączonym. Wartość domyślna to Włączone, jeśli nie zostanie określona.
PolicyMode	Opisuje, czy jest w trybie wykrywania lub w trybie zapobiegania na poziomie zasad.
PolicyRequestBodyCheck	Opisuje, czy reguły zarządzane przez zasady będą sprawdzać zawartość treści żądania.
PolicyResourceState	Stan zasobu zasady.
PolicySettings	Definiuje ustawienia konfiguracji WebApplicationFirewallPolicy najwyższego poziomu.
RoutingRuleLink	Definiuje identyfikator zasobu dla reguły rozsyłania.
RuleType	Opisuje typ reguły.
scrubbingRuleEntryMatchVariable	Zmienna do oczyszczenia z dzienników.
SecurityPolicyLink	Definiuje identyfikator zasobu dla zasady zabezpieczeń.
SensitivityType	Definiuje czułość reguły.
Sku	Warstwa cenowa zasad zapory aplikacji internetowej.
SkuName	Nazwa warstwy cenowej.
TransformType	Opisuje, jakie przekształcenia zostały zastosowane przed dopasowaniem.
VariableName	Opisuje obsługiwaną zmienną dla grupy według
WebApplicationFirewallPolicy	Definiuje zasady zapory aplikacji internetowej.
WebApplicationFirewallScrubbingRules	Definiuje zawartość reguł czyszczenia dziennika.
WebApplicationFirewallScrubbingState	Stan konfiguracji czyszczenia dziennika. Wartość domyślna to Włączone.

scrubbingRuleEntryMatchOperator

Wyliczanie

Gdy element matchVariable jest kolekcją, należy pracować na selektorze, aby określić, które elementy w kolekcji mają zastosowanie do tej reguły.

Wartość	Opis
EqualsAny
Equals

scrubbingRuleEntryState

Wyliczanie

Definiuje stan reguły czyszczenia dziennika. Wartość domyślna jest włączona.

Wartość	Opis
Enabled
Disabled

ActionType

Wyliczanie

Definiuje akcję, która ma zostać wykonana w przypadku dopasowania reguły.

Wartość	Opis
Allow
Block
Log
Redirect
AnomalyScoring
JSChallenge
CAPTCHA

CustomRule

Objekt

Definiuje zawartość reguły aplikacji internetowej

Nazwa	Typ	Opis
action	ActionType	Opisuje, jaka akcja ma zostać zastosowana w przypadku dopasowania reguły.
enabledState	CustomRuleEnabledState	Opisuje, czy reguła niestandardowa jest w stanie włączonym lub wyłączonym. Wartość domyślna to Włączone, jeśli nie zostanie określona.
groupBy	GroupByVariable[]	Opisuje listę zmiennych do grupowania żądań limitu szybkości
matchConditions	MatchCondition[]	Lista warunków dopasowania.
name	string maxLength: 128	Opisuje nazwę reguły.
priority	integer	Opisuje priorytet reguły. Reguły o niższej wartości zostaną ocenione przed regułami o wyższej wartości.
rateLimitDurationInMinutes	integer minimum: 0 maximum: 5	Okno czasowe na zresetowanie liczby limitów szybkości. Domyślnie wynosi 1 minutę.
rateLimitThreshold	integer minimum: 0	Liczba dozwolonych żądań na klienta w przedziale czasu.
ruleType	RuleType	Opisuje typ reguły.

CustomRuleEnabledState

Wyliczanie

Opisuje, czy reguła niestandardowa jest w stanie włączonym lub wyłączonym. Wartość domyślna to Włączone, jeśli nie zostanie określona.

Wartość	Opis
Disabled
Enabled

CustomRuleList

Objekt

Definiuje zawartość reguł niestandardowych

Nazwa	Typ	Opis
rules	CustomRule[]	Lista reguł

ErrorResponse

Objekt

Odpowiedź o błędzie wskazuje, że usługa Front Door nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.

Nazwa	Typ	Opis
code	string	Kod błędu.
message	string	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

FrontendEndpointLink

Objekt

Definiuje identyfikator zasobu dla punktu końcowego frontonu.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.

GroupByVariable

Objekt

Opisuje zmienne dostępne do grupowania żądań limitu szybkości

Nazwa	Typ	Opis
variableName	VariableName	Opisuje obsługiwaną zmienną dla grupy według

ManagedRuleEnabledState

Wyliczanie

Opisuje, czy reguła zarządzana jest w stanie włączonym lub wyłączonym.

Wartość	Opis
Disabled
Enabled

ManagedRuleExclusion

Objekt

Wyklucz zmienne z oceny reguły zarządzanej.

Nazwa	Typ	Opis
matchVariable	ManagedRuleExclusionMatchVariable	Typ zmiennej, która ma zostać wykluczona.
selector	string	Wartość selektora, dla których elementów w kolekcji dotyczy to wykluczenie.
selectorMatchOperator	ManagedRuleExclusionSelectorMatchOperator	Operator porównania, który ma być stosowany do selektora podczas określania, do których elementów w kolekcji ma zastosowanie to wykluczenie.

ManagedRuleExclusionMatchVariable

Wyliczanie

Typ zmiennej, która ma zostać wykluczona.

Wartość	Opis
RequestHeaderNames
RequestCookieNames
QueryStringArgNames
RequestBodyPostArgNames
RequestBodyJsonArgNames

ManagedRuleExclusionSelectorMatchOperator

Wyliczanie

Operator porównania, który ma być stosowany do selektora podczas określania, do których elementów w kolekcji ma zastosowanie to wykluczenie.

Wartość	Opis
Equals
Contains
StartsWith
EndsWith
EqualsAny

ManagedRuleGroupOverride

Objekt

Definiuje ustawienie zastąpienia zarządzanej grupy reguł.

Nazwa	Typ	Opis
exclusions	ManagedRuleExclusion[]	Opisuje wykluczenia, które są stosowane do wszystkich reguł w grupie.
ruleGroupName	string	Opisuje zarządzaną grupę reguł do zastąpienia.
rules	ManagedRuleOverride[]	Lista reguł, które zostaną wyłączone. Jeśli żadna z nich nie zostanie określona, wszystkie reguły w grupie zostaną wyłączone.

ManagedRuleOverride

Objekt

Definiuje ustawienie zastąpienia zarządzanej grupy reguł.

Nazwa	Typ	Opis
action	ActionType	Opisuje akcję przesłonięcia, która ma być stosowana, gdy reguła jest zgodna.
enabledState	ManagedRuleEnabledState	Opisuje, czy reguła zarządzana jest w stanie włączonym lub wyłączonym. Wartości domyślne wyłączone, jeśli nie zostaną określone.
exclusions	ManagedRuleExclusion[]	Opisuje wykluczenia, które są stosowane do tej konkretnej reguły.
ruleId	string	Identyfikator reguły zarządzanej.
sensitivity	SensitivityType	Opisuje ważność przesłonięcia, która ma być stosowana, gdy reguła jest zgodna.

ManagedRuleSet

Objekt

Definiuje zarządzany zestaw reguł.

Nazwa	Typ	Opis
exclusions	ManagedRuleExclusion[]	Opisuje wykluczenia, które są stosowane do wszystkich reguł w zestawie.
ruleGroupOverrides	ManagedRuleGroupOverride[]	Definiuje przesłonięcia grupy reguł, które mają być stosowane do zestawu reguł.
ruleSetAction	ManagedRuleSetActionType	ruleSetAction (Akcja reguły) Definiuje akcję zestawu reguł.
ruleSetType	string	Definiuje typ zestawu reguł do użycia.
ruleSetVersion	string	Definiuje wersję zestawu reguł do użycia.

ManagedRuleSetActionType

Wyliczanie

Definiuje akcję, która ma być wykonywana po osiągnięciu progu oceny zestawu reguł zarządzanych.

Wartość	Opis
Block
Log
Redirect

ManagedRuleSetList

Objekt

Definiuje listę zarządzanych zestawów reguł dla zasady.

Nazwa	Typ	Opis
managedRuleSets	ManagedRuleSet[]	Lista zestawów reguł.

MatchCondition

Objekt

Zdefiniuj warunek dopasowania.

Nazwa	Typ	Opis
matchValue	string[]	Lista możliwych wartości dopasowania.
matchVariable	MatchVariable	Zmienna żądania do porównania.
negateCondition	boolean	Opisuje, czy wynik tego warunku powinien zostać negowany.
operator	Operator	Typ porównania, który ma być używany do dopasowywania do wartości zmiennej.
selector	string	Dopasuj do określonego klucza ze zmiennych QueryString, PostArgs, RequestHeader lub Cookies. Wartość domyślna to null.
transforms	TransformType[]	Lista przekształceń.

MatchVariable

Wyliczanie

Zmienna żądania do porównania.

Wartość	Opis
RemoteAddr
RequestMethod
QueryString
PostArgs
RequestUri
RequestHeader
RequestBody
Cookies
SocketAddr

Operator

Wyliczanie

Typ porównania, który ma być używany do dopasowywania do wartości zmiennej.

Wartość	Opis
Any
IPMatch
GeoMatch
Equal
Contains
LessThan
GreaterThan
LessThanOrEqual
GreaterThanOrEqual
BeginsWith
EndsWith
RegEx
ServiceTagMatch

PolicyEnabledState

Wyliczanie

Opisuje, czy zasady są w stanie włączonym, czy wyłączonym. Wartość domyślna to Włączone, jeśli nie zostanie określona.

Wartość	Opis
Disabled
Enabled

PolicyMode

Wyliczanie

Opisuje, czy jest w trybie wykrywania lub w trybie zapobiegania na poziomie zasad.

Wartość	Opis
Prevention
Detection

PolicyRequestBodyCheck

Wyliczanie

Opisuje, czy reguły zarządzane przez zasady będą sprawdzać zawartość treści żądania.

Wartość	Opis
Disabled
Enabled

PolicyResourceState

Wyliczanie

Stan zasobu zasady.

Wartość	Opis
Creating
Enabling
Enabled
Disabling
Disabled
Deleting

PolicySettings

Objekt

Definiuje ustawienia konfiguracji WebApplicationFirewallPolicy najwyższego poziomu.

Nazwa	Typ	Opis
captchaExpirationInMinutes	integer (int32) minimum: 5 maximum: 1440	Określa okres ważności pliku cookie Captcha w minutach. To ustawienie ma zastosowanie tylko do Premium_AzureFrontDoor. Wartość musi być liczbą całkowitą z zakresu od 5 do 1440, a wartość domyślna to 30.
customBlockResponseBody	string pattern: ^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=\|[A-Za-z0-9+/]{4})$	Jeśli typ akcji jest zablokowany, klient może zastąpić treść odpowiedzi. Treść musi być określona w kodowaniu base64.
customBlockResponseStatusCode	integer	Jeśli typ akcji to Blok, klient może zastąpić kod stanu odpowiedzi.
enabledState	PolicyEnabledState	Opisuje, czy zasady są w stanie włączonym, czy wyłączonym. Wartość domyślna to Włączone, jeśli nie zostanie określona.
javascriptChallengeExpirationInMinutes	integer (int32) minimum: 5 maximum: 1440	Definiuje okres ważności pliku cookie wyzwania JavaScript w minutach. To ustawienie ma zastosowanie tylko do Premium_AzureFrontDoor. Wartość musi być liczbą całkowitą z zakresu od 5 do 1440, a wartość domyślna to 30.
logScrubbing.scrubbingRules	WebApplicationFirewallScrubbingRules[]	Lista reguł czyszczenia dzienników zastosowanych do dzienników zapory aplikacji internetowej.
logScrubbing.state	WebApplicationFirewallScrubbingState	Stan konfiguracji czyszczenia dziennika. Wartość domyślna to Włączone.
mode	PolicyMode	Opisuje, czy jest w trybie wykrywania lub w trybie zapobiegania na poziomie zasad.
redirectUrl	string	Jeśli typem akcji jest przekierowanie, to pole reprezentuje adres URL przekierowania dla klienta.
requestBodyCheck	PolicyRequestBodyCheck	Opisuje, czy reguły zarządzane przez zasady będą sprawdzać zawartość treści żądania.

RoutingRuleLink

Objekt

Definiuje identyfikator zasobu dla reguły rozsyłania.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.

RuleType

Wyliczanie

Opisuje typ reguły.

Wartość	Opis
MatchRule
RateLimitRule

scrubbingRuleEntryMatchVariable

Wyliczanie

Zmienna do oczyszczenia z dzienników.

Wartość	Opis
RequestIPAddress
RequestUri
QueryStringArgNames
RequestHeaderNames
RequestCookieNames
RequestBodyPostArgNames
RequestBodyJsonArgNames

SecurityPolicyLink

Objekt

Definiuje identyfikator zasobu dla zasady zabezpieczeń.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.

SensitivityType

Wyliczanie

Definiuje czułość reguły.

Wartość	Opis
Low	Niska czułość - uruchamia regułę przy większych skokach ruchu
Medium	Średnia czułość — uruchamia regułę przy umiarkowanych wzrostach ruchu
High	Wysoka czułość - uruchamia regułę przy mniejszych skokach ruchu

Sku

Objekt

Warstwa cenowa zasad zapory aplikacji internetowej.

Nazwa	Typ	Opis
name	SkuName	Nazwa warstwy cenowej.

SkuName

Wyliczanie

Nazwa warstwy cenowej.

Wartość	Opis
Classic_AzureFrontDoor
Standard_AzureFrontDoor
Premium_AzureFrontDoor

TransformType

Wyliczanie

Opisuje, jakie przekształcenia zostały zastosowane przed dopasowaniem.

Wartość	Opis
Lowercase
Uppercase
Trim
UrlDecode
UrlEncode
RemoveNulls

VariableName

Wyliczanie

Opisuje obsługiwaną zmienną dla grupy według

Wartość	Opis
SocketAddr
GeoLocation
None

WebApplicationFirewallPolicy

Objekt

Definiuje zasady zapory aplikacji internetowej.

Nazwa	Typ	Opis
etag	string	Pobiera unikatowy ciąg tylko do odczytu, który zmienia się za każdym razem, gdy zasób zostanie zaktualizowany.
id	string	Identyfikator zasobu.
location	string	Lokalizacja zasobu.
name	string	Nazwa zasobu.
properties.customRules	CustomRuleList	Opisuje reguły niestandardowe wewnątrz zasad.
properties.frontendEndpointLinks	FrontendEndpointLink[]	Opisuje punkty końcowe frontonu skojarzone z tymi zasadami Web Application Firewall.
properties.managedRules	ManagedRuleSetList	Opisuje reguły zarządzane wewnątrz zasad.
properties.policySettings	PolicySettings	W tym artykule opisano ustawienia zasady.
properties.provisioningState	string	Stan aprowizacji zasad.
properties.resourceState	PolicyResourceState	Stan zasobu zasady.
properties.routingRuleLinks	RoutingRuleLink[]	W tym artykule opisano reguły routingu skojarzone z tą zasadą Web Application Firewall.
properties.securityPolicyLinks	SecurityPolicyLink[]	Opisuje zasady zabezpieczeń skojarzone z tą zasadą Web Application Firewall.
sku	Sku	Warstwa cenowa zasad zapory aplikacji internetowej. Wartość domyślna to Classic_AzureFrontDoor, jeśli nie zostanie określona.
tags	object	Tagi zasobów.
type	string	Typ zasobu.

WebApplicationFirewallScrubbingRules

Objekt

Definiuje zawartość reguł czyszczenia dziennika.

Nazwa	Typ	Opis
matchVariable	scrubbingRuleEntryMatchVariable	Zmienna do oczyszczenia z dzienników.
selector	string	Gdy element matchVariable jest kolekcją, operator służący do określania elementów w kolekcji, do których ma zastosowanie ta reguła.
selectorMatchOperator	scrubbingRuleEntryMatchOperator	Gdy element matchVariable jest kolekcją, należy pracować na selektorze, aby określić, które elementy w kolekcji mają zastosowanie do tej reguły.
state	scrubbingRuleEntryState	Definiuje stan reguły czyszczenia dziennika. Wartość domyślna jest włączona.

WebApplicationFirewallScrubbingState

Wyliczanie

Stan konfiguracji czyszczenia dziennika. Wartość domyślna to Włączone.

Wartość	Opis
Enabled
Disabled

Udostępnij przez

Policies - Create Or Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

Creates specific policy

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

scrubbingRuleEntryMatchOperator

scrubbingRuleEntryState

ActionType

CustomRule

CustomRuleEnabledState

CustomRuleList

ErrorResponse

FrontendEndpointLink

GroupByVariable

ManagedRuleEnabledState

ManagedRuleExclusion

ManagedRuleExclusionMatchVariable

ManagedRuleExclusionSelectorMatchOperator

ManagedRuleGroupOverride

ManagedRuleOverride

ManagedRuleSet

ManagedRuleSetActionType

ManagedRuleSetList

MatchCondition

MatchVariable

Operator

PolicyEnabledState

PolicyMode

PolicyRequestBodyCheck

PolicyResourceState

PolicySettings

RoutingRuleLink

RuleType

scrubbingRuleEntryMatchVariable

SecurityPolicyLink

SensitivityType

Sku

SkuName

TransformType

VariableName

WebApplicationFirewallPolicy

WebApplicationFirewallScrubbingRules

WebApplicationFirewallScrubbingState