Akce sady pravidel

Sada pravidel služby Azure Front Door se skládá z pravidel s kombinací podmínek shody a akcí. Tento článek obsahuje podrobný popis akcí, které můžete použít v sadě pravidel. Akce definuje chování, které se použije u typu požadavku, který identifikuje podmínka shody. V sadě pravidel může mít pravidlo až pět akcí. Front Door také podporuje proměnnou serveru v akci sady pravidel.

Pro použití v sadě pravidel jsou k dispozici následující akce:

Přepsání konfigurace trasy

Akce přepsání konfigurace trasy se používá k přepsání skupiny původu nebo konfigurace ukládání do mezipaměti pro požadavek. Můžete se rozhodnout přepsat nebo respektovat konfigurace původní skupiny zadané v trase. Při přepsání konfigurace trasy však musíte nakonfigurovat ukládání do mezipaměti. Jinak se ukládání do mezipaměti pro požadavek zakáže.

Můžete také přepsat způsob ukládání souborů do mezipaměti pro konkrétní požadavky, včetně:

• Přepište chování ukládání do mezipaměti určené původem.
• Jak se k vygenerování klíče mezipaměti požadavku používají parametry řetězce dotazu.
• Hodnota TTL (Time to Live) určuje, jak dlouho zůstane obsah v mezipaměti.

Vlastnosti

Pokud je skupina původu přepsána na Ano, nastavte následující vlastnosti:

Pokud je ukládání do mezipaměti nastaveno na Povoleno, nastavte následující vlastnosti:

Příklady

V tomto příkladu směrujeme všechny spárované požadavky na skupinu původu s názvem MyOriginGroupbez ohledu na konfiguraci v trase koncového bodu služby 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'
  }
}

V tomto příkladu nastavíme klíč mezipaměti tak, aby zahrnoval parametr řetězce dotazu s názvem customerId. Komprese je povolená a zásady ukládání do mezipaměti původu jsou dodrženy.

{
  "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'
  }
}

V tomto příkladu přepíšeme vypršení platnosti mezipaměti na 6 hodin u odpovídajících požadavků, které ještě nezadávají dobu trvání mezipaměti. Front Door ignoruje řetězec dotazu, když určuje klíč mezipaměti a je povolená komprese.

{
  "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'
  }
}

Úprava hlavičky požadavku

Pomocí akce upravit hlavičku požadavku můžete upravit hlavičky v požadavku při odeslání do vašeho původu.

Vlastnosti

Příklad

V tomto příkladu MyRequestHeader připojíme hodnotu AdditionalValue k hlavičce požadavku. Pokud zdroj nastavil hlavičku odpovědi na hodnotu ValueSetByClient, pak po použití této akce by hlavička požadavku měla hodnotu ValueSetByClientAdditionalValue.

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

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

Úprava hlavičky odpovědi

Pomocí akce upravit hlavičku odpovědi můžete upravit hlavičky, které jsou přítomné v odpovědích předtím, než se vrátí klientům.

Vlastnosti

Příklad

V tomto příkladu odstraníme hlavičku s názvem X-Powered-By z odpovědí, než se vrátí klientovi.

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

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

Přesměrování adresy URL

Pomocí akce přesměrování adresy URL můžete přesměrovat klienty na novou adresu URL. Klienti se odesílají odpověď přesměrování ze služby Front Door. Azure Front Door podporuje dynamické zachytávání cest URL s {url_path:seg#} proměnnou serveru a převádí cestu URL na malá nebo velká písmena s {url_path.tolower} nebo {url_path.toupper}. Další informace naleznete v tématu Proměnné serveru.

Vlastnosti

Příklad

V tomto příkladu přesměrujeme požadavek na https://contoso.com/exampleredirection?clientIp={client_ip}a přitom zachováme fragment. Používá se dočasné přesměrování HTTP (307). IP adresa klienta se používá místo tokenu {client_ip} v adrese URL pomocí client_ip proměnné serveru.

{
  "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'
  }
}

Přepsání adresy URL

Pomocí akce přepsání adresy URL přepište cestu požadavku, který je na cestě k vašemu původu. Azure Front Door podporuje dynamické zachytávání cest URL s {url_path:seg#} proměnnou serveru a převádí cestu URL na malá nebo velká písmena s {url_path.tolower} nebo {url_path.toupper}. Další informace naleznete v tématu Proměnné serveru.

Vlastnosti

Příklad

V tomto příkladu přepíšeme všechny požadavky na cestu /redirectiona nezachováme zbytek cesty.

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

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

Ve službě Azure Front Door (Classic) může modul pravidel obsahovat až 25 pravidel obsahujících odpovídající podmínky a přidružené akce. Tento článek obsahuje podrobný popis jednotlivých akcí, které můžete definovat v pravidle.

Akce definuje chování použité u typu požadavku, které odpovídá podmínce nebo sadě podmínek shody. V konfiguraci stroje pravidel může mít pravidlo až 10 odpovídajících podmínek a 5 akcí. V jednom pravidlu můžete mít pouze jednu akci konfigurace směrování přepsání.

V konfiguraci stroje pravidel jsou k dispozici následující akce.

Úprava hlavičky požadavku

Pomocí těchto akcí můžete upravit hlavičky, které jsou přítomné v požadavcích odesílaných do vašeho back-endu.

Povinná pole

Úprava hlavičky odpovědi

Pomocí těchto akcí můžete upravit hlavičky, které jsou přítomné v odpovědích vrácených klientům.

Povinná pole

Přepisování konfigurace směrování

Typ trasy: Přesměrování

Pomocí těchto akcí můžete přesměrovat klienty na novou adresu URL.

Povinná pole

Typ trasy: Předat dál

Pomocí těchto akcí přeposílání klientů na novou adresu URL. Tyto akce také obsahují dílčí akce pro přepsání adres URL a ukládání do mezipaměti.

Přepsání adresy URL

Pomocí tohoto nastavení můžete nakonfigurovat volitelnou vlastní cestu předávání, která se má použít při vytváření požadavku pro přeposílání do back-endu.

Ukládání do mezipaměti

Pomocí těchto nastavení můžete řídit, jak se soubory ukládají do mezipaměti pro požadavky obsahující řetězce dotazů. Určuje, jestli chcete obsah ukládat do mezipaměti na základě všech parametrů nebo vybraných parametrů. Pomocí těchto nastavení můžete přepsat hodnotu TTL (Time to Live) a řídit, jak dlouho zůstane obsah v mezipaměti. Pokud chcete vynutit ukládání do mezipaměti jako akci, nastavte pole ukládání do mezipaměti na Povoleno. Při vynucení ukládání do mezipaměti se zobrazí následující možnosti: