Akcje zestawu reguł

Zestaw reguł dla Azure Front Door składa się z reguł zawierających kombinację warunków dopasowania i akcji. Ten artykuł zawiera szczegółowy opis akcji, których można używać w zestawie reguł. Akcja definiuje zachowanie, które jest stosowane do typu żądania, gdzie spełniane są określone warunki dopasowania. W zestawie reguł reguła może mieć maksymalnie pięć działań. Front Door również obsługuje zmienną serwera w akcji zestawu reguł.

Następujące akcje są dostępne do użycia w zestawie reguł:

Nadpisanie konfiguracji trasy

Akcja nadpisania konfiguracji trasy służy do zastąpienia grupy źródłowej lub konfiguracji buforowania dla żądania. Możesz zastąpić lub wyróżnić konfiguracje grup pochodzenia określone w trasie. Jednak po zastąpieniu konfiguracji trasy należy skonfigurować buforowanie. W przeciwnym razie buforowanie zostaje wyłączone dla żądania.

Możesz również zastąpić sposób buforowania plików dla określonych żądań, w tym:

• Zastąpi zachowanie buforowania określone przez źródło.
• Sposób użycia parametrów ciągu zapytania do wygenerowania klucza pamięci podręcznej żądania.
• Wartość czasu wygaśnięcia (TTL) do kontrolowania, jak długo zawartość jest przechowywana w pamięci podręcznej.

Właściwości

Po ustawieniu opcji Zastąp grupę pochodzenia na Tak, ustaw następujące właściwości:

Gdy buforowanie jest ustawione na Włączone, ustaw następujące właściwości.

Przykłady

W tym przykładzie kierujemy wszystkie dopasowane żądania do grupy pochodzenia o nazwie MyOriginGroup, niezależnie od konfiguracji na trasie punktu końcowego usługi Front Door.

{
  "name": "RouteConfigurationOverride",
  "parameters": {
    "originGroupOverride": {
      "originGroup": {
        "id": "/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Cdn/profiles/<profile-name>/originGroups/MyOriginGroup"
      },
      "forwardingProtocol": "MatchRequest"
    },
    "cacheConfiguration": null,
    "typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
  }
}

{
  name: 'RouteConfigurationOverride'
  parameters: {
    originGroupOverride: {
      originGroup: {
        id: '/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Cdn/profiles/<profile-name>/originGroups/MyOriginGroup'
      }
      forwardingProtocol: 'MatchRequest'
    }
    cacheConfiguration: null
    typeName: 'DeliveryRuleRouteConfigurationOverrideActionParameters'
  }
}

W tym przykładzie ustawiliśmy klucz pamięci podręcznej tak, aby zawierał parametr ciągu zapytania o nazwie customerId. Kompresja jest włączona, a zasady buforowania źródła są przestrzegane.

{
  "name": "RouteConfigurationOverride",
  "parameters": {
    "cacheConfiguration": {
      "queryStringCachingBehavior": "IncludeSpecifiedQueryStrings",
      "queryParameters": "customerId",
      "isCompressionEnabled": "Enabled",
      "cacheBehavior": "HonorOrigin",
      "cacheDuration": null
    },
    "originGroupOverride": null,
    "typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
  }
}

{
  name: 'RouteConfigurationOverride'
  parameters: {
    cacheConfiguration: {
      queryStringCachingBehavior: 'IncludeSpecifiedQueryStrings'
      queryParameters: 'customerId'
      isCompressionEnabled: 'Enabled'
      cacheBehavior: 'HonorOrigin'
      cacheDuration: null
    }
    originGroupOverride: null
    typeName: 'DeliveryRuleRouteConfigurationOverrideActionParameters'
  }
}

W tym przykładzie zastąpimy wygaśnięcie pamięci podręcznej do 6 godzin dla dopasowanych żądań, które nie określają już czasu trwania pamięci podręcznej. Usługa Front Door ignoruje ciąg zapytania, gdy określa klucz pamięci podręcznej, a kompresja jest włączona.

