Naslag informatie voor de standaard regels voor Azure CDNStandard rules engine reference for Azure CDN

In de standaard regels-engine voor Azure Content Delivery Network (Azure CDN) bestaat een regel uit een of meer match-voor waarden en een actie.In the Standard rules engine for Azure Content Delivery Network (Azure CDN), a rule consists of one or more match conditions and an action. In dit artikel vindt u gedetailleerde beschrijvingen van de voor waarden en functies die beschikbaar zijn in de standaard regels-engine voor Azure CDN.This article provides detailed descriptions of the match conditions and features that are available in the Standard rules engine for Azure CDN.

De regel engine is ontworpen als de definitieve instantie van hoe specifieke typen aanvragen worden verwerkt door de standaard Azure CDN.The rules engine is designed to be the final authority on how specific types of requests are processed by Standard Azure CDN.

Veelvoorkomende toepassingen voor de regels:Common uses for the rules:

  • Een aangepast cache beleid overschrijft of definieert.Override or define a custom cache policy.
  • Aanvragen omleiden.Redirect requests.
  • Wijzig HTTP-aanvraag-en antwoord headers.Modify HTTP request and response headers.

TerminologieTerminology

Als u een regel in de regel Engine wilt definiëren, stelt u de voor waarden en actiesvoor afstemmen in:To define a rule in the rules engine, set match conditions and actions:

Structuur van Azure CDN-regels

Elke regel kan Maxi maal vier match voorwaarden en drie acties hebben.Each rule can have up to four match conditions and three actions. Elk Azure CDN-eind punt kan Maxi maal vijf regels bevatten.Each Azure CDN endpoint can have up to five rules.

Opgenomen in de huidige limiet van vijf regels voor een Azure CDN-eind punt is een standaard globale regel.Included in the current five-rule limit for an Azure CDN endpoint is a default global rule. De algemene regel heeft geen overeenkomende voor waarden en acties die in een globale regel worden gedefinieerd, worden altijd geactiveerd.The global rule doesn't have match conditions, and actions that are defined in a global rule always trigger.

SyntaxisSyntax

Hoe speciale tekens worden behandeld in een regel, hangt af van de manier waarop de verschillende match voorwaarden en acties tekst waarden afhandelen.How special characters are treated in a rule varies based on how different match conditions and actions handle text values. Een match-voor waarde of actie kan tekst op een van de volgende manieren interpreteren:A match condition or action can interpret text in one of the following ways:

Letterlijke waardenLiteral values

Tekst die wordt geïnterpreteerd als een letterlijke waarde, behandelt alle speciale tekens , met uitzonde ring van het symbool% als onderdeel van de waarde die moet worden vergeleken in een regel.Text that's interpreted as a literal value treats all special characters except the % symbol as part of the value that must be matched in a rule. Bijvoorbeeld: een letterlijke match-voor waarde die is ingesteld op '*' is alleen vervuld als de exacte waarde '*' is gevonden.For example, a literal match condition set to '*' is satisfied only when the exact value '*' is found.

Een procent teken wordt gebruikt om URL-code ring aan te geven (bijvoorbeeld %20).A percent sign is used to indicate URL encoding (for example, %20).

Joker teken waardenWildcard values

Tekst die wordt geïnterpreteerd als een Joker teken, wijst extra betekenissen toe aan speciale tekens.Text that's interpreted as a wildcard value assigns additional meaning to special characters. In de volgende tabel wordt beschreven hoe specifieke speciale tekens worden geïnterpreteerd in de standaard regels-engine:The following table describes how specific special characters are interpreted in the Standard rules engine:

TekenCharacter BeschrijvingDescription
\ Een back slash wordt gebruikt om een van de tekens die in deze tabel zijn opgegeven, te escapepen.A backslash is used to escape any of the characters specified in this table. Een back slash moet direct voor het speciale teken worden opgegeven.A backslash must be specified directly before the special character that should be escaped. De volgende syntaxis verescapet bijvoorbeeld een asterisk: \*For example, the following syntax escapes an asterisk: \*
% Een procent teken wordt gebruikt om URL-code ring aan te geven (bijvoorbeeld %20).A percent sign is used to indicate URL encoding (for example, %20).
* Een asterisk is een Joker teken dat bestaat uit een of meer tekens.An asterisk is a wildcard that represents one or more characters.
gelijkespace Een spatie geeft aan dat aan een voor waarde voor een overeenkomst kan worden voldaan door een van de opgegeven waarden of patronen.A space character indicates that a match condition can be satisfied by either of the specified values or patterns.
enkele aanhalings tekenssingle quotation marks Een enkel aanhalings teken heeft geen speciale betekenis.A single quotation mark doesn't have special meaning. Een reeks enkele aanhalings tekens geeft echter aan dat een waarde moet worden behandeld als een letterlijke waarde.However, a set of single quotation marks indicates that a value should be treated as a literal value. Enkele aanhalings tekens kunnen op de volgende manieren worden gebruikt:Single quotation marks can be used in the following ways:
  • Om aan te geven dat aan een match-voor waarde wordt voldaan wanneer de opgegeven waarde overeenkomt met een deel van de vergelijkings waarde.To allow a match condition to be satisfied whenever the specified value matches any portion of the comparison value. 'ma' komt bijvoorbeeld overeen met een van de volgende teken reeksen:For example, 'ma' would match any of the following strings:
    • /business/marathon/asset.htm/business/marathon/asset.htm
    • map.gifmap.gif
    • /business/template. map/business/template.map
  • Als u wilt toestaan dat een speciaal teken wordt opgegeven als een letterlijke teken.To allow a special character to be specified as a literal character. U kunt bijvoorbeeld een letterlijke spatie opgeven door een spatie tussen enkele aanhalings tekens (' ' of '<sample value>') te zetten.For example, you can specify a literal space character by enclosing a space character in a set of single quotation marks (' ' or '<sample value>').
  • Om toe te staan dat een lege waarde wordt opgegeven.To allow a blank value to be specified. Geef een lege waarde op door een paar enkele aanhalings tekens ( ' ' ) op te geven.Specify a blank value by specifying a set of single quotation marks ('').
Belang rijk:Important:
  • Als de opgegeven waarde geen joker teken bevat, wordt de waarde automatisch beschouwd als een letterlijke waarde.If the specified value doesn't contain a wildcard, the value is automatically considered a literal value. U hoeft geen set met enkele aanhalings tekens voor een letterlijke waarde op te geven.You don't need to specify a set of single quotation marks for a literal value.
  • Als een back slash niet wordt gebruikt om een ander teken in deze tabel te escapeel, wordt de back slash genegeerd als deze is opgegeven in een reeks enkele aanhalings tekens.If a backslash isn't used to escape another character in this table, the backslash is ignored when it's specified in a set of single quotation marks.
  • Een andere manier om een speciaal teken als letterlijke teken op te geven, is door een back slash (\) te gebruiken.Another way to specify a special character as a literal character is to escape it by using a backslash (\).

Volgende stappenNext steps