Regler matchar villkor

I Azure Front Door-regeluppsättningar består en regel av inga eller vissa matchningsvillkor och en åtgärd. Den här artikeln innehåller detaljerade beskrivningar av matchningsvillkor som du kan använda i Azure Front Door-regeluppsättningar.

Viktigt!

Azure Front Door (klassisk) dras tillbaka den 31 mars 2027. För att undvika avbrott i tjänsten är det viktigt att du migrerar dina Azure Front Door-profiler (klassiska) till Azure Front Door Standard- eller Premium-nivån senast i mars 2027. Mer information finns i Azure Front Door (klassisk) tillbakadragning.

I Azure Front Door-regelmotorer (klassisk) består en regel av inga eller vissa matchningsvillkor och en åtgärd. Den här artikeln innehåller detaljerade beskrivningar av matchningsvillkor som du kan använda i Azure Front Door-regelmotorer (klassiska).

Den första delen av en regel är ett matchningsvillkor eller en uppsättning matchningsvillkor. En regel kan bestå av upp till 10 matchningsvillkor. Ett matchningsvillkor identifierar specifika typer av begäranden som definierade åtgärder utförs för. Om du använder flera matchningsvillkor grupperas matchningsvillkoren tillsammans med hjälp av AND-logik. För alla matchningsvillkor som stöder flera värden används OR-logik.

Du kan använda ett matchningsvillkor för att:

• Filtrera begäranden baserat på en specifik IP-adress, port eller land/region.
• Filtrera begäranden efter rubrikinformation.
• Filtrera begäranden från mobila enheter eller stationära enheter.
• Filtrera begäranden från begärandefilnamn och filnamnstillägg.
• Filtrera begäranden efter värdnamn, SSL-protokoll, begärande-URL, protokoll, sökväg, frågesträng, post args och andra värden.

• Filtrera begäranden baserat på en specifik IP-adress eller land/region.
• Filtrera begäranden efter rubrikinformation.
• Filtrera begäranden från mobila enheter eller stationära enheter.
• Filtrera begäranden från begärandefilnamn och filnamnstillägg.
• Filtrera begäranden efter begärande-URL, protokoll, sökväg, frågesträng, postargument och andra värden.

Enhetstyp

Använd matchningsvillkoret för enhetstyp för att identifiera begäranden som kommer från en mobil enhet eller stationär enhet.

Egenskaper

Property	Värden som stöds
Operator	I Azure-portalen: Equal, Not Equal I ARM-mallar: Equal; använd negateCondition egenskapen för att ange Inte lika med
Värde	Mobile, Desktop

Exempel

I det här exemplet matchar vi alla begäranden som har identifierats komma från en mobil enhet.

Portal

JSON

{
  "name": "IsDevice",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "Mobile"
    ],
    "typeName": "DeliveryRuleIsDeviceConditionParameters"
  }
}

{
  "name": "IsDevice",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "Mobile"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleIsDeviceConditionParameters"
  }
}

Bicep

{
  name: 'IsDevice'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'Mobile'
    ]
    typeName: 'DeliveryRuleIsDeviceConditionParameters'
  }
}

{
  name: 'IsDevice'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'Mobile'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleIsDeviceConditionParameters'
  }
}

HTTP-version

Använd http-versionsmatchningsvillkoret för att identifiera begäranden som görs med hjälp av en specifik version av HTTP-protokollet.

Kommentar

HTTP-versionsmatchningsvillkoret är endast tillgängligt på Azure Front Door Standard/Premium.

Egenskaper

Property	Värden som stöds
Operator	I Azure-portalen: Equal, Not Equal I ARM-mallar: Equal; använd negateCondition egenskapen för att ange Inte lika med
Värde	2.0, 1.1, , 1.00.9

Exempel

I det här exemplet matchar vi alla begäranden som skickades med hjälp av HTTP 2.0-protokollet.

Portal

JSON

{
  "name": "HttpVersion",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "2.0"
    ],
    "typeName": "DeliveryRuleHttpVersionConditionParameters"
  }
}

Bicep

{
  name: 'HttpVersion'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      '2.0'
    ]
    typeName: 'DeliveryRuleHttpVersionConditionParameters'
  }
}

Begär cookies

Använd villkoret för att matcha begärandecookies för att identifiera begäranden som innehåller en specifik cookie.

Kommentar

Begärandecookies matchar villkoret är endast tillgängligt på Azure Front Door Standard/Premium.

Egenskaper

Property	Värden som stöds
Cookienamn	Ett strängvärde som representerar namnet på cookien.
Operator	Alla operatorer från standardoperatorlistan.
Värde	Ett eller flera sträng- eller heltalsvärden som representerar värdet för begärandehuvudet som ska matchas. Om flera värden anges utvärderas de med hjälp av OR-logik.
Skiftlägestransformering	Alla transformeringar från listan med standardsträngtransformeringar.

Exempel

I det här exemplet matchar vi alla begäranden som har en cookie med namnet deploymentStampId med värdet 1.

Portal

JSON

{
  "name": "Cookies",
  "parameters": {
    "selector": "deploymentStampId",
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "1"
    ],
    "transforms": [],
    "typeName": "DeliveryRuleCookiesConditionParameters"
  }
}

Bicep

{
  name: 'Cookies'
  parameters: {
    selector: 'deploymentStampId'
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      '1'
    ]
    typeName: 'DeliveryRuleCookiesConditionParameters'
  }
}

Post args

Använd villkoret post args match för att identifiera begäranden baserat på argumenten som anges i postbegärans brödtext. Ett enda matchningsvillkor matchar ett enda argument från POST-begärandetexten. Du kan ange flera värden som ska matchas, vilket kan kombineras med hjälp av OR-logik.

Kommentar

Post args-matchningsvillkoret fungerar med application/x-www-form-urlencoded innehållstypen.

Egenskaper

Property	Värden som stöds
Post args	Ett strängvärde som representerar namnet på POST-argumentet.
Operator	Alla operatorer från standardoperatorlistan.
Värde	Ett eller flera sträng- eller heltalsvärden som representerar värdet för POST-argumentet som ska matchas. Om flera värden anges utvärderas de med hjälp av OR-logik.
Skiftlägestransformering	Alla transformeringar från listan med standardsträngtransformeringar.

Exempel

I det här exemplet matchar vi alla POST-begäranden där ett customerName argument anges i begärandetexten och där värdet customerName för börjar med bokstaven J eller K. Vi använder en skiftlägestransformering för att konvertera indatavärdena till versaler så att värden som börjar med J, j, Koch k alla matchas.

Portal

JSON

{
  "name": "PostArgs",
  "parameters": {
    "selector": "customerName",
    "operator": "BeginsWith",
    "negateCondition": false,
    "matchValues": [
        "J",
        "K"
    ],
    "transforms": [
        "Uppercase"
    ],
    "typeName": "DeliveryRulePostArgsConditionParameters"
}

{
  "name": "PostArgs",
  "parameters": {
    "selector": "customerName",
    "operator": "BeginsWith",
    "negateCondition": false,
    "matchValues": [
        "J",
        "K"
    ],
    "transforms": [
        "Uppercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRulePostArgsConditionParameters"
}

Bicep

{
  name: 'PostArgs'
  parameters: {
    selector: 'customerName'
    operator: 'BeginsWith'
    negateCondition: false
    matchValues: [
      'J'
      'K'
    ]
    transforms: [
      'Uppercase'
    ]
    typeName: 'DeliveryRulePostArgsConditionParameters'
  }
}

{
  name: 'PostArgs'
  parameters: {
    selector: 'customerName'
    operator: 'BeginsWith'
    negateCondition: false
    matchValues: [
      'J'
      'K'
    ]
    transforms: [
      'Uppercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRulePostArgsConditionParameters'
  }
}

Frågesträng

Använd frågesträngens matchningsvillkor för att identifiera begäranden som innehåller en specifik frågesträng. Du kan ange flera värden som ska matchas, vilket kan kombineras med hjälp av OR-logik.

Kommentar

Hela frågesträngen matchas som en enskild sträng, utan inledande ?.

Egenskaper

Property	Värden som stöds
Operator	Alla operatorer från standardoperatorlistan stöds. Villkoret Alla matchningar matchar dock varje begäran, och inte något matchningsvillkor matchar inte någon begäran när det används med frågesträngens matchningsvillkor.
Frågesträng	Ett eller flera sträng- eller heltalsvärden som representerar värdet för frågesträngen som ska matchas. Inkludera ? inte i början av frågesträngen. Om flera värden anges utvärderas de med hjälp av OR-logik.
Skiftlägestransformering	Alla transformeringar från listan med standardsträngtransformeringar.

Exempel

I det här exemplet matchar vi alla begäranden där frågesträngen innehåller strängen language=en-US. Vi vill att matchningsvillkoret ska vara skiftlägeskänsligt, så att vi inte transformerar ärendet.

Portal

JSON

{
  "name": "QueryString",
  "parameters": {
    "operator": "Contains",
    "negateCondition": false,
    "matchValues": [
      "language=en-US"
    ],
    "typeName": "DeliveryRuleQueryStringConditionParameters"
  }
}

{
  "name": "QueryString",
  "parameters": {
    "operator": "Contains",
    "negateCondition": false,
    "matchValues": [
      "language=en-US"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleQueryStringConditionParameters"
  }
}

Bicep

{
  name: 'QueryString'
  parameters: {
    operator: 'Contains'
    negateCondition: false
    matchValues: [
      'language=en-US'
    ]
    typeName: 'DeliveryRuleQueryStringConditionParameters'
  }
}

{
  name: 'QueryString'
  parameters: {
    operator: 'Contains'
    negateCondition: false
    matchValues: [
      'language=en-US'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleQueryStringConditionParameters'
  }
}

Fjärradress

Villkoret för fjärradressmatchning identifierar begäranden baserat på beställarens plats eller IP-adress. Du kan ange flera värden som ska matchas, vilket kan kombineras med hjälp av OR-logik.

• Använd CIDR-notation när du anger IP-adressblock. Syntaxen för ett IP-adressblock är den grundläggande IP-adressen följt av ett snedstreck och prefixstorleken. Till exempel:
  • IPv4-exempel: 5.5.5.64/26 matchar alla begäranden som kommer från adresserna 5.5.5.64 till 5.5.5.127.
  • IPv6-exempel: 1:2:3:/48 matchar alla begäranden som kommer från adresserna 1:2:3:0:0:0:0:0 till 1:2:3: ffff:ffff:ffff:ffff:ffff:ffff.
• När du anger flera IP-adresser och IP-adressblock tillämpas "OR"-logik.
  • IPv4-exempel: om du lägger till två IP-adresser 1.2.3.4 och 10.20.30.40matchas villkoret för alla begäranden som kommer från antingen adressen 1.2.3.4 eller 10.20.30.40.
  • IPv6-exempel: om du lägger till två IP-adresser 1:2:3:4:5:6:7:8 och 10:20:30:40:50:60:70:80matchas villkoret för alla begäranden som kommer från någon av adresserna 1:2:3:4:5:6:7:8 eller 10:20:30:40:50:60:70:80.
• Fjärradressen representerar den ursprungliga klient-IP-adressen som antingen kommer från nätverksanslutningen eller vanligtvis huvudet X-Forwarded-For-begäran om användaren finns bakom en proxy. Använd socketadressens matchningsvillkor (tillgängligt i Standard/Premium) om du behöver matcha baserat på TCP-begärans IP-adress.

Egenskaper

Property	Värden som stöds
Operator	I Azure-portalen: Geo Match, Geo Not Match, IP Matcheller IP Not Match I ARM-mallar: GeoMatch, IPMatch; använder du negateCondition egenskapen för att ange Geo Inte matchning eller IP Inte matchning
Värde	För operatorerna IP Match eller IP Not Match : ange ett eller flera IP-adressintervall. Om flera IP-adressintervall anges utvärderas de med hjälp av OR-logik. För operatorerna Geo Match eller Geo Not Match : ange en eller flera platser med hjälp av sin landskod.

Exempel

I det här exemplet matchar vi alla begäranden där begäran inte kom från USA.

Portal

JSON

{
  "name": "RemoteAddress",
  "parameters": {
    "operator": "GeoMatch",
    "negateCondition": true,
    "matchValues": [
      "US"
    ],
    "typeName": "DeliveryRuleRemoteAddressConditionParameters"
  }
}

{
  "name": "RemoteAddress",
  "parameters": {
    "operator": "GeoMatch",
    "negateCondition": true,
    "matchValues": [
      "US"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRemoteAddressConditionParameters"
  }
}

Bicep

{
  name: 'RemoteAddress'
  parameters: {
    operator: 'GeoMatch'
    negateCondition: true
    matchValues: [
      'US'
    ]
    typeName: 'DeliveryRuleRemoteAddressConditionParameters'
  }
}

{
  name: 'RemoteAddress'
  parameters: {
    operator: 'GeoMatch'
    negateCondition: true
    matchValues: [
      'US'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRemoteAddressConditionParameters'
  }
}

Begärandetext

Villkoret för matchning av begärandetext identifierar begäranden baserat på specifik text som visas i brödtexten i begäran. Du kan ange flera värden som ska matchas, vilket kan kombineras med hjälp av OR-logik.

Kommentar

Om en begärandetext överskrider 64 KB i storlek, kommer endast de första 64 KB att beaktas för begärandetextens matchningsvillkor.

Egenskaper

Property	Värden som stöds
Operator	Alla operatorer från standardoperatorlistan stöds. Matchningsvillkoret Alla matchar dock varje begäran, och inte något matchningsvillkor matchar inte någon begäran när det används med begärandetextensmatchningsvillkor.
Värde	Ett eller flera sträng- eller heltalsvärden som representerar värdet för brödtexten för begäran som ska matchas. Om flera värden anges utvärderas de med hjälp av OR-logik.
Skiftlägestransformering	Alla transformeringar från listan med standardsträngtransformeringar.

Exempel

I det här exemplet matchar vi alla begäranden där begärandetexten innehåller strängen ERROR. Vi omvandlar begärandetexten till versaler innan vi utvärderar matchningen, så error och andra skiftlägesvariationer utlöser även det här matchningsvillkoret.

Portal

JSON

{
  "name": "RequestBody",
  "parameters": {
    "operator": "Contains",
    "negateCondition": false,
    "matchValues": [
      "ERROR"
    ],
    "transforms": [
      "Uppercase"
    ],
    "typeName": "DeliveryRuleRequestBodyConditionParameters"
  }
}

{
  "name": "RequestBody",
  "parameters": {
    "operator": "Contains",
    "negateCondition": false,
    "matchValues": [
      "ERROR"
    ],
    "transforms": [
      "Uppercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestBodyConditionParameters"
  }
}

Bicep

{
  name: 'RequestBody'
  parameters: {
    operator: 'Contains'
    negateCondition: false
    matchValues: [
      'ERROR'
    ]
    transforms: [
      'Uppercase'
    ]
    typeName: 'DeliveryRuleRequestBodyConditionParameters'
  }
}

{
  name: 'RequestBody'
  parameters: {
    operator: 'Contains'
    negateCondition: false
    matchValues: [
      'ERROR'
    ]
    transforms: [
      'Uppercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestBodyConditionParameters'
  }
}

Namn på begärandefil

Villkoret för matchning av begärandefilens namn identifierar begäranden som innehåller det angivna filnamnet i begärande-URL:en. Du kan ange flera värden som ska matchas, vilket kan kombineras med hjälp av OR-logik.

Egenskaper

Property	Värden som stöds
Operator	Alla operatorer från standardoperatorlistan stöds. Villkoret Alla matchningar matchar dock varje begäran, och inte något matchningsvillkor matchar inte någon begäran när det används med begärandefilens namnmatchningsvillkor .
Värde	En eller flera sträng- eller heltalsvärden som representerar värdet för det begärandefilnamn som ska matchas. Om flera värden anges utvärderas de med hjälp av OR-logik.
Skiftlägestransformering	Alla transformeringar från listan med standardsträngtransformeringar.

Exempel

I det här exemplet matchar vi alla begäranden där namnet på begärandefilen är media.mp4. Vi omvandlar filnamnet till gemener innan vi utvärderar matchningen, så MEDIA.MP4 och andra skiftlägesvariationer utlöser även det här matchningsvillkoret.

Portal

JSON

{
  "name": "UrlFileName",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "media.mp4"
    ],
    "transforms": [
      "Lowercase"
    ],
    "typeName": "DeliveryRuleUrlFilenameConditionParameters"
  }
}

{
  "name": "UrlFileName",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "media.mp4"
    ],
    "transforms": [
      "Lowercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlFilenameConditionParameters"
  }
}

Bicep

{
  name: 'UrlFileName'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'media.mp4'
    ]
    transforms: [
      'Lowercase'
    ]
    typeName: 'DeliveryRuleUrlFilenameConditionParameters'
  }
}

{
  name: 'UrlFileName'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'media.mp4'
    ]
    transforms: [
      'Lowercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlFilenameConditionParameters'
  }
}

Filnamnstillägg för begäran

Matchningsvillkoret för filnamnstillägget för begäran identifierar begäranden som innehåller det angivna filtillägget i filnamnet i begärande-URL:en. Du kan ange flera värden som ska matchas, vilket kan kombineras med hjälp av OR-logik.

Kommentar

Ta inte med en inledande punkt. Använd till exempel html i stället för .html.

Egenskaper

Property	Värden som stöds
Operator	Alla operatorer från standardoperatorlistan stöds. Alla matchningsvillkor matchar dock varje begäran, och inte några matchningsvillkor matchar inte någon begäran när det används med matchningsvillkoret för filnamnstillägget för begäran.
Värde	Ett eller flera sträng- eller heltalsvärden som representerar värdet för filtillägget för begäran som ska matchas. Ta inte med en inledande punkt. Om flera värden anges utvärderas de med hjälp av OR-logik.
Skiftlägestransformering	Alla transformeringar från listan med standardsträngtransformeringar.

Exempel

I det här exemplet matchar vi alla begäranden där filnamnstillägget för begäran är pdf eller docx. Vi omvandlar filtillägget för begäran till gemener innan vi utvärderar matchningen, så PDF, DocXoch andra skiftlägesvariationer utlöser även det här matchningsvillkoret.

Portal

JSON

{
  "name": "UrlFileExtension",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "pdf",
      "docx"
    ],
    "transforms": [
      "Lowercase"
    ],
    "typeName": "DeliveryRuleUrlFileExtensionMatchConditionParameters"
  }

{
  "name": "UrlFileExtension",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "pdf",
      "docx"
    ],
    "transforms": [
      "Lowercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlFileExtensionMatchConditionParameters"
  }

Bicep

{
  name: 'UrlFileExtension'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'pdf'
      'docx'
    ]
    transforms: [
      'Lowercase'
    ]
    typeName: 'DeliveryRuleUrlFileExtensionMatchConditionParameters'
  }
}

{
  name: 'UrlFileExtension'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'pdf'
      'docx'
    ]
    transforms: [
      'Lowercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlFileExtensionMatchConditionParameters'
  }
}