{
  "name": "RouteConfigurationOverride",
  "parameters": {
    "cacheConfiguration": {
      "queryStringCachingBehavior": "IgnoreQueryString",
      "cacheBehavior": "OverrideIfOriginMissing",
      "cacheDuration": "0.06:00:00",
    },
    "originGroupOverride": null,
    "typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
  }
}

{
  name: 'RouteConfigurationOverride'
  parameters: {
    cacheConfiguration: {
      queryStringCachingBehavior: 'IgnoreQueryString'
      cacheBehavior: 'OverrideIfOriginMissing'
      cacheDuration: '0.06:00:00'
    }
    originGroupOverride: null
    typeName: 'DeliveryRuleRouteConfigurationOverrideActionParameters'
  }
}

Modyfikowanie nagłówka żądania

Użyj akcji modyfikowania nagłówka żądania, aby zmodyfikować nagłówki w żądaniu, gdy jest wysyłane do źródła.

Właściwości

Przykład

W tym przykładzie dołączamy wartość AdditionalValue do nagłówka MyRequestHeader żądania. Jeśli źródło ustawi nagłówek odpowiedzi na wartość ValueSetByClient, po zastosowaniu tej akcji nagłówek żądania będzie miał wartość ValueSetByClientAdditionalValue.

{
  "name": "ModifyRequestHeader",
  "parameters": {
    "headerAction": "Append",
    "headerName": "MyRequestHeader",
    "value": "AdditionalValue",
    "typeName": "DeliveryRuleHeaderActionParameters"
  }
}

{
  name: 'ModifyRequestHeader'
  parameters: {
    headerAction: 'Append'
    headerName: 'MyRequestHeader'
    value: 'AdditionalValue'
    typeName: 'DeliveryRuleHeaderActionParameters'
  }
}

Modyfikowanie nagłówka odpowiedzi

Użyj akcji modyfikowania nagłówka odpowiedzi, aby zmodyfikować nagłówki, które znajdują się w odpowiedziach przed ich zwróceniem do klientów.

Właściwości

Przykład

W tym przykładzie usuniemy nagłówek o nazwie X-Powered-By z odpowiedzi, zanim zostaną zwrócone do klienta.

{
  "name": "ModifyResponseHeader",
  "parameters": {
    "headerAction": "Delete",
    "headerName": "X-Powered-By",
    "typeName": "DeliveryRuleHeaderActionParameters"
  }
}

{
  name: 'ModifyResponseHeader'
  parameters: {
    headerAction: 'Delete'
    headerName: 'X-Powered-By'
    typeName: 'DeliveryRuleHeaderActionParameters'
  }
}

Przekierowywanie adresów URL

