Azure Front Door acties voor regels

Azure Front Door en Azure Front Door Standard/Premium Rule Set bestaan uit regels met een combinatie van voorwaarden en acties voor overeenkomst. Dit artikel bevat een gedetailleerde beschrijving van het type acties dat u kunt gebruiken in Azure Front Door engine of regelset. De actie definieert het gedrag dat wordt toegepast op een aanvraagtype dat door een overeenkomstvoorwaarde(n) wordt geïdentificeerd. Een regel kan maximaal vijf acties bevatten.

De volgende acties zijn beschikbaar voor gebruik in Azure Front Door regelset.

Verloop van cache

Gebruik de verloopactie van de cache om de TTL-waarde (Time to Live) van het eindpunt te overschrijven voor aanvragen die voldoen aan de voorwaarden van de regels.

Eigenschappen

Voorbeeld

In dit voorbeeld overschrijven we de verlooptijd van de cache op 6 uur voor overeenkomende aanvragen die nog geen cacheduur opgeven.

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

Queryreeks voor cachesleutel

Gebruik de queryreeksactie cachesleutel om de cachesleutel te wijzigen op basis van queryreeksen. De cachesleutel is de manier waarop Front Door unieke aanvragen voor de cache identificeert.

Eigenschappen

Voorbeeld

In dit voorbeeld wijzigen we de cachesleutel om een queryreeksparameter met de naam op te customerId nemen.

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

Aanvraagheader wijzigen

Gebruik de actie aanvraagheader wijzigen om de headers in de aanvraag te wijzigen wanneer deze naar uw oorsprong worden verzonden.

Eigenschappen

Voorbeeld

In dit voorbeeld wordt de waarde aan de AdditionalValue aanvraagheader MyRequestHeader toevoegen. Als de oorsprong de antwoordheader in stelt op een waarde van , heeft de aanvraagheader na het toepassen van deze actie ValueSetByClient de waarde 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'
  }
}

Antwoordheader wijzigen

Gebruik de actie antwoordheader wijzigen om headers te wijzigen die aanwezig zijn in antwoorden voordat ze worden geretourneerd naar uw clients.

Eigenschappen

Voorbeeld

In dit voorbeeld verwijderen we de header met de naam uit de antwoorden X-Powered-By voordat ze worden geretourneerd naar de client.

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

URL-omleiding

Gebruik de URL-omleidingsactie om clients om te leiden naar een nieuwe URL. Clients krijgen een omleidingsreactie van Front Door.

Eigenschappen

Voorbeeld

In dit voorbeeld wordt de aanvraag omgeleid naar https://contoso.com/exampleredirection?clientIp={client_ip} , met behoud van het fragment. Er wordt een tijdelijke HTTP-omleiding (307) gebruikt. Het IP-adres van de client wordt gebruikt in plaats van het {client_ip} token binnen de URL met behulp van de client_ip servervariabele.

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

URL opnieuw genereren

Gebruik de actie voor het herschrijven van url's om het pad te herschrijven van een aanvraag die naar uw oorsprong wordt doorgeleid.

Eigenschappen

Voorbeeld

In dit voorbeeld herschrijven we alle aanvragen naar het pad en behouden we de /redirection rest van het pad niet.

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

Overschrijven oorspronggroep

Gebruik de actie Overschrijven van oorspronggroep om de oorspronggroep te wijzigen waar de aanvraag naar moet worden doorgeleid.

Eigenschappen

Voorbeeld

In dit voorbeeld sturen we alle overeenkomende aanvragen door naar een oorspronkelijke groep met de naam , ongeacht de configuratie SecondOriginGroup in Front Door eindpuntroute.

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

Servervariabelen

Servervariabelen voor regelset bieden toegang tot gestructureerde informatie over de aanvraag. U kunt servervariabelen gebruiken om de aanvraag-/antwoordheaders dynamisch te wijzigen of paden/queryreeksen voor het herschrijven van URL's, bijvoorbeeld wanneer een nieuwe pagina wordt geladen of wanneer een formulier wordt geplaatst.

Ondersteunde variabelen

Indeling van servervariabelen

Servervariabelen kunnen worden opgegeven met de volgende indelingen:

• {variable}: Neem de volledige servervariabele op. Als het IP-adres van de client bijvoorbeeld 111.222.333.444 is, wordt {client_ip} het token geëvalueerd als 111.222.333.444 .
• {variable:offset}: Neem de servervariabele op na een specifieke offset, tot het einde van de variabele. De offset is op nul gebaseerd. Als het IP-adres van de client bijvoorbeeld 111.222.333.444 is, wordt {client_ip:3} het token geëvalueerd als .222.333.444 .
• {variable:offset:length}: Neem de servervariabele op na een specifieke offset, tot de opgegeven lengte. De offset is op nul gebaseerd. Als het IP-adres van de client bijvoorbeeld 111.222.333.444 is, wordt {client_ip:4:3} het token geëvalueerd als 222 .

Ondersteunde acties

Servervariabelen worden ondersteund voor de volgende acties:

• Queryreeks voor cachesleutel
• Aanvraagheader wijzigen
• Antwoordheader wijzigen
• URL-omleiding
• URL opnieuw genereren

Volgende stappen

• Meer informatie over Azure Front Door Standard/Premium Rule Set.
• Meer informatie over Azure Front Door-engine.
• Meer informatie over overeenkomstvoorwaarden voor regelset.