Begärandehuvud

Villkoret för matchning av begärandehuvud identifierar begäranden som innehåller ett specifikt huvud i begäran. Du kan använda det här matchningsvillkoret för att kontrollera om en rubrik finns eller för att kontrollera om rubriken matchar ett angivet värde. Du kan ange flera värden som ska matchas, vilket kan kombineras med hjälp av OR-logik.

Egenskaper

Property	Värden som stöds
Huvudnamn	Ett strängvärde som representerar namnet på POST-argumentet.
Operator	Alla operatorer från standardoperatorlistan.
Värde	Ett eller flera sträng- eller heltalsvärden som representerar värdet för begärandehuvudet som ska matchas. Om flera värden anges utvärderas de med hjälp av OR-logik.
Skiftlägestransformering	Alla transformeringar från listan med standardsträngtransformeringar.

Exempel

I det här exemplet matchar vi alla begäranden där begäran innehåller ett huvud med namnet MyCustomHeader, oavsett dess värde.

Portal

JSON

{
  "name": "RequestHeader",
  "parameters": {
    "selector": "MyCustomHeader",
    "operator": "Any",
    "negateCondition": false,
    "typeName": "DeliveryRuleRequestHeaderConditionParameters"
  }
}

{
  "name": "RequestHeader",
  "parameters": {
    "selector": "MyCustomHeader",
    "operator": "Any",
    "negateCondition": false,
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestHeaderConditionParameters"
  }
}

Bicep

{
  name: 'RequestHeader'
  parameters: {
    selector: 'MyCustomHeader',
    operator: 'Any'
    negateCondition: false
    typeName: 'DeliveryRuleRequestHeaderConditionParameters'
  }
}

{
  name: 'RequestHeader'
  parameters: {
    selector: 'MyCustomHeader',
    operator: 'Any'
    negateCondition: false
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestHeaderConditionParameters'
  }
}

Metod för begäran

Villkoret för matchning av begärandemetoden identifierar begäranden som använder den angivna HTTP-begärandemetoden. Du kan ange flera värden som ska matchas, vilket kan kombineras med hjälp av OR-logik.

Egenskaper

Property	Värden som stöds
Operator	I Azure-portalen: Equal, Not Equal I ARM-mallar: Equal; använd negateCondition egenskapen för att ange Inte lika med
Metod för begäran	En eller flera HTTP-metoder från: GET, POST, PUT, DELETE, HEAD, OPTIONS, TRACE. Om flera värden anges utvärderas de med hjälp av OR-logik.

Exempel

I det här exemplet matchar vi alla begäranden där begäran använder DELETE metoden.

Portal

JSON

{
  "name": "RequestMethod",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "DELETE"
    ],
    "typeName": "DeliveryRuleRequestMethodConditionParameters"
  }
}

{
  "name": "RequestMethod",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "DELETE"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestMethodConditionParameters"
  }
}

Bicep

{
  name: 'RequestMethod'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'DELETE'
    ]
    typeName: 'DeliveryRuleRequestMethodConditionParameters'
  }
}

{
  name: 'RequestMethod'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'DELETE'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestMethodConditionParameters'
  }
}

Sökväg för begäran

Villkoret för matchning av begärandesökväg identifierar begäranden som innehåller den angivna sökvägen i begärande-URL:en. Du kan ange flera värden som ska matchas, vilket kan kombineras med hjälp av OR-logik.

Kommentar

Sökvägen är en del av URL:en efter värdnamnet och ett snedstreck. I URL:en https://www.contoso.com/files/secure/file1.pdfär files/secure/file1.pdfsökvägen till exempel .

Egenskaper

Property	Värden som stöds
Operator	Alla operatorer från standardoperatorlistan stöds. Matchningsvillkoret Alla matchar dock varje begäran, och inte något matchningsvillkor matchar inte någon begäran när det används med villkoret för matchning av sökväg för begäran. Jokertecken: Matchar när begärandesökvägen matchar ett jokerteckenuttryck. Ett jokerteckenuttryck kan innehålla * tecknet för att matcha noll eller fler tecken i sökvägen. Jokertecknet files/customer*/file.pdf matchar till exempel sökvägarna files/customer1/file.pdf, files/customer109/file.pdfoch files/customer/file.pdf, men matchar files/customer2/anotherfile.pdfinte . I Azure-portalen: Wildcards, Not Wildcards I ARM-mallar: Wildcard; använd egenskapen negateCondition för att ange Inte jokertecken
Värde	Ett eller flera sträng- eller heltalsvärden som representerar värdet för sökvägen för begäran som ska matchas. Om du anger ett inledande snedstreck ignoreras det. Om flera värden anges utvärderas de med hjälp av OR-logik.
Skiftlägestransformering	Alla transformeringar från listan med standardsträngtransformeringar.

Property	Värden som stöds
Operator	Alla operatorer från standardoperatorlistan stöds. Matchningsvillkoret Alla matchar dock varje begäran, och inte något matchningsvillkor matchar inte någon begäran när det används med villkoret för matchning av sökväg för begäran.
Värde	Ett eller flera sträng- eller heltalsvärden som representerar värdet för sökvägen för begäran som ska matchas. Om du anger ett inledande snedstreck ignoreras det. Om flera värden anges utvärderas de med hjälp av OR-logik.
Skiftlägestransformering	Alla transformeringar från listan med standardsträngtransformeringar.

Exempel

I det här exemplet matchar vi alla begäranden där sökvägen till begärandefilen börjar med files/secure/. Vi omvandlar filtillägget för begäran till gemener innan vi utvärderar matchningen, så begäranden till files/SECURE/ och andra skiftlägesvariationer utlöser även det här matchningsvillkoret.

Portal

JSON

{
  "name": "UrlPath",
  "parameters": {
    "operator": "BeginsWith",
    "negateCondition": false,
    "matchValues": [
      "files/secure/"
    ],
    "transforms": [
      "Lowercase"
    ],
    "typeName": "DeliveryRuleUrlPathMatchConditionParameters"
  }
}

{
  "name": "UrlPath",
  "parameters": {
    "operator": "BeginsWith",
    "negateCondition": false,
    "matchValues": [
      "files/secure/"
    ],
    "transforms": [
      "Lowercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlPathMatchConditionParameters"
  }
}

Bicep

{
  name: 'UrlPath'
  parameters: {
    operator: 'BeginsWith'
    negateCondition: false
    matchValues: [
      'files/secure/'
    ]
    transforms: [
      'Lowercase'
    ]
    typeName: 'DeliveryRuleUrlPathMatchConditionParameters'
  }
}

{
  name: 'UrlPath'
  parameters: {
    operator: 'BeginsWith'
    negateCondition: false
    matchValues: [
      'files/secure/'
    ]
    transforms: [
      'Lowercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleUrlPathMatchConditionParameters'
  }
}

Protokoll för begäran

Matchningsvillkoret för begärandeprotokollet identifierar begäranden som använder det angivna protokollet (HTTP eller HTTPS).

Kommentar

Protokoll kallas ibland även för schema.

Egenskaper

Property	Värden som stöds
Operator	I Azure-portalen: Equal, Not Equal I ARM-mallar: Equal; använd negateCondition egenskapen för att ange Inte lika med
Metod för begäran	HTTP, HTTPS

Exempel

I det här exemplet matchar vi alla begäranden där begäran använder HTTP protokollet.

Portal

JSON

{
  "name": "RequestScheme",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "HTTP"
    ],
    "typeName": "DeliveryRuleRequestSchemeConditionParameters"
  }
}

{
  "name": "RequestScheme",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "HTTP"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestSchemeConditionParameters"
  }
}

Bicep

{
  name: 'RequestScheme'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'HTTP'
    ]
    typeName: 'DeliveryRuleRequestSchemeConditionParameters'
  }
}

{
  name: 'RequestScheme'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'HTTP'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestSchemeConditionParameters'
  }
}

Begärans-URL