Użyj akcji przekierowania adresu URL, aby przekierować klientów do nowego adresu URL. Klienci otrzymują odpowiedź przekierowania z usługi Front Door. Usługa Azure Front Door obsługuje dynamiczne przechwytywanie ścieżki adresu URL ze zmienną {url_path:seg#} serwera i konwertuje ścieżkę adresu URL na małe lub wielkie litery za pomocą {url_path.tolower} lub {url_path.toupper}. Aby uzyskać więcej informacji, zobacz Zmienne serwera.

Właściwości

Przykład

W tym przykładzie przekierowujemy żądanie do https://contoso.com/exampleredirection?clientIp={client_ip}, zachowując fragment. Używane jest tymczasowe przekierowanie HTTP (307). Adres IP klienta jest używany zamiast tokenu {client_ip} w adresie URL przy użyciu zmiennej client_ipserwera.

{
  "name": "UrlRedirect",
  "parameters": {
    "redirectType": "TemporaryRedirect",
    "destinationProtocol": "Https",
    "customHostname": "contoso.com",
    "customPath": "/exampleredirection",
    "customQueryString": "clientIp={client_ip}",
    "typeName": "DeliveryRuleUrlRedirectActionParameters"
  }
}

{
  name: 'UrlRedirect'
  parameters: {
    redirectType: 'TemporaryRedirect'
    destinationProtocol: 'Https'
    customHostname: 'contoso.com'
    customPath: '/exampleredirection'
    customQueryString: 'clientIp={client_ip}'
    typeName: 'DeliveryRuleUrlRedirectActionParameters'
  }
}

Przepisanie adresów URL

Użyj akcji ponownego zapisywania adresu URL, aby przepisać ścieżkę żądania, które jest kierowane do źródła. Usługa Azure Front Door obsługuje dynamiczne przechwytywanie ścieżki adresu URL ze zmienną {url_path:seg#} serwera i konwertuje ścieżkę adresu URL na małe lub wielkie litery za pomocą {url_path.tolower} lub {url_path.toupper}. Aby uzyskać więcej informacji, zobacz Zmienne serwera.

Właściwości

Przykład

W tym przykładzie ponownie zapisujemy wszystkie żądania do ścieżki /redirectioni nie zachowujemy pozostałej części ścieżki.

{
  "name": "UrlRewrite",
  "parameters": {
    "sourcePattern": "/",
    "destination": "/redirection",
    "preserveUnmatchedPath": false,
    "typeName": "DeliveryRuleUrlRewriteActionParameters"
  }
}

{
  name: 'UrlRewrite'
  parameters: {
    sourcePattern: '/'
    destination: '/redirection'
    preserveUnmatchedPath: false
    typeName: 'DeliveryRuleUrlRewriteActionParameters'
  }
}

W usłudze Azure Front Door (wersja klasyczna) aparat reguł może składać się z maksymalnie 25 reguł zawierających zgodne warunki i skojarzone akcje. Ten artykuł zawiera szczegółowy opis każdej akcji, którą można zdefiniować w regule.

Akcja definiuje zachowanie, które jest stosowane do typu żądania zgodnego z warunkiem lub zestawem warunków dopasowania. W konfiguracji aparatu reguł reguł reguł może mieć maksymalnie 10 pasujących warunków i 5 akcji. W jednej regule można mieć tylko jedną akcję Przesłoń konfigurację routingu .

Poniższe akcje są dostępne do użycia w konfiguracji aparatu reguł.

Modyfikowanie nagłówka żądania

Użyj tych akcji, aby zmodyfikować nagłówki, które znajdują się w żądaniach wysyłanych do backendu.

Pola wymagane

Modyfikowanie nagłówka odpowiedzi

Użyj tych akcji, aby zmodyfikować nagłówki, które znajdują się w odpowiedziach zwróconych do klientów.

Pola wymagane

Nadpisania konfiguracji trasowania

Typ trasy: przekierowanie

Użyj tych akcji, aby przekierować klientów do nowego adresu URL.

Pola wymagane

Typ trasy: Prześlij dalej

Użyj tych akcji, aby przekazać klientom dalej do nowego adresu URL. Te akcje zawierają również akcje podrzędne dla ponownego zapisywania adresów URL i buforowania.

Przepisanie adresów URL

Użyj tego ustawienia, aby skonfigurować opcjonalną niestandardową ścieżkę przekierowywania, której użyjesz podczas konstruowania żądania do przekierowania na serwer.

Buforowanie

Użyj tych ustawień, aby kontrolować sposób buforowania plików dla żądań zawierających ciągi zapytania. Czy buforować zawartość na podstawie wszystkich parametrów, czy też na podstawie wybranych parametrów. Możesz użyć tych ustawień, aby nadpisać wartość czasu życia (TTL) i kontrolować, jak długo zawartość pozostanie w pamięci podręcznej. Aby wymusić buforowanie jako akcję, ustaw pole buforowania na wartość "Włączone". Wymusisz buforowanie, pojawią się następujące opcje: