Azure Front Door pravidel

Azure Front Door pravidla a Azure Front Door pravidel typu Standard/Premium se skládají z pravidel s kombinací podmínek shody a akcí. Tento článek obsahuje podrobný popis akcí typu, které můžete použít v Azure Front Door pravidel nebo v sadě pravidel. Akce definuje chování, které se použije na typ požadavku, který identifikuje podmínka nebo podmínky shody. Pravidlo může obsahovat až pět akcí.

Následující akce můžete použít v Azure Front Door pravidel.

Vypršení platnosti mezipaměti

Akce vypršení platnosti mezipaměti slouží k přepsání hodnoty TTL (Time to Live) koncového bodu pro požadavky, které pravidla odpovídají podmínkám.

Vlastnosti

Příklad

V tomto příkladu přepíšeme vypršení platnosti mezipaměti na 6 hodin pro odpovídající požadavky, které ještě nezadá dobu trvání mezipaměti.

{
  "name": "CacheExpiration",
  "parameters": {
    "cacheBehavior": "SetIfMissing",
    "cacheType": "All",
    "cacheDuration": "0.06:00:00",
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleCacheExpirationActionParameters"
  }
}

{
  name: 'CacheExpiration'
  parameters: {
    cacheBehavior: 'SetIfMissing'
    cacheType: All
    cacheDuration: '0.06:00:00'
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleCacheExpirationActionParameters'
  }
}

Řetězec dotazu klíče mezipaměti

K úpravě klíče mezipaměti na základě řetězců dotazů použijte akci řetězce dotazu klíče mezipaměti. Klíč mezipaměti je způsob, jakým Front Door identifikuje jedinečné požadavky na ukládání do mezipaměti.

Vlastnosti

Příklad

V tomto příkladu upravíme klíč mezipaměti tak, aby zahrnoval parametr řetězce dotazu s názvem customerId .

{
  "name": "CacheKeyQueryString",
  "parameters": {
    "queryStringBehavior": "Include",
    "queryParameters": "customerId",
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleCacheKeyQueryStringBehaviorActionParameters"
  }
}

{
  name: 'CacheKeyQueryString'
  parameters: {
    queryStringBehavior: 'Include'
    queryParameters: 'customerId'
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleCacheKeyQueryStringBehaviorActionParameters'
  }
}

Ú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 původního zdroje.

Vlastnosti

Příklad

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

{
  "name": "ModifyRequestHeader",
  "parameters": {
    "headerAction": "Append",
    "headerName": "MyRequestHeader",
    "value": "AdditionalValue",
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters"
  }
}

{
  name: 'ModifyRequestHeader'
  parameters: {
    headerAction: 'Append'
    headerName: 'MyRequestHeader'
    value: 'AdditionalValue'
    '@odata.type': '#Microsoft.Azure.Cdn.Models.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řed jejich vrácením vašim klientům.

Vlastnosti

Příklad

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

{
  "name": "ModifyResponseHeader",
  "parameters": {
    "headerAction": "Delete",
    "headerName": "X-Powered-By",
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters"
  }
}

{
  name: 'ModifyResponseHeader'
  parameters: {
    headerAction: 'Delete'
    headerName: 'X-Powered-By'
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleHeaderActionParameters'
  }
}

Přesměrování adresy URL

Použijte akci přesměrování adresy URL pro přesměrování klientů na novou adresu URL. Klientům se pošle odezva na přesměrování z předních dveří.

Vlastnosti

Příklad

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

{
  "name": "UrlRedirect",
  "parameters": {
    "redirectType": "TemporaryRedirect",
    "destinationProtocol": "Https",
    "customHostname": "contoso.com",
    "customPath": "/exampleredirection",
    "customQueryString": "clientIp={client_ip}",
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlRedirectActionParameters"
  }
}

{
  name: 'UrlRedirect'
  parameters: {
    redirectType: 'TemporaryRedirect'
    destinationProtocol: 'Https'
    customHostname: 'contoso.com'
    customPath: '/exampleredirection'
    customQueryString: 'clientIp={client_ip}'
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlRedirectActionParameters'
  }
}

Přepsání adresy URL

Pomocí akce přepisu adresy URL přepište cestu k žádosti, která je v cestě k původnímu zdroji.

Vlastnosti

Příklad

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

{
  "name": "UrlRewrite",
  "parameters": {
    "sourcePattern": "/",
    "destination": "/redirection",
    "preserveUnmatchedPath": false,
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlRewriteActionParameters"
  }
}

{
  name: 'UrlRewrite'
  parameters: {
    sourcePattern: '/'
    destination: '/redirection'
    preserveUnmatchedPath: false
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlRewriteActionParameters'
  }
}

Přepsání původní skupiny

Pomocí akce přepsání původní skupiny změňte skupinu původních požadavků, na kterou má být požadavek směrován.

Vlastnosti

Příklad

V tomto příkladu budeme směrovat všechny vyhovující požadavky na skupinu původu s názvem SecondOriginGroup , bez ohledu na konfiguraci v trase koncového bodu front-dveří.

{
  "name": "OriginGroupOverride",
  "parameters": {
    "originGroup": {
      "id": "/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Cdn/profiles/<profile-name>/originGroups/SecondOriginGroup"
    },
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleOriginGroupOverrideActionParameters"
  }
}

{
  name: 'OriginGroupOverride'
  parameters: {
    originGroup: {
      id: '/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Cdn/profiles/<profile-name>/originGroups/SecondOriginGroup'
    }
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleOriginGroupOverrideActionParameters'
  }
}

Serverové proměnné

Proměnné serveru sady pravidel poskytují přístup k strukturovaným informacím o žádosti. Proměnné serveru můžete použít k dynamické změně hlaviček žádosti nebo odpovědi nebo cest pro přepis adres URL nebo řetězců dotazů, například při načtení nové stránky nebo při publikování formuláře.

Podporované proměnné

Formát proměnné serveru

Proměnné serveru je možné zadat pomocí následujících formátů:

• {variable}: Zahrnte celou proměnnou serveru. Pokud je například IP adresa klienta 111.222.333.444 , {client_ip} token se vyhodnotí jako 111.222.333.444 .
• {variable:offset}: Za určitý posun zahrnte proměnnou serveru až do konce proměnné. Posun je založený na nule. Pokud je například IP adresa klienta 111.222.333.444 , {client_ip:3} token se vyhodnotí jako .222.333.444 .
• {variable:offset:length}: Za konkrétní posun zahrnte proměnnou serveru až do zadané délky. Posun je založený na nule. Pokud je například IP adresa klienta 111.222.333.444 , {client_ip:4:3} token se vyhodnotí jako 222 .

Podporované akce

Proměnné serveru jsou podporovány u následujících akcí:

• Řetězec dotazu klíče mezipaměti
• Úprava hlavičky požadavku
• Úprava hlavičky odpovědi
• Přesměrování adresy URL
• Přepsání adresy URL

Další kroky

• Další informace o Azure Front Door standardu nebo Premium pravidel.
• Přečtěte si další informace Azure Front Door stroj pravidel.
• Přečtěte si další informace o podmínkách shody sady pravidel.