Identifierar begäranden som matchar den angivna URL:en. Hela URL:en utvärderas, inklusive protokollet och frågesträngen, men inte fragmentet. Du kan ange flera värden som ska matchas, vilket kan kombineras med hjälp av OR-logik.

Dricks

När du använder det här regelvillkoret måste du inkludera protokollet och ett avslutande snedstreck /. Använd till exempel https://www.contoso.com/ i stället för bara www.contoso.com.

Egenskaper

Property	Värden som stöds
Operator	Alla operatorer från standardoperatorlistan stöds. Matchningsvillkoret Alla matchar dock varje begäran och matchningsvillkoret Inte alla matchar inte någon begäran när det används med matchningsvillkoret för begärande-URL:en .
Värde	En eller flera sträng- eller heltalsvärden som representerar värdet för den begärande-URL som ska matchas. Om flera värden anges utvärderas de med hjälp av OR-logik.
Skiftlägestransformering	Alla transformeringar från listan med standardsträngtransformeringar.

Exempel

I det här exemplet matchar vi alla begäranden där begärande-URL:en börjar med https://api.contoso.com/customers/123. Vi omvandlar filtillägget för begäran till gemener innan vi utvärderar matchningen, så begäranden till https://api.contoso.com/Customers/123 och andra skiftlägesvariationer utlöser också det här matchningsvillkoret.

Portal

JSON

{
  "name": "RequestUri",
  "parameters": {
    "operator": "BeginsWith",
    "negateCondition": false,
    "matchValues": [
      "https://api.contoso.com/customers/123"
    ],
    "transforms": [
      "Lowercase"
    ],
    "typeName": "DeliveryRuleRequestUriConditionParameters"
  }
}

{
  "name": "RequestUri",
  "parameters": {
    "operator": "BeginsWith",
    "negateCondition": false,
    "matchValues": [
      "https://api.contoso.com/customers/123"
    ],
    "transforms": [
      "Lowercase"
    ],
    "@odata.type": "#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestUriConditionParameters"
  }
}

Bicep

{
  name: 'RequestUri'
  parameters: {
    operator: 'BeginsWith'
    negateCondition: false
    matchValues: [
      'https://api.contoso.com/customers/123'
    ]
    transforms: [
      'Lowercase'
    ]
    typeName: 'DeliveryRuleRequestUriConditionParameters'
  }
}

{
  name: 'RequestUri'
  parameters: {
    operator: 'BeginsWith'
    negateCondition: false
    matchValues: [
      'https://api.contoso.com/customers/123'
    ]
    transforms: [
      'Lowercase'
    ]
    '@odata.type': '#Microsoft.Azure.Cdn.Models.DeliveryRuleRequestUriConditionParameters'
  }
}

Värdnamn

Värdnamnets matchningsvillkor identifierar begäranden baserat på det angivna värdnamnet i begäran från klienten. Matchningsvillkoret Host använder huvudvärdet för att utvärdera värdnamnet. Du kan ange flera värden som ska matchas, vilket kan kombineras med hjälp av OR-logik.

Egenskaper

Property	Värden som stöds
Operator	Alla operatorer från standardoperatorlistan stöds. Matchningsvillkoret Alla matchar dock varje begäran och matchningsvillkoret Inte alla matchar inte någon begäran när det används med värdnamnets matchningsvillkor.
Värde	Ett eller flera strängvärden som representerar värdet för värdnamnet för begäran som ska matchas. Om flera värden anges utvärderas de med hjälp av OR-logik.
Skiftlägestransformering	Alla fall transformeras från listan med standardsträngtransformering.

Exempel

I det här exemplet matchar vi alla begäranden med en Host rubrik som slutar med contoso.com.

Portal

JSON

{
  "name": "HostName",
  "parameters": {
    "operator": "EndsWith",
    "negateCondition": false,
    "matchValues": [
      "contoso.com"
    ],
    "transforms": [],
    "typeName": "DeliveryRuleHostNameConditionParameters"
  }
}

Bicep

{
  name: 'HostName'
  parameters: {
    operator: 'EndsWith'
    negateCondition: false
    matchValues: [
      'contoso.com'
    ]
    transforms: []
    typeName: 'DeliveryRuleHostNameConditionParameters'
  }
}

SSL-protokoll

SSL-protokollets matchningsvillkor identifierar begäranden baserat på SSL-protokollet för en etablerad TLS-anslutning. Du kan ange flera värden som ska matchas, vilket kan kombineras med hjälp av OR-logik.

Egenskaper

Property	Värden som stöds
Operator	I Azure-portalen: Equal, Not Equal I ARM-mallar: Equal; använd negateCondition egenskapen för att ange Inte lika med
SSL-protokoll	I Azure-portalen: 1.0, 1.1, 1.2 I ARM-mallar: TLSv1, TLSv1.1, TLSv1.2

Exempel

I det här exemplet matchar vi alla begäranden som använder TLS 1.2-protokollet.

Portal

JSON

{
  "name": "SslProtocol",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "TLSv1.2"
    ],
    "typeName": "DeliveryRuleSslProtocolConditionParameters"
  }
},

Bicep

{
  name: 'SslProtocol'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      'TLSv1.2'
    ]
    typeName: 'DeliveryRuleSslProtocolConditionParameters'
  }
}

Socket-adress

Socketadressens matchningsvillkor identifierar begäranden baserat på IP-adressen för direktanslutningen till Azure Front Door Edge. Du kan ange flera värden som ska matchas, vilket kan kombineras med hjälp av OR-logik.

Kommentar

Om klienten använde en HTTP-proxy eller en lastbalanserare för att skicka begäran är socketadressen IP-adressen för proxyn eller lastbalanseraren.

Använd fjärradressmatchningsvillkoret om du behöver matcha baserat på klientens ursprungliga IP-adress.

• Använd CIDR-notation när du anger IP-adressblock. Det innebär att syntaxen för ett IP-adressblock är den grundläggande IP-adressen följt av ett snedstreck och prefixstorleken. Till exempel:
  • IPv4-exempel: 5.5.5.64/26 matchar alla begäranden som kommer från adresserna 5.5.5.64 till 5.5.5.127.
  • IPv6-exempel: 1:2:3:/48 matchar alla begäranden som kommer från adresserna 1:2:3:0:0:0:0:0 till 1:2:3: ffff:ffff:ffff:ffff:ffff:ffff.
• När du anger flera IP-adresser och IP-adressblock tillämpas "OR"-logik.
  • IPv4-exempel: om du lägger till två IP-adresser 1.2.3.4 och 10.20.30.40matchas villkoret för alla begäranden som kommer från antingen adressen 1.2.3.4 eller 10.20.30.40.
  • IPv6-exempel: om du lägger till två IP-adresser 1:2:3:4:5:6:7:8 och 10:20:30:40:50:60:70:80matchas villkoret för alla begäranden som kommer från någon av adresserna 1:2:3:4:5:6:7:8 eller 10:20:30:40:50:60:70:80.

Egenskaper

Property	Värden som stöds
Operator	I Azure-portalen: IP Match, Not IP Match I ARM-mallar: IPMatch; använd egenskapen negateCondition för att ange Inte IP-matchning
Värde	Ange ett eller flera IP-adressintervall. Om flera IP-adressintervall anges utvärderas de med hjälp av OR-logik.

Exempel

I det här exemplet matchar vi alla begäranden från IP-adresser i intervallet 5.5.5.64/26.

Portal

JSON

{
  "name": "SocketAddr",
  "parameters": {
    "operator": "IPMatch",
    "negateCondition": false,
    "matchValues": [
      "5.5.5.64/26"
    ],
    "typeName": "DeliveryRuleSocketAddrConditionParameters"
  }
}

Bicep

{
  name: 'SocketAddr'
  parameters: {
    operator: 'IPMatch'
    negateCondition: false
    matchValues: [
      '5.5.5.64/26'
    ]
    typeName: 'DeliveryRuleSocketAddrConditionParameters'
  }
}

Klientport

Klientportens matchningsvillkor identifierar begäranden baserat på TCP-porten för klienten som gjorde begäran. Du kan ange flera värden som ska matchas, vilket kan kombineras med hjälp av OR-logik.

Egenskaper

Property	Värden som stöds
Operator	Alla operatorer från standardoperatorlistan stöds. Alla matchningsvillkor matchar dock varje begäran, och inte några matchningsvillkor matchar inte någon begäran när det används med klientportens matchningsvillkor.
Värde	Ett eller flera portnummer, uttryckta som heltal. Om flera värden anges utvärderas de med hjälp av OR-logik.

Exempel

I det här exemplet matchar vi alla begäranden med en klientport på 1234.

Portal

JSON

{
  "name": "ClientPort",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "1111"
    ],
    "typeName": "DeliveryRuleClientPortConditionParameters"
  }
}

Bicep

{
  name: 'ClientPort'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      '1111'
    ]
    typeName: 'DeliveryRuleClientPortConditionParameters'
  }
}

Serverport

Serverportens matchningsvillkor identifierar begäranden baserat på TCP-porten för Azure Front Door-servern som accepterade begäran. Porten måste vara 80 eller 443. Du kan ange flera värden som ska matchas, vilket kan kombineras med hjälp av OR-logik.

Egenskaper

Property	Värden som stöds
Operator	Alla operatorer från standardoperatorlistan stöds. Alla matchningsvillkor matchar dock varje begäran, och inte några matchningsvillkor matchar inte någon begäran när det används med serverportens matchningsvillkor.
Värde	Ett portnummer, som måste vara antingen 80 eller 443. Om flera värden anges utvärderas de med hjälp av OR-logik.

Exempel

I det här exemplet matchar vi alla begäranden med en serverport på 443.

Portal

JSON

{
  "name": "ServerPort",
  "parameters": {
    "operator": "Equal",
    "negateCondition": false,
    "matchValues": [
      "443"
    ],
    "typeName": "DeliveryRuleServerPortConditionParameters"
  }
}

Bicep

{
  name: 'ServerPort'
  parameters: {
    operator: 'Equal'
    negateCondition: false
    matchValues: [
      '443'
    ]
    typeName: 'DeliveryRuleServerPortConditionParameters'
  }
}

Operatorlista

För regler som accepterar värden från standardoperatorlistan är följande operatorer giltiga:

Operatör	Beskrivning	Stöd för ARM-mallar
Valfri	Matchar när det finns ett värde, oavsett vad värdet är.	operator: Any
Lika med	Matchar när värdet exakt matchar den angivna strängen.	operator: Equal
Innehåller	Matchar när värdet innehåller den angivna strängen.	operator: Contains
Mindre än	Matchar när längden på värdet är mindre än det angivna heltalet.	operator: LessThan
Större än	Matchar när längden på värdet är större än det angivna heltalet.	operator: GreaterThan
Mindre än eller lika med	Matchar när längden på värdet är mindre än eller lika med det angivna heltalet.	operator: LessThanOrEqual
Större än eller lika med	Matchar när längden på värdet är större än eller lika med det angivna heltalet.	operator: GreaterThanOrEqual
Börjar med	Matchar när värdet börjar med den angivna strängen.	operator: BeginsWith
Slutar med	Matchar när värdet slutar med den angivna strängen.	operator: EndsWith
Inget	Matchar när det inte finns något värde.	operator: Any och negateCondition : true
Inte lika med	Matchar när värdet inte matchar den angivna strängen.	operator: Equal och negateCondition : true
Innehåller inte	Matchar när värdet inte innehåller den angivna strängen.	operator: Contains och negateCondition : true
Inte mindre än	Matchar när längden på värdet inte är mindre än det angivna heltalet.	operator: LessThan och negateCondition : true
Inte större än	Matchar när längden på värdet inte är större än det angivna heltalet.	operator: GreaterThan och negateCondition : true
Inte mindre än eller lika med	Matchar när längden på värdet inte är mindre än eller lika med det angivna heltalet.	operator: LessThanOrEqual och negateCondition : true
Inte större än eller lika med	Matchar när värdets längd inte är större än eller lika med det angivna heltalet.	operator: GreaterThanOrEqual och negateCondition : true
Börjar inte med	Matchar när värdet inte börjar med den angivna strängen.	operator: BeginsWith och negateCondition : true
Slutar inte med	Matchar när värdet inte slutar med den angivna strängen.	operator: EndsWith och negateCondition : true

Operatör	Beskrivning	Stöd för ARM-mallar
Valfri	Matchar när det finns ett värde, oavsett vad värdet är.	operator: Any
Lika med	Matchar när värdet exakt matchar den angivna strängen.	operator: Equal
Innehåller	Matchar när värdet innehåller den angivna strängen.	operator: Contains
Mindre än	Matchar när längden på värdet är mindre än det angivna heltalet.	operator: LessThan
Större än	Matchar när längden på värdet är större än det angivna heltalet.	operator: GreaterThan
Mindre än eller lika med	Matchar när längden på värdet är mindre än eller lika med det angivna heltalet.	operator: LessThanOrEqual
Större än eller lika med	Matchar när längden på värdet är större än eller lika med det angivna heltalet.	operator: GreaterThanOrEqual
Börjar med	Matchar när värdet börjar med den angivna strängen.	operator: BeginsWith
Slutar med	Matchar när värdet slutar med den angivna strängen.	operator: EndsWith
Regex	Matchar när värdet matchar det angivna reguljära uttrycket. Mer information finns nedan.	operator: RegEx
Inget	Matchar när det inte finns något värde.	operator: Any och negateCondition : true
Inte lika med	Matchar när värdet inte matchar den angivna strängen.	operator: Equal och negateCondition : true
Innehåller inte	Matchar när värdet inte innehåller den angivna strängen.	operator: Contains och negateCondition : true
Inte mindre än	Matchar när längden på värdet inte är mindre än det angivna heltalet.	operator: LessThan och negateCondition : true
Inte större än	Matchar när längden på värdet inte är större än det angivna heltalet.	operator: GreaterThan och negateCondition : true
Inte mindre än eller lika med	Matchar när längden på värdet inte är mindre än eller lika med det angivna heltalet.	operator: LessThanOrEqual och negateCondition : true
Inte större än eller lika med	Matchar när värdets längd inte är större än eller lika med det angivna heltalet.	operator: GreaterThanOrEqual och negateCondition : true
Börjar inte med	Matchar när värdet inte börjar med den angivna strängen.	operator: BeginsWith och negateCondition : true
Slutar inte med	Matchar när värdet inte slutar med den angivna strängen.	operator: EndsWith och negateCondition : true
Inte RegEx	Matchar när värdet inte matchar det angivna reguljära uttrycket. Mer information finns nedan.	operator: RegEx och negateCondition : true

Dricks

För numeriska operatorer som Mindre än och Större än eller lika med baseras jämförelsen på längd. Värdet i matchningsvillkoret ska vara ett heltal som anger den längd som du vill jämföra.

Reguljära uttryck

Reguljära uttryck stöder inte följande åtgärder:

• Backreferences och fånga underuttryck.
• Godtyckliga kontroller med noll bredd.
• Subrutinreferenser och rekursiva mönster.
• Villkorsmönster.
• Backtracking-kontrollverb.
• Direktivet \C med en byte.
• Det \R nya matchningsdirektivet.
• Start av \K matchningsåterställningsdirektivet.
• Pratbubblar och inbäddad kod.
• Atomiska gruppering och possessiva kvantifierare.

Strängtransformeringslista

För regler som kan transformera strängar är följande transformeringar giltiga:

Transformering	beskrivning	Stöd för ARM-mallar
Till gemener	Konverterar strängen till gemener.	Lowercase
Till versaler	Konverterar strängen till versalrepresentationen.	Uppercase
Trimma	Trimmar inledande och avslutande blanksteg från strängen.	Trim
Ta bort null-värden	Tar bort null-värden från strängen.	RemoveNulls
URL-kodning	URL-kodar strängen.	UrlEncode
URL-avkodning	URL-avkodar strängen.	UrlDecode

Nästa steg

• Läs mer om Regelmotor för Azure Front Door (klassisk)
• Lär dig hur du konfigurerar din första regelmotor.
• Läs mer om regelåtgärder

• Läs mer om Regeluppsättning för Azure Front Door.
• Lär dig hur du konfigurerar din första regeluppsättning.
• Läs mer om regelåtgärder.