Condizioni di corrispondenza del motore regole della rete CDN di AzureAzure CDN rules engine match conditions

Questo articolo fornisce descrizioni dettagliate delle condizioni di corrispondenza disponibili per il motore regole della rete per la distribuzione di contenuti (rete CDN) di Azure.This article lists detailed descriptions of the available match conditions for the Azure Content Delivery Network (CDN) rules engine.

La seconda parte di una regola è la condizione di corrispondenza.The second part of a rule is the match condition. Una condizione di corrispondenza identifica specifici tipi di richieste per cui verrà eseguito un set di funzionalità.A match condition identifies specific types of requests for which a set of features will be performed.

Ad esempio, è possibile usare una condizione di corrispondenza per:For example, you can use a match condition to:

  • Filtrare le richieste per il contenuto in base a una posizione specifica.Filter requests for content at a particular location.
  • Filtrare le richieste generate da un indirizzo IP o da un paese specifico.Filter requests generated from a particular IP address or country.
  • Filtrare le richieste in base alle informazioni dell'intestazione.Filter requests by header information.

Condizione di corrispondenza SempreAlways match condition

La condizione di corrispondenza Sempre applica un set predefinito di funzionalità a tutte le richieste.The Always match condition applies a default set of features to all requests.

NOMEName ScopoPurpose
SempreAlways Applica un set predefinito di funzionalità a tutte le richieste.Applies a default set of features to all requests.

Condizione di corrispondenza DispositivoDevice match condition

La condizione di corrispondenza Dispositivo identifica le richieste effettuate da un dispositivo mobile in base alle relative proprietà.The Device match condition identifies requests made from a mobile device based on its properties.

NOMEName ScopoPurpose
DispositivoDevice Identifica le richieste effettuate da un dispositivo mobile in base alle relative proprietà.Identifies requests made from a mobile device based on its properties.

Condizioni di corrispondenza PosizioneLocation match conditions

Le condizioni di corrispondenza Posizione identificano le richieste in base alla posizione del richiedente.The Location match conditions identify requests based on the requester's location.

NOMEName ScopoPurpose
Numero ASAS Number Identifica le richieste che hanno origine da una determinata rete.Identifies requests that originate from a particular network.
PaeseCountry Identifica le richieste che hanno origine dai paesi specificati.Identifies requests that originate from the specified countries.

Condizioni di corrispondenza OrigineOrigin match conditions

Le condizioni di corrispondenza Origine identificano le richieste che puntano all'archivio della rete CDN o a un server di origine del cliente.The Origin match conditions identify requests that point to Content Delivery Network storage or a customer origin server.

NOMEName ScopoPurpose
Origine rete CDNCDN Origin Identifica le richieste per il contenuto archiviato nell'archivio della rete CDN.Identifies requests for content stored in Content Delivery Network storage.
Origine clienteCustomer Origin Identifica le richieste di contenuto in uno specifico server di origine del cliente.Identifies requests for content stored on a specific customer origin server.

Condizioni di corrispondenza RichiestaRequest match conditions

Le condizioni di corrispondenza Richiesta identificano le richieste in base alle relative proprietà.The Request match conditions identify requests based on their properties.

NOMEName ScopoPurpose
Indirizzo IP clientClient IP Address Identifica le richieste che hanno origine da un determinato indirizzo IP.Identifies requests that originate from a particular IP address.
Parametro cookieCookie Parameter Controlla il valore specificato nei cookie associati a ogni richiesta.Checks the cookies associated with each request for the specified value.
Espressione regolare parametro cookieCookie Parameter Regex Controlla l'espressione regolare specificata nei cookie associati a ogni richiesta.Checks the cookies associated with each request for the specified regular expression.
CNAME perimetraleEdge Cname Identifica le richieste che fanno riferimento a un CNAME periferico specifico.Identifies requests that point to a specific edge CNAME.
Dominio di riferimentoReferring Domain Identifica le richieste con riferimenti dai nomi host specificati.Identifies requests that were referred from the specified host names.
Valore letterale intestazione richiestaRequest Header Literal Identifica le richieste che contengono l'intestazione specificata impostata su un valore specificato.Identifies requests that contain the specified header set to a specified value.
Espressione regolare intestazione richiestaRequest Header Regex Identifica le richieste che contengono l'intestazione specificata impostata su un valore che corrisponde all'espressione regolare specificata.Identifies requests that contain the specified header set to a value that matches the specified regular expression.
Carattere jolly intestazione richiestaRequest Header Wildcard Identifica le richieste che contengono l'intestazione specificata impostata su un valore che corrisponde al modello specificato.Identifies requests that contain the specified header set to a value that matches the specified pattern.
Metodo richiestaRequest Method Identifica le richieste in base al relativo metodo HTTP.Identifies requests by their HTTP method.
Schema richiestaRequest Scheme Identifica le richieste in base al relativo protocollo HTTP.Identifies requests by their HTTP protocol.

Condizioni di corrispondenza URLURL match conditions

Le condizioni di corrispondenza URL identificano le richieste in base ai relativi URL.The URL match conditions identify requests based on their URLs.

NOMEName ScopoPurpose
URL Path Directory (Directory percorso URL)URL Path Directory Identifica le richieste in base al percorso relativo.Identifies requests by their relative path.
URL Path Extension (Estensione percorso URL)URL Path Extension Identifica le richieste in base all'estensione del nome file.Identifies requests by their file name extension.
URL Path Filename (Nome file percorso URL)URL Path Filename Identifica le richieste in base al nome del file.Identifies requests by their file name.
URL Path Literal (Valore letterale percorso URL)URL Path Literal Confronta il percorso relativo di una richiesta con il valore specificato.Compares a request's relative path to the specified value.
URL Path Regex (Espressione regolare percorso URL)URL Path Regex Confronta il percorso relativo di una richiesta con l'espressione regolare specificata.Compares a request's relative path to the specified regular expression.
URL Path Wildcard (Carattere jolly percorso URL)URL Path Wildcard Confronta il percorso relativo di una richiesta con il modello specificato.Compares a request's relative path to the specified pattern.
URL Query Literal (Valore letterale query URL)URL Query Literal Confronta la stringa di query di una richiesta con il valore specificato.Compares a request's query string to the specified value.
URL Query Parameter (Parametro query URL)URL Query Parameter Identifica le richieste che contengono il parametro della stringa di query specificato impostato su un valore che corrisponde a un modello specificato.Identifies requests that contain the specified query string parameter set to a value that matches a specified pattern.
URL Query Regex (Espressione regolare query URL)URL Query Regex Identifica le richieste che contengono il parametro della stringa di query specificato impostato su un valore che corrisponde a un'espressione regolare specificata.Identifies requests that contain the specified query string parameter set to a value that matches a specified regular expression.
URL Query Wildcard (Carattere jolly query URL)URL Query Wildcard Confronta uno o più valori specificati con la stringa di query della richiesta.Compares the specified value against the request's query string.

Riferimento per le condizioni di corrispondenza del motore regoleReference for rules engine match conditions


SempreAlways

La condizione di corrispondenza Sempre applica un set predefinito di funzionalità a tutte le richieste.The Always match condition applies a default set of features to all requests.

Torna all'inizioBack to top



Numero ASAS Number

La rete Numero AS è definita dal relativo numero di sistema autonomo (ASN).The AS Number network is defined by its autonomous system number (ASN).

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza:The Matches/Does Not Match option determines the conditions under which the AS Number match condition is met:

  • Matches (Corrisponde): richiede che l'ASN della rete client corrisponda a uno degli ASN specificati.Matches: Requires that the ASN of the client network matches one of the specified ASNs.
  • Does Not Match (Non corrisponde): richiede che l'ASN della rete client non corrisponda ad alcuno degli ASN specificati.Does Not Match: Requires that the ASN of the client network does not match any of the specified ASNs.

Informazioni chiave:Key information:

  • È possibile specificare più numeri di sistema autonomo delimitandoli con uno spazio singolo.Specify multiple ASNs by delimiting each one with a single space. Ad esempio, 64514 64515 corrisponde alle richieste provenienti da 64514 o 64515.For example, 64514 64515 matches requests that arrive from either 64514 or 64515.
  • Determinate richieste potrebbero non restituire un numero di sistema autonomo (ASN) valido.Certain requests might not return a valid ASN. Un punto interrogativo (?) contrassegnerà le richieste per cui non è stato possibile determinare un numero di sistema autonomo (ASN) valido.A question mark (?) will match requests for which a valid ASN could not be determined.
  • Specificare l'intero ASN per la rete desiderata.Specify the entire ASN for the desired network. Non verrà effettuata una corrispondenza con valori parziali.Partial values will not be matched.
  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:
    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Torna all'inizioBack to top



Origine CDNCDN Origin

La condizione di corrispondenza Origine rete CDN viene soddisfatta quando vengono soddisfatte entrambe le condizioni seguenti:The CDN Origin match condition is met when both of the following conditions are met:

  • È stato richiesto contenuto dall'archiviazione della rete CDN.Content from CDN storage was requested.
  • L'URI della richiesta usa il tipo di punto di accesso al contenuto, ad esempio /000001, definito nella condizione di corrispondenza:The request URI uses the type of content access point (for example, /000001) that's defined in this match condition:
    • URL della rete CDN: l'URI della richiesta deve contenere il punto di accesso al contenuto selezionato.CDN URL: The request URI must contain the selected content access point.
    • URL CNAME perimetrale: la configurazione CNAME perimetrale corrispondente deve puntare al punto di accesso al contenuto selezionato.Edge CNAME URL: The corresponding edge CNAME configuration must point to the selected content access point.

Informazioni chiave:Key information:

  • Il punto di accesso al contenuto identifica il servizio che deve gestire il contenuto richiesto.The content access point identifies the service that should serve the requested content.
  • Non usare l'istruzione AND IF per combinare determinate condizioni di corrispondenza.Don't use an AND IF statement to combine certain match conditions. Ad esempio, se si combina una condizione di corrispondenza Origine rete CDN con una condizione di corrispondenza Origine cliente, viene generato un criterio di corrispondenza che non potrà mai restituire risultati.For example, combining a CDN Origin match condition with a Customer Origin match condition would create a match pattern that could never be matched. Per questo motivo, due condizioni di corrispondenza Origine rete CDN non possono essere combinate tramite un'istruzione AND IF.For this reason, two CDN Origin match conditions cannot be combined through an AND IF statement.

Torna all'inizioBack to top



Indirizzo IP clientClient IP Address

L'opzione Matches (Corrisponde)/ Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza:The Matches/Does Not Match option determines the conditions under which the Client IP Address match condition is met:

  • Matches (Corrisponde): richiede che l'indirizzo IP del client corrisponda a uno degli indirizzi IP specificati.Matches: Requires that the client's IP address matches one of the specified IP addresses.
  • Does Not Match (Non corrisponde): richiede che l'indirizzo IP del client non corrisponda a uno degli indirizzi IP specificati.Does Not Match: Requires that the client's IP address does not match any of the specified IP addresses.

Informazioni chiave:Key information:

  • Usare la notazione CIDR.Use CIDR notation.
  • Per specificare più indirizzi IP e/o blocchi di indirizzi IP, delimitarli con uno spazio singolo.Specify multiple IP addresses and/or IP address blocks by delimiting each one with a single space. Ad esempio: For example:
    • Esempio di indirizzo IPv4: 1.2.3.4 10.20.30.40 corrisponde alle richieste provenienti dall'indirizzo 1.2.3.4 o 10.20.30.40.IPv4 example: 1.2.3.4 10.20.30.40 matches any requests that arrive from either address 1.2.3.4 or 10.20.30.40.
    • Esempio di indirizzo IPv6: 1:2:3:4:5:6:7:8 10:20:30:40:50:60:70:80 corrisponde alle richieste provenienti dall'indirizzo 1:2:3:4:5:6:7:8 o 10:20:30:40:50:60:70:80.IPv6 example: 1:2:3:4:5:6:7:8 10:20:30:40:50:60:70:80 matches any requests that arrive from either address 1:2:3:4:5:6:7:8 or 10:20:30:40:50:60:70:80.
  • La sintassi per un blocco di indirizzi IP è l'indirizzo IP di base seguito da una barra e dalle dimensioni del prefisso.The syntax for an IP address block is the base IP address followed by a forward slash and the prefix size. Ad esempio: For example:
    • Esempio di indirizzo IPv4: 5.5.5.64/26 corrisponde alle richieste provenienti dagli indirizzi compresi tra 5.5.5.64 e 5.5.5.127.IPv4 example: 5.5.5.64/26 matches any requests that arrive from addresses 5.5.5.64 through 5.5.5.127.
    • Esempio di indirizzo IPv6: 1:2:3:/48 corrisponde alle richieste provenienti dagli indirizzi compresi tra 1:2:3:0:0:0:0:0 e 1:2:3:ffff:ffff:ffff:ffff:ffff.IPv6 example: 1:2:3:/48 matches any requests that arrive from addresses 1:2:3:0:0:0:0:0 through 1:2:3:ffff:ffff:ffff:ffff:ffff.
  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:
    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Torna all'inizioBack to top



L'opzione Matches (Corrisponde)/Does Not Matches (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza.The Matches/Does Not Match option determines the conditions under which the Cookie Parameter match condition is met.

  • Corrisponde: prevede che una richiesta contenga il cookie specificato con un valore che corrisponda ad almeno uno dei valori definiti nella condizione di corrispondenza.Matches: Requires a request to contain the specified cookie with a value that matches at least one of the values that are defined in this match condition.
  • Does Not Match (Non corrisponde): specifica che la richiesta soddisfi uno dei criteri seguenti:Does Not Match: Requires that the request meets either of the following criteria:
    • Non contiene il cookie specificato.It does not contain the specified cookie.
    • Contiene il cookie specificato, ma il relativo valore non corrisponde ad alcun valore definito nella condizione di corrispondenza.It contains the specified cookie, but its value does not match any of the values that are defined in this match condition.

Informazioni chiave:Key information:

  • Nome cookie:Cookie name:
    • Poiché i valori con caratteri jolly, inclusi gli asterischi (*), non sono supportati per specificare un nome di cookie, solo le corrispondenze esatte dei nomi di cookie sono idonee per il confronto.Because wildcard values, including asterisks (*), are not supported when you're specifying a cookie name, only exact cookie name matches are eligible for comparison.
    • È possibile specificare un solo nome di cookie per istanza della condizione di corrispondenza.Only a single cookie name can be specified per instance of this match condition.
    • I confronti tra nomi di cookie non fanno distinzione tra maiuscole e minuscole.Cookie name comparisons are case-insensitive.
  • Valore cookie:Cookie value:
    • È possibile specificare più valori cookie delimitandoli con uno spazio singolo.Specify multiple cookie values by delimiting each one with a single space.
    • Un valore di cookie può usare caratteri jolly.A cookie value can take advantage of wildcard values.
    • Se non è stato specificato un carattere jolly, solo una corrispondenza esatta potrà soddisfare questa condizione di corrispondenza.If a wildcard value has not been specified, then only an exact match will satisfy this match condition. Se ad esempio si specifica "Valore", verrà trovata una corrispondenza con "Valore", ma non con "Valore1" o "Valore2".For example, specifying "Value" will match "Value," but not "Value1" or "Value2."
    • Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per determinare se effettuare un controllo rispetto al valore di cookie della richiesta tenendo conto o meno della distinzione tra maiuscole e minuscole.Use the Ignore Case option to control whether a case-sensitive comparison is made against the request's cookie value.
  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:
    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Torna all'inizioBack to top



La condizione di corrispondenza Espressione regolare parametro cookie definisce un nome e un valore del cookie.The Cookie Parameter Regex match condition defines a cookie name and value. Per definire il valore di cookie desiderato, è possibile usare espressioni regolari.You can use regular expressions to define the desired cookie value.

L'opzione Matches (Corrisponde)/Does Not Matches (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza.The Matches/Does Not Match option determines the conditions under which the Cookie Parameter Regex match condition is met.

  • Corrisponde: prevede che la richiesta contenga il cookie specificato con un valore che corrisponde all'espressione regolare specificata.Matches: Requires a request to contain the specified cookie with a value that matches the specified regular expression.
  • Does Not Match (Non corrisponde): specifica che la richiesta soddisfi uno dei criteri seguenti:Does Not Match: Requires that the request meets either of the following criteria:
    • Non contiene il cookie specificato.It does not contain the specified cookie.
    • Contiene il cookie specificato, ma il relativo valore non corrisponde all'espressione regolare specificata.It contains the specified cookie, but its value does not match the specified regular expression.

Informazioni chiave:Key information:

  • Nome cookie:Cookie name:
    • Poiché le espressioni regolari e i caratteri jolly, inclusi gli asterischi (*), non sono supportati per specificare un nome di cookie, solo le corrispondenze esatte dei nomi di cookie sono idonee per il confronto.Because regular expressions and wildcard values, including asterisks (*), are not supported when you're specifying a cookie name, only exact cookie name matches are eligible for comparison.
    • È possibile specificare un solo nome di cookie per istanza della condizione di corrispondenza.Only a single cookie name can be specified per instance of this match condition.
    • I confronti tra nomi di cookie non fanno distinzione tra maiuscole e minuscole.Cookie name comparisons are case-insensitive.
  • Valore cookie:Cookie value:
    • Per i valori cookie è possibile usare le espressioni regolari.A cookie value can take advantage of regular expressions.
    • Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per determinare se effettuare un controllo rispetto al valore di cookie della richiesta tenendo conto o meno della distinzione tra maiuscole e minuscole.Use the Ignore Case option to control whether a case-sensitive comparison is made against the request's cookie value.
  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:
    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Torna all'inizioBack to top



PaeseCountry

È possibile specificare un paese tramite il codice paese corrispondente.You can specify a country through its country code.

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza:The Matches/Does Not Match option determines the conditions under which the Country match condition is met:

  • Matches (Corrisponde): specifica che la richiesta contenga i valori del codice di paese specificati.Matches: Requires the request to contain the specified country code values.
  • Does Not Match (Non corrisponde): specifica che la richiesta non contenga i valori del codice di paese specificati.Does Not Match: Requires that the request does not contain the specified country code values.

Informazioni chiave:Key information:

  • È possibile specificare più codici paese delimitandoli con uno spazio singolo.Specify multiple country codes by delimiting each one with a single space.
  • Per specificare i codici paese, i caratteri jolly non sono supportati.Wildcards are not supported when you're specifying a country code.
  • I codici paese "EU" e "AP" non includono tutti gli indirizzi IP in tali aree.The "EU" and "AP" country codes do not encompass all IP addresses in those regions.
  • Determinate richieste potrebbero non restituire un codice paese valido.Certain requests might not return a valid country code. Un punto interrogativo (?) contrassegnerà le richieste per cui non è stato possibile determinare un codice paese valido.A question mark (?) will match requests for which a valid country code could not be determined.
  • I codici paese fanno distinzione tra maiuscole e minuscole.Country codes are case-sensitive.
  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:
    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Implementazione del filtro dei paesi tramite il motore regoleImplementing Country Filtering by using the rules engine

Questa condizione di corrispondenza permette di eseguire numerose personalizzazioni in base alla posizione da cui ha origine una richiesta.This match condition allows you to perform a multitude of customizations based on the location from which a request originated. Ad esempio, il comportamento della funzionalità del filtro dei paesi può essere replicato tramite la configurazione seguente:For example, the behavior of the Country Filtering feature can be replicated through the following configuration:

  • Corrispondenza URL Path Wildcard (Carattere jolly percorso URL): impostare la condizione di corrispondenza URL Path Wildcard (Carattere jolly percorso URL) sulla directory che verrà protetta.URL Path Wildcard match: Set the URL Path Wildcard match condition to the directory that will be secured. Aggiungere un asterisco alla fine del percorso relativo per assicurarsi che l'accesso a tutti gli elementi figlio venga limitato da questa regola.Append an asterisk to the end of the relative path to ensure that access to all of its children will be restricted by this rule.

  • Corrispondenza Paese: impostare la condizione di corrispondenza Paese sul set desiderato di paesi.Country match: Set the Country match condition to the desired set of countries.

    • Consenti: impostare la condizione di corrispondenza Paese su Does Not Match (Non corrisponde) per consentire solo ai paesi specificati l'accesso al contenuto archiviato nella posizione definita dalla condizione di corrispondenza URL Path Wildcard (Carattere jolly percorso URL).Allow: Set the Country match condition to Does Not Match to allow only the specified countries access to content stored in the location defined by the URL Path Wildcard match condition.
    • Blocca: impostare la condizione di corrispondenza Paese su Matches (Corrisponde) per impedire ai paesi specificati l'accesso al contenuto archiviato nella posizione definita dalla condizione di corrispondenza URL Path Wildcard (Carattere jolly percorso URL).Block: Set the Country match condition to Matches to block the specified countries from accessing content stored in the location defined by the URL Path Wildcard match condition.
  • Funzionalità Deny Access (403) (Nega accesso - 403): abilitare la funzionalità Deny Access (403) (Nega accesso - 403) per replicare la parte Consenti o Blocca della funzionalità del filtro dei paesi.Deny Access (403) Feature: Enable the Deny Access (403) feature to replicate the allow or block portion of the Country Filtering feature.

Torna all'inizioBack to top



Origine clienteCustomer Origin

Informazioni chiave:Key information:

  • La condizione di corrispondenza Customer Origin (Origine cliente) viene soddisfatta indipendentemente dal fatto che il contenuto venga richiesto tramite un URL della rete CDN o un URL CNAME perimetrale che punta all'origine cliente selezionata.The Customer Origin match condition is met regardless of whether content is requested through a CDN URL or an edge CNAME URL that points to the selected customer origin.
  • Non è possibile eliminare dalla pagina Origine cliente una configurazione di origine cliente a cui fa riferimento una regola.A customer origin configuration that's referenced by a rule cannot be deleted from the Customer Origin page. Prima di provare a eliminare una configurazione di origine cliente, assicurarsi che le configurazioni seguenti non vi facciano riferimento:Before you attempt to delete a customer origin configuration, make sure that the following configurations do not reference it:
    • Una condizione di corrispondenza Origine clienteA Customer Origin match condition
    • Una configurazione CNAME perimetraleAn edge CNAME configuration
  • Non usare l'istruzione AND IF per combinare determinate condizioni di corrispondenza.Don't use an AND IF statement to combine certain match conditions. Ad esempio, se si combina una condizione di corrispondenza Origine cliente con una condizione di corrispondenza Origine rete CDN, viene generato un criterio di corrispondenza che non potrà mai restituire risultati.For example, combining a Customer Origin match condition with a CDN Origin match condition would create a match pattern that could never be matched. Per questo motivo, due condizioni di corrispondenza Origine cliente non possono essere combinate tramite un'istruzione AND IF.For this reason, two Customer Origin match conditions cannot be combined through an AND IF statement.

Torna all'inizioBack to top



DispositivoDevice

La condizione di corrispondenza Dispositivo identifica le richieste effettuate da un dispositivo mobile in base alle relative proprietà.The Device match condition identifies requests made from a mobile device based on its properties. Il rilevamento del dispositivo mobile viene eseguito tramite WURFL.Mobile device detection is achieved through WURFL.

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza:The Matches/Does Not Match option determines the conditions under which the Device match condition is met:

  • Matches (Corrisponde): specifica che il dispositivo del richiedente corrisponda al valore specificato.Matches: Requires the requester's device to match the specified value.
  • Does Not Match (Non corrisponde): specifica che il dispositivo del richiedente non corrisponda al valore specificato.Does Not Match: Requires that the requester's device does not match the specified value.

Informazioni chiave:Key information:

  • Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per specificare se il valore specificato fa distinzione tra maiuscole e minuscole.Use the Ignore Case option to specify whether the specified value is case-sensitive.
  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:
    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Tipo di stringaString Type

Una funzionalità WURFL accetta in genere qualsiasi combinazione di numeri, lettere e simboli.A WURFL capability typically accepts any combination of numbers, letters, and symbols. A causa della natura flessibile di questa funzionalità, è necessario scegliere il modo in cui interpretare il valore associato alla condizione di corrispondenza.Due to the flexible nature of this capability, you must choose how the value associated with this match condition is interpreted. La tabella seguente descrive il set di opzioni disponibile:The following table describes the available set of options:

typeType DESCRIZIONEDescription
Literal (Valore letterale)Literal Selezionare questa opzione per impedire alla maggior parte dei caratteri di assumere un significato speciale usando il rispettivo valore letterale.Select this option to prevent most characters from taking on special meaning by using their literal value.
Wildcard (Carattere jolly)Wildcard Selezionare questa opzione per trarre vantaggio da tutti i [caratteri jolly](caratteri jolly.Select this option to take advantage of all [wildcard characters](wildcard values.
Regex (Espressione regolare)Regex Selezionare questa opzione per usare espressioni regolari.Select this option to use regular expressions. Le espressioni regolari sono utili per definire un modello di caratteri.Regular expressions are useful for defining a pattern of characters.

Funzionalità WURFLWURFL capabilities

Una funzionalità WURFL fa riferimento a una categoria che descrive i dispositivi mobili.A WURFL capability refers to a category that describes mobile devices. La funzionalità selezionata determina il tipo di descrizione del dispositivo mobile usata per identificare le richieste.The selected capability determines the type of mobile device description that is used to identify requests.

La tabella seguente elenca le funzionalità WURFL e le rispettive variabili per il motore regole.The following table lists WURFL capabilities and their variables for the rules engine.

Nota

Le variabili seguenti sono supportate nelle funzionalità Modify Client Request Header (Modifica intestazione richiesta client) e Modify Client Response Header (Modifica intestazione risposta client).The following variables are supported in the Modify Client Request Header and Modify Client Response Header features.

FunzionalitàCapability VariabileVariable DESCRIZIONEDescription Valori di esempioSample values
Brand Name (Nome marchio)Brand Name %{wurfl_cap_brand_name}%{wurfl_cap_brand_name} Stringa che indica il nome del marchio del dispositivo.A string that indicates the brand name of the device. SamsungSamsung
Device OS (Sistema operativo dispositivo)Device OS %{wurfl_cap_device_os}%{wurfl_cap_device_os} Stringa che indica il sistema operativo installato nel dispositivo.A string that indicates the operating system installed on the device. IOSIOS
Device OS Version (Versione sistema operativo dispositivo)Device OS Version %{wurfl_cap_device_os_version}%{wurfl_cap_device_os_version} Stringa che indica il numero di versione del sistema operativo installato nel dispositivo.A string that indicates the version number of the operating system installed on the device. 1.0.11.0.1
Dual Orientation (Orientamento doppio)Dual Orientation %{wurfl_cap_dual_orientation}%{wurfl_cap_dual_orientation} Valore booleano che indica se il dispositivo supporta l'orientamento doppio.A Boolean that indicates whether the device supports dual orientation. truetrue
HTML Preferred DTD (DTD preferito HTML)HTML Preferred DTD %{wurfl_cap_html_preferred_dtd}%{wurfl_cap_html_preferred_dtd} Stringa che indica la definizione DTD (Document Type Definition) preferita del dispositivo mobile per il contenuto HTML.A string that indicates the mobile device's preferred document type definition (DTD) for HTML content. Nessunonone
xhtml_basicxhtml_basic
html5html5
Image Inlining (Incorporamento immagini)Image Inlining %{wurfl_cap_image_inlining}%{wurfl_cap_image_inlining} Valore booleano che indica se il dispositivo supporta le immagini con codifica in Base64.A Boolean that indicates whether the device supports Base64 encoded images. falsefalse
Is Android (È Android)Is Android %{wurfl_vcap_is_android}%{wurfl_vcap_is_android} Valore booleano che indica se il dispositivo usa il sistema operativo Android.A Boolean that indicates whether the device uses the Android OS. truetrue
Is IOS (È IOS)Is IOS %{wurfl_vcap_is_ios}%{wurfl_vcap_is_ios} Valore booleano che indica se il dispositivo usa il sistema operativo iOS.A Boolean that indicates whether the device uses iOS. falsefalse
Is Smart TV (È una smart TV)Is Smart TV %{wurfl_cap_is_smarttv}%{wurfl_cap_is_smarttv} Valore booleano che indica se il dispositivo è una smart TV.A Boolean that indicates whether the device is a smart TV. falsefalse
Is Smartphone (È uno smartphone)Is Smartphone %{wurfl_vcap_is_smartphone}%{wurfl_vcap_is_smartphone} Valore booleano che indica se il dispositivo è uno smartphone.A Boolean that indicates whether the device is a smartphone. truetrue
Is Tablet (È un tablet)Is Tablet %{wurfl_cap_is_tablet}%{wurfl_cap_is_tablet} Valore booleano che indica se il dispositivo è un tablet.A Boolean that indicates whether the device is a tablet. Questa descrizione è indipendente dal sistema operativo.This description is OS-independent. truetrue
Is Wireless Device (È un dispositivo wireless)Is Wireless Device %{wurfl_cap_is_wireless_device}%{wurfl_cap_is_wireless_device} Valore booleano che indica se il dispositivo è considerato un dispositivo wireless.A Boolean that indicates whether the device is considered a wireless device. truetrue
Marketing Name (Nome marketing)Marketing Name %{wurfl_cap_marketing_name}%{wurfl_cap_marketing_name} Stringa che indica il nome marketing del dispositivo.A string that indicates the device's marketing name. BlackBerry 8100 PearlBlackBerry 8100 Pearl
Mobile Browser (Browser per dispositivi mobili)Mobile Browser %{wurfl_cap_mobile_browser}%{wurfl_cap_mobile_browser} Stringa che indica il browser usato per richiedere contenuto dal dispositivo.A string that indicates the browser that's used to request content from the device. ChromeChrome
Mobile Browser Version (Versione browser per dispositivi mobili)Mobile Browser Version %{wurfl_cap_mobile_browser_version}%{wurfl_cap_mobile_browser_version} Stringa che indica la versione del browser usato per richiedere contenuto dal dispositivo.A string that indicates the version of the browser that's used to request content from the device. 3131
Model Name (Nome modello)Model Name %{wurfl_cap_model_name}%{wurfl_cap_model_name} Stringa che indica il nome del modello del dispositivo.A string that indicates the device's model name. s3s3
Download progressivoProgressive Download %{wurfl_cap_progressive_download}%{wurfl_cap_progressive_download} Valore booleano che indica se il dispositivo supporta la riproduzione di audio e video mentre il download è ancora in corso.A Boolean that indicates whether the device supports the playback of audio and video while it is still being downloaded. truetrue
Data di rilascioRelease Date %{wurfl_cap_release_date}%{wurfl_cap_release_date} Stringa che indica il mese e l'anno in cui il dispositivo è stato aggiunto al database WURFL.A string that indicates the year and month on which the device was added to the WURFL database.

Formato: yyyy_mmFormat: yyyy_mm
2013_december2013_december
Resolution Height (Altezza risoluzione)Resolution Height %{wurfl_cap_resolution_height}%{wurfl_cap_resolution_height} Numero intero che indica l'altezza del dispositivo in pixel.An integer that indicates the device's height in pixels. 768768
Resolution Width (Larghezza risoluzione)Resolution Width %{wurfl_cap_resolution_width}%{wurfl_cap_resolution_width} Numero intero che indica la larghezza del dispositivo in pixel.An integer that indicates the device's width in pixels. 10241024

Torna all'inizioBack to top



CNAME perifericoEdge Cname

Informazioni chiave:Key information:

  • L'elenco degli URL CNAME perimetrali disponibili è limitato a quelli che sono stati configurati nella pagina degli URL CNAME perimetrali per la piattaforma in cui viene configurato il motore regole.The list of available edge CNAMEs is limited to those edge CNAMEs that have been configured on the Edge CNAMEs page for the platform on which the rules engine is being configured.
  • Prima di provare a eliminare una configurazione CNAME perimetrale, assicurarsi che una condizione di corrispondenza CNAME perimetrale non vi faccia riferimento.Before you attempt to delete an edge CNAME configuration, make sure that an Edge Cname match condition does not reference it. Le configurazioni CNAME perimetrali definite in una regola non possono essere eliminate dalla pagina CNAME perimetrali.Edge CNAME configurations that have been defined in a rule cannot be deleted from the Edge CNAMEs page.
  • Non usare l'istruzione AND IF per combinare determinate condizioni di corrispondenza.Don't use an AND IF statement to combine certain match conditions. Ad esempio, se si combina una condizione di corrispondenza CNAME perimetrale con una condizione di corrispondenza Origine cliente, viene generato un criterio di corrispondenza che non potrà mai restituire risultati.For example, combining an Edge Cname match condition with a Customer Origin match condition would create a match pattern that could never be matched. Per questo motivo, due condizioni di corrispondenza CNAME perimetrale non possono essere combinate tramite un'istruzione AND IF.For this reason, two Edge Cname match conditions cannot be combined through an AND IF statement.
  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:
    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Torna all'inizioBack to top



Dominio di riferimentoReferring Domain

Il nome host associato al referrer tramite cui il contenuto è stato richiesto determina se viene soddisfatta o meno la condizione Dominio di riferimento.The host name associated with the referrer through which content was requested determines whether the Referring Domain condition is met.

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza:The Matches/Does Not Match option determines the conditions under which the Referring Domain match condition is met:

  • Matches (Corrisponde): richiede che il nome host corrisponda al valore specificato.Matches: Requires the referring host name to match the specified values.
  • Does Not Match (Non corrisponde): richiede che il nome host non corrisponda al valore specificato.Does Not Match: Requires that the referring host name does not match the specified value.

Informazioni chiave:Key information:

  • È possibile specificare più nomi host delimitandoli con uno spazio singolo.Specify multiple host names by delimiting each one with a single space.
  • Questa condizione di corrispondenza supporta i caratteri jolly.This match condition supports wildcard values.
  • Se il valore specificato non contiene un asterisco, deve essere una corrispondenza esatta per il nome host del referrer.If the specified value does not contain an asterisk, it must be an exact match for the referrer's host name. Ad esempio, se si specifica "miodominio.com" non verrà trovata una corrispondenza con "www.miodominio.com".For example, specifying "mydomain.com" would not match "www.mydomain.com."
  • Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per determinare se il controllo deve essere eseguito tenendo conto o meno della distinzione tra maiuscole e minuscole.Use the Ignore Case option to control whether a case-sensitive comparison is made.
  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:
    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Torna all'inizioBack to top



Valore letterale intestazione richiestaRequest Header Literal

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza.The Matches/Does Not Match option determines the conditions under which the Request Header Literal match condition is met.

  • Corrisponde: prevede che la richiesta contenga l'intestazione specificata.Matches: Requires the request to contain the specified header. Il relativo valore deve corrispondere al valore definito in questa condizione di corrispondenza.Its value must match the one that's defined in this match condition.
  • Does Not Match (Non corrisponde): specifica che la richiesta soddisfi uno dei criteri seguenti:Does Not Match: Requires that the request meets either of the following criteria:
    • Non contiene l'intestazione specificata.It does not contain the specified header.
    • Contiene l'intestazione specificata, ma il relativo valore non corrisponde al valore definito in questa condizione di corrispondenza.It contains the specified header, but its value does not match the one that's defined in this match condition.

Informazioni chiave:Key information:

  • I confronti tra nomi di intestazioni non fanno mai distinzione tra maiuscole e minuscole.Header name comparisons are always case-insensitive. Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per controllare la distinzione tra maiuscole e minuscole nei confronti dei valori di intestazione.Use the Ignore Case option to control the case-sensitivity of header value comparisons.
  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:
    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Torna all'inizioBack to top



Espressione regolare intestazione richiestaRequest Header Regex

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza.The Matches/Does Not Match option determines the conditions under which the Request Header Regex match condition is met.

  • Corrisponde: prevede che la richiesta contenga l'intestazione specificata.Matches: Requires the request to contain the specified header. Il valore deve corrispondere al modello definito nell'espressione regolare specificata.Its value must match the pattern that's defined in the specified regular expression.
  • Does Not Match (Non corrisponde): specifica che la richiesta soddisfi uno dei criteri seguenti:Does Not Match: Requires that the request meets either of the following criteria:
    • Non contiene l'intestazione specificata.It does not contain the specified header.
    • Contiene l'intestazione specificata, ma il relativo valore non corrisponde all'espressione regolare specificata.It contains the specified header, but its value does not match the specified regular expression.

Informazioni chiave:Key information:

  • Nome intestazione:Header name:
    • I confronti tra nomi di intestazioni non fanno distinzione tra maiuscole e minuscole.Header name comparisons are case-insensitive.
    • Sostituire gli spazi nel nome dell'intestazione con "%20".Replace spaces in the header name with "%20."
  • Valore dell'intestazione:Header value:
    • Per i valori delle impostazioni è possibile usare le espressioni regolari.A header value can take advantage of regular expressions.
    • Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per controllare la distinzione tra maiuscole e minuscole nei confronti dei valori di intestazione.Use the Ignore Case option to control the case-sensitivity of header value comparisons.
    • Questa condizione verrà soddisfatta solo se il valore dell'intestazione corrisponde esattamente ad almeno uno dei modelli specificati.The match condition is met only when a header value exactly matches at least one of the specified patterns.
  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:
    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Torna all'inizioBack to top



Carattere jolly intestazione richiestaRequest Header Wildcard

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza.The Matches/Does Not Match option determines the conditions under which the Request Header Wildcard match condition is met.

  • Corrisponde: prevede che la richiesta contenga l'intestazione specificata.Matches: Requires the request to contain the specified header. Il relativo valore deve corrispondere ad almeno uno dei valori definiti in questa condizione di corrispondenza.Its value must match at least one of the values that are defined in this match condition.
  • Does Not Match (Non corrisponde): specifica che la richiesta soddisfi uno dei criteri seguenti:Does Not Match: Requires that the request meets either of the following criteria:
    • Non contiene l'intestazione specificata.It does not contain the specified header.
    • Contiene l'intestazione specificata, ma il relativo valore non corrisponde ad alcun valore specificato.It contains the specified header, but its value does not match any of the specified values.

Informazioni chiave:Key information:

  • Nome intestazione:Header name:
    • I confronti tra nomi di intestazioni non fanno distinzione tra maiuscole e minuscole.Header name comparisons are case-insensitive.
    • Nel nome dell'intestazione gli spazi devono essere sostituiti con "%20".Spaces in the header name should be replaced with "%20." È anche possibile usare questo valore per specificare gli spazi in un valore dell'intestazione.You can also use this value to specify spaces in a header value.
  • Valore dell'intestazione:Header value:
    • Un valore di intestazione può usare caratteri jolly.A header value can take advantage of wildcard values.
    • Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per controllare la distinzione tra maiuscole e minuscole nei confronti dei valori di intestazione.Use the Ignore Case option to control the case-sensitivity of header value comparisons.
    • Questa condizione di corrispondenza verrà soddisfatta quando un valore di intestazione corrisponde esattamente ad almeno uno dei modelli specificati.This match condition is met when a header value exactly matches to at least one of the specified patterns.
    • È possibile specificare più valori delimitandoli con uno spazio singolo.Specify multiple values by delimiting each one with a single space.
  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:
    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Torna all'inizioBack to top



Metodo richiestaRequest Method

La condizione Metodo di richiesta verrà soddisfatta solo quando gli asset vengono richiesti tramite il metodo di richiesta selezionato.The Request Method match condition is met only when assets are requested through the selected request method. I metodi richiesta disponibili sono:The available request methods are:

  • GETGET
  • HEADHEAD
  • POSTPOST
  • OPTIONSOPTIONS
  • PUTPUT
  • DELETEDELETE
  • TRACETRACE
  • CONNECTCONNECT

Informazioni chiave:Key information:

  • Per impostazione predefinita, solo il metodo di richiesta GET può generare contenuto memorizzato nella cache nella rete.By default, only the GET request method can generate cached content on the network. Tutti gli altri metodi di richiesta vengono elaborati tramite la rete.All other request methods are proxied through the network.
  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:
    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Torna all'inizioBack to top



Schema richiestaRequest Scheme

La condizione Request Scheme (Schema di richiesta) verrà soddisfatta solo quando gli asset vengono richiesti tramite il protocollo selezionato.The Request Scheme match condition is met only when assets are requested through the selected protocol. I protocolli disponibili sono i seguenti:The available protocols are:

  • HTTPHTTP
  • HTTPSHTTPS

Informazioni chiave:Key information:

  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:
    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Torna all'inizioBack to top



Directory percorso URLURL Path Directory

Identifica una richiesta tramite il percorso relativo, che esclude il nome file dell'asset richiesto.Identifies a request by its relative path, which excludes the file name of the requested asset.

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza.The Matches/Does Not Match option determines the conditions under which the URL Path Directory match condition is met.

  • Matches (Corrisponde): specifica che la richiesta deve contenere un percorso URL relativo, escluso il nome file, che corrisponda al modello di URL specificato.Matches: Requires the request to contain a relative URL path, excluding the file name, that matches the specified URL pattern.
  • Does Not Match (Non corrisponde): specifica che la richiesta deve contenere un percorso URL relativo, escluso il nome file, che non corrisponda al modello di URL specificato.Does Not Match: Requires the request to contain a relative URL path, excluding file name, that does not match the specified URL pattern.

Informazioni chiave:Key information:

  • Usare l'opzione Relative to (Relativo a) per specificare se il confronto degli URL debba iniziare prima o dopo il punto di accesso al contenuto.Use the Relative to option to specify whether the URL comparison starts before or after the content access point. Il punto di accesso al contenuto è la parte del percorso visualizzata tra il nome host della rete CDN Verizon e il percorso relativo dell'asset richiesto, ad esempio /800001/CustomerOrigin.The content access point is the portion of the path that appears between the Verizon CDN hostname and the relative path to the requested asset (for example, /800001/CustomerOrigin). Identifica una posizione in base al tipo di server, ad esempio rete CDN o origine del client, e il numero di account del cliente.It identifies a location by server type (for example, CDN or customer origin) and your customer account number.

    Per l'opzione Relative to (Relativo a) sono disponibili i valori seguenti:The following values are available for the Relative to option:

    • Radice: indica che il punto di confronto degli URL deve iniziare dopo il nome host della rete CDN.Root: Indicates that the URL comparison point begins directly after the CDN hostname.

      Ad esempio: http://wpc.0001.<dominio>/800001/myorigin/cartella/index.htmFor example: http://wpc.0001.<domain>/800001/myorigin/myfolder/index.htm

    • Origine: indica che il punto di confronto degli URL deve iniziare dopo il punto di accesso al contenuto, ad esempio /000001 o /800001/myorigin.Origin: Indicates that the URL comparison point begins after the content access point (for example, /000001 or /800001/myorigin). Poiché per impostazione predefinita l'URL CNAME *.azureedge.net viene creato relativamente alla directory di origine nel nome host della rete CDN Verizon, gli utenti della rete CDN di Azure devono usare il valore Origine.Because the *.azureedge.net CNAME is created relative to the origin directory on the Verizon CDN hostname by default, Azure CDN users should use the Origin value.

      Ad esempio: https://<endpoint>.azureedge.net/cartella/index.htmFor example: https://<endpoint>.azureedge.net/myfolder/index.htm

      Questo URL punta a questo nome host della rete CDN Verizon: http://wpc.0001.<dominio>/800001/myorigin/cartella/index.htmThis URL points to the following Verizon CDN hostname: http://wpc.0001.<domain>/800001/myorigin/myfolder/index.htm

  • Un URL CNAME perimetrale viene riscritto in un URL della rete CDN prima del confronto degli URL.An edge CNAME URL is rewritten to a CDN URL prior to the URL comparison.

    Ad esempio, entrambi gli URL seguenti puntano allo stesso asset e di conseguenza hanno lo stesso percorso URL.For example, both of the following URLs point to the same asset and therefore have the same URL path.

    • URL della rete CDN: http://wpc.0001.<dominio>/800001/CustomerOrigin/path/asset.htmCDN URL: http://wpc.0001.<domain>/800001/CustomerOrigin/path/asset.htm

    • URL CNAME perimetrale: http://<endpoint>.azureedge.net/path/asset.htmEdge CNAME URL: http://<endpoint>.azureedge.net/path/asset.htm

      Informazioni aggiuntive:Additional information:

    • Dominio personalizzato: https://my.domain.com/path/asset.htmCustom domain: https://my.domain.com/path/asset.htm

    • Percorso URL (relativo alla radice): /800001/CustomerOrigin/path/URL path (relative to root): /800001/CustomerOrigin/path/

    • Percorso URL (relativo all'origine): /path/URL path (relative to origin): /path/

  • La parte dell'URL usata per il confronto degli URL termina appena prima del nome file dell'asset richiesto.The portion of the URL that is used for the URL comparison ends just before the file name of the requested asset. Una barra finale è l'ultimo carattere in questo tipo di percorso.A trailing forward slash is the last character in this type of path.

  • Sostituire tutti gli spazi nel modello di percorso URL con "%20".Replace any spaces in the URL path pattern with "%20."

  • Ogni modello di percorso URL può contenere uno o più asterischi (*), in cui ogni asterisco corrisponde a una sequenza di uno o più caratteri.Each URL path pattern can contain one or more asterisks (*), where each asterisk matches a sequence of one or more characters.

  • Specificare più percorsi URL nel modello delimitandoli con uno spazio singolo.Specify multiple URL paths in the pattern by delimiting each one with a single space.

    Ad esempio: */sales/ */marketing/For example: */sales/ */marketing/

  • Per specificare un percorso URL è possibile usare caratteri jolly.A URL path specification can take advantage of wildcard values.

  • Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per determinare se effettuare un controllo tenendo conto o meno della distinzione tra maiuscole e minuscole.Use the Ignore Case option to control whether a case-sensitive comparison is performed.

Torna all'inizioBack to top



Estensione percorso URLURL Path Extension

Identifica le richieste in base all'estensione di file dell'asset richiesto.Identifies requests by the file extension of the requested asset.

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza.The Matches/Does Not Match option determines the conditions under which the URL Path Extension match condition is met.

  • Matches (Corrisponde): specifica che l'URL della richiesta deve contenere un'estensione di file che corrisponda esattamente al modello specificato.Matches: Requires the URL of the request to contain a file extension that exactly matches the specified pattern.

    Ad esempio, se si specifica "htm", gli asset "htm" soddisfano la condizione, ma non gli asset "html".For example, if you specify "htm", "htm" assets are matched, but not "html" assets.

  • Does Not Match (Non corrisponde): specifica che l'URL della richiesta deve contenere un'estensione di file che non corrisponda al modello specificato.Does Not Match: Requires the URL request to contain a file extension that does not match the specified pattern.

Informazioni chiave:Key information:

  • Specificare le estensioni per la corrispondenza nella casella Valore.Specify the file extensions to match in the Value box. Non includere un punto iniziale. Ad esempio, usare htm invece di .htm.Do not include a leading period; for example, use htm instead of .htm.

  • Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per determinare se effettuare un controllo tenendo conto o meno della distinzione tra maiuscole e minuscole.Use the Ignore Case option to control whether a case-sensitive comparison is performed.

  • Specificare più estensioni delimitandole con uno spazio singolo.Specify multiple file extensions by delimiting each extension with a single space.

    Ad esempio: htm htmlFor example: htm html

  • Ad esempio, se si specifica "htm", gli asset "htm" soddisfano la condizione, ma non gli asset "html".For example, specifying "htm" matches "htm" assets, but not "html" assets.

Scenario di esempioSample Scenario

La configurazione di esempio seguente presuppone che questa condizione di corrispondenza venga soddisfatta quando una richiesta corrisponde a una delle estensioni specificate.The following sample configuration assumes that this match condition is met when a request matches one of the specified extensions.

Valori specificati: asp aspx php htmlValue specification: asp aspx php html

Questa condizione di corrispondenza verrà soddisfatta quando vengono trovati URL che terminano con le estensioni seguenti:This match condition is met when it finds URLs that end with the following extensions:

  • .asp.asp
  • aspx.aspx
  • .php.php
  • .html.html

Torna all'inizioBack to top



Nome file percorso URLURL Path Filename

Identifica le richieste in base al nome file dell'asset richiesto.Identifies requests by the file name of the requested asset. Ai fini di questa condizione di corrispondenza, un nome file è costituito dal nome dell'asset richiesto, da un punto e dall'estensione del file, ad esempio index.html.For the purposes of this match condition, a file name consists of the name of the requested asset, a period, and the file extension (for example, index.html).

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza.The Matches/Does Not Match option determines the conditions under which the URL Path Filename match condition is met.

  • Matches (Corrisponde): specifica che la richiesta deve contenere un nome file nel rispettivo percorso URL che corrisponda al modello specificato.Matches: Requires the request to contain a file name in its URL path that matches the specified pattern.
  • Does Not Match (Non corrisponde): specifica che la richiesta deve contenere un nome file nel rispettivo percorso URL che non corrisponda al modello specificato.Does Not Match: Requires the request to contain a file name in its URL path that does not match the specified pattern.

Informazioni chiave:Key information:

  • Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per determinare se effettuare un controllo tenendo conto o meno della distinzione tra maiuscole e minuscole.Use the Ignore Case option to control whether a case-sensitive comparison is performed.

  • Per specificare più estensioni, separarle con uno spazio singolo.To specify multiple file extensions, separate each extension with a single space.

    Ad esempio: index.htm index.htmlFor example: index.htm index.html

  • Sostituire gli spazi nei nomi file con "%20".Replace spaces in a file name value with "%20."

  • Un nome file può usare caratteri jolly.A file name value can take advantage of wildcard values. Ad esempio, ogni modello di nome file può contenere uno o più asterischi (*), in cui ogni asterisco corrisponde a una sequenza di uno o più caratteri.For example, each file name pattern can consist of one or more asterisks (*), where each asterisk matches a sequence of one or more characters.

  • Se non vengono specificati caratteri jolly, solo una corrispondenza esatta potrà soddisfare questa condizione di corrispondenza.If wildcard characters are not specified, then only an exact match will satisfy this match condition.

    Ad esempio, se si specifica "presentazione.ppt", un asset denominato "presentazione.ppt" soddisferà la condizione, ma non uno denominato "presentazione.pptx".For example, specifying "presentation.ppt" matches an asset named "presentation.ppt," but not one named "presentation.pptx."

Torna all'inizioBack to top



Valore letterale percorso URLURL Path Literal

Confronta il percorso URL di una richiesta, incluso il nome file, con il valore specificato.Compares a request's URL path, including file name, to the specified value.

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza.The Matches/Does Not Match option determines the conditions under which the URL Path Literal match condition is met.

  • Matches (Corrisponde): specifica che la richiesta deve contenere un percorso URL che corrisponda al modello specificato.Matches: Requires the request to contain a URL path that matches the specified pattern.
  • Does Not Match (Non corrisponde): specifica che la richiesta deve contenere un percorso URL che non corrisponda al modello specificato.Does Not Match: Requires the request to contain a URL path that does not match the specified pattern.

Informazioni chiave:Key information:

  • Usare l'opzione Relative to (Relativo a) per specificare se il punto di confronto degli URL debba iniziare prima o dopo il punto di accesso al contenuto.Use the Relative to option to specify whether the URL comparison point begins before or after the content access point.

    Per l'opzione Relative to (Relativo a) sono disponibili i valori seguenti:The following values are available for the Relative to option:

    • Radice: indica che il punto di confronto degli URL deve iniziare dopo il nome host della rete CDN.Root: Indicates that the URL comparison point begins directly after the CDN hostname.

      Ad esempio: http://wpc.0001.<dominio>/800001/myorigin/cartella/index.htmFor example: http://wpc.0001.<domain>/800001/myorigin/myfolder/index.htm

    • Origine: indica che il punto di confronto degli URL deve iniziare dopo il punto di accesso al contenuto, ad esempio /000001 o /800001/myorigin.Origin: Indicates that the URL comparison point begins after the content access point (for example, /000001 or /800001/myorigin). Poiché per impostazione predefinita l'URL CNAME *.azureedge.net viene creato relativamente alla directory di origine nel nome host della rete CDN Verizon, gli utenti della rete CDN di Azure devono usare il valore Origine.Because the *.azureedge.net CNAME is created relative to the origin directory on the Verizon CDN hostname by default, Azure CDN users should use the Origin value.

      Ad esempio: https://<endpoint>.azureedge.net/cartella/index.htmFor example: https://<endpoint>.azureedge.net/myfolder/index.htm

      Questo URL punta a questo nome host della rete CDN Verizon: http://wpc.0001.<dominio>/800001/myorigin/cartella/index.htmThis URL points to the following Verizon CDN hostname: http://wpc.0001.<domain>/800001/myorigin/myfolder/index.htm

  • Un URL CNAME perimetrale viene riscritto in un URL della rete CDN prima del confronto degli URL.An edge CNAME URL is rewritten to a CDN URL prior to a URL comparison.

    Ad esempio, entrambi gli URL seguenti puntano allo stesso asset e di conseguenza hanno lo stesso percorso URL:For example, both of the following URLs point to the same asset and therefore have the same URL path:

    • URL della rete CDN: http://wpc.0001.<dominio>/800001/CustomerOrigin/path/asset.htmCDN URL: http://wpc.0001.<domain>/800001/CustomerOrigin/path/asset.htm
    • URL CNAME perimetrale: http://<endpoint>.azureedge.net/path/asset.htmEdge CNAME URL: http://<endpoint>.azureedge.net/path/asset.htm

      Informazioni aggiuntive:Additional information:

    • Percorso URL (relativo alla radice): /800001/CustomerOrigin/path/asset.htmURL path (relative to root): /800001/CustomerOrigin/path/asset.htm

    • Percorso URL (relativo all'origine): /path/asset.htmURL path (relative to origin): /path/asset.htm

  • Le stringhe di query nell'URL vengono ignorate.Query strings in the URL are ignored.

  • Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per determinare se effettuare un controllo tenendo conto o meno della distinzione tra maiuscole e minuscole.Use the Ignore Case option to control whether a case-sensitive comparison is performed.
  • Il valore specificato per questa condizione di corrispondenza viene confrontato al percorso relativo della richiesta esatta eseguita dal client.The value specified for this match condition is compared against the relative path of the exact request made by the client.

  • Per trovare la corrispondenza di tutte le richieste effettuate in una directory particolare, usare la condizione di corrispondenza URL Path Directory (Directory percorso URL) o URL Path Wildcard (Carattere jolly percorso URL).To match all requests made to a particular directory, use the URL Path Directory or the URL Path Wildcard match condition.

Torna all'inizioBack to top



Espressione regolare percorso URLURL Path Regex

Confronta il percorso URL di una richiesta con l'espressione regolare specificata.Compares a request's URL path to the specified regular expression.

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza.The Matches/Does Not Match option determines the conditions under which the URL Path Regex match condition is met.

  • Matches (Corrisponde): specifica che la richiesta deve contenere un percorso URL che corrisponda all'espressione regolare specificata.Matches: Requires the request to contain a URL path that matches the specified regular expression.
  • Does Not Match (Non corrisponde): specifica che la richiesta deve contenere un percorso URL che non corrisponda all'espressione regolare specificata.Does Not Match: Requires the request to contain a URL path that does not match the specified regular expression.

Informazioni chiave:Key information:

  • Un URL CNAME perimetrale viene riscritto in un URL della rete CDN prima del confronto degli URL.An edge CNAME URL is rewritten to a CDN URL prior to URL comparison.

    Ad esempio, entrambi gli URL puntano allo stesso asset e di conseguenza hanno lo stesso percorso URL.For example, both URLs point to the same asset and therefore have the same URL path.

    • URL della rete CDN: http://wpc.0001.<dominio>/800001/CustomerOrigin/path/asset.htmCDN URL: http://wpc.0001.<domain>/800001/CustomerOrigin/path/asset.htm

    • URL CNAME perimetrale: http://my.domain.com/path/asset.htmEdge CNAME URL: http://my.domain.com/path/asset.htm

      Informazioni aggiuntive:Additional information:

    • Percorso URL: /800001/CustomerOrigin/path/asset.htmURL path: /800001/CustomerOrigin/path/asset.htm

  • Le stringhe di query nell'URL vengono ignorate.Query strings in the URL are ignored.

  • Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per determinare se effettuare un controllo tenendo conto o meno della distinzione tra maiuscole e minuscole.Use the Ignore Case option to control whether a case-sensitive comparison is performed.

  • Gli spazi nel percorso URL devono essere sostituiti con "%20".Spaces in the URL path should be replaced with "%20."

Torna all'inizioBack to top



Carattere jolly percorso URLURL Path Wildcard

Confronta il percorso URL relativo di una richiesta con il modello con caratteri jolly specificato.Compares a request's relative URL path to the specified wildcard pattern.

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza.The Matches/Does Not Match option determines the conditions under which the URL Path Wildcard match condition is met.

  • Matches (Corrisponde): specifica che la richiesta deve contenere un percorso URL che corrisponda al modello con caratteri jolly specificato.Matches: Requires the request to contain a URL path that matches the specified wildcard pattern.
  • Does Not Match (Non corrisponde): specifica che la richiesta deve contenere un percorso URL che non corrisponda al modello con caratteri jolly specificato.Does Not Match: Requires the request to contain a URL path that does not match the specified wildcard pattern.

Informazioni chiave:Key information:

  • Opzione Relative to (Relativo a): questa opzione determina se il punto di confronto degli URL deve iniziare prima o dopo il punto di accesso al contenuto.Relative to option: This option determines whether the URL comparison point begins before or after the content access point.

    L'opzione può avere i valori seguenti:This option can have the following values:

    • Radice: indica che il punto di confronto degli URL deve iniziare dopo il nome host della rete CDN.Root: Indicates that the URL comparison point begins directly after the CDN hostname.

      Ad esempio: http://wpc.0001.<dominio>/800001/myorigin/cartella/index.htmFor example: http://wpc.0001.<domain>/800001/myorigin/myfolder/index.htm

    • Origine: indica che il punto di confronto degli URL deve iniziare dopo il punto di accesso al contenuto, ad esempio /000001 o /800001/myorigin.Origin: Indicates that the URL comparison point begins after the content access point (for example, /000001 or /800001/myorigin). Poiché per impostazione predefinita l'URL CNAME *.azureedge.net viene creato relativamente alla directory di origine nel nome host della rete CDN Verizon, gli utenti della rete CDN di Azure devono usare il valore Origine.Because the *.azureedge.net CNAME is created relative to the origin directory on the Verizon CDN hostname by default, Azure CDN users should use the Origin value.

      Ad esempio: https://<endpoint>.azureedge.net/cartella/index.htmFor example: https://<endpoint>.azureedge.net/myfolder/index.htm

      Questo URL punta a questo nome host della rete CDN Verizon: http://wpc.0001.<dominio>/800001/myorigin/cartella/index.htmThis URL points to the following Verizon CDN hostname: http://wpc.0001.<domain>/800001/myorigin/myfolder/index.htm

  • Un URL CNAME perimetrale viene riscritto in un URL della rete CDN prima del confronto degli URL.An edge CNAME URL is rewritten to a CDN URL prior to URL comparison.

    Ad esempio, entrambi gli URL seguenti puntano allo stesso asset e di conseguenza hanno lo stesso percorso URL:For example, both of the following URLs point to the same asset and therefore have the same URL path:

    • URL della rete CDN: http://wpc.0001.<dominio>/800001/CustomerOrigin/path/asset.htmCDN URL: http://wpc.0001.<domain>/800001/CustomerOrigin/path/asset.htm
    • URL CNAME perimetrale: http://<endpoint>.azureedge.net/path/asset.htmEdge CNAME URL: http://<endpoint>.azureedge.net/path/asset.htm

      Informazioni aggiuntive:Additional information:

    • Percorso URL (relativo alla radice): /800001/CustomerOrigin/path/asset.htmURL path (relative to root): /800001/CustomerOrigin/path/asset.htm

    • Percorso URL (relativo all'origine): /path/asset.htmURL path (relative to origin): /path/asset.htm

  • Specificare più percorsi URL delimitandoli con uno spazio singolo.Specify multiple URL paths by delimiting each one with a single space.

    Ad esempio: /marketing/asset.* /sales/.htmFor example: /marketing/asset. /sales/*.htm

  • Le stringhe di query nell'URL vengono ignorate.Query strings in the URL are ignored.

  • Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per determinare se effettuare un controllo tenendo conto o meno della distinzione tra maiuscole e minuscole.Use the Ignore Case option to control whether a case-sensitive comparison is performed.

  • Sostituire gli spazi nel percorso URL con "%20".Replace spaces in the URL path with "%20."

  • Il valore specificato in un percorso URL può usare caratteri jolly.The value specified for a URL path can take advantage of wildcard values. Ogni modello di percorso URL può contenere uno o più asterischi (*), in cui ogni asterisco può corrispondere a una sequenza di uno o più caratteri.Each URL path pattern can contain one or more asterisks (*), where each asterisk can match a sequence of one or more characters.

Scenari di esempioSample Scenarios

Le configurazioni di esempio nella tabella seguente presuppongono che questa condizione di corrispondenza venga soddisfatta quando una richiesta corrisponde al modello URL specificato:The sample configurations in the following table assume that this match condition is met when a request matches the specified URL pattern:

ValoreValue Relative to (Relativo a)Relative to RisultatoResult
*/test.html */test.php*/test.html */test.php Radice o OrigineRoot or Origin Le richieste di asset denominati "test.html" o "test.php" in qualsiasi cartella soddisfano la corrispondenza a questo modello.This pattern is matched by requests for assets named "test.html" or "test.php" in any folder.
/80ABCD/origin/text/*/80ABCD/origin/text/* RadiceRoot L'asset richiesto corrisponde a questo modello quando soddisfa i criteri seguenti:This pattern is matched when the requested asset meets the following criteria:
- Si trova in un'origine cliente denominata "origin".- It must reside on a customer origin called "origin."
- Il percorso relativo inizia con una cartella denominata "text".- The relative path must start with a folder called "text." Questo significa che l'asset richiesto può trovarsi nella cartella "text" o in una delle sottocartelle ricorsive.That is, the requested asset can either reside in the "text" folder or one of its recursive subfolders.
/css/ /js//css/ /js/ Radice o OrigineRoot or Origin Tutti gli URL CNAME perimetrali che contengono una cartella css o js soddisfano la corrispondenza a questo modello.This pattern is matched by all CDN or edge CNAME URLs that contain a css or js folder.
*.jpg *.gif *.png*.jpg *.gif *.png Radice o OrigineRoot or Origin Tutti gli URL CNAME perimetrali o di rete CDN che terminano con .jpg, .gif o .png. soddisfano la corrispondenza a questo modello.This pattern is matched by all CDN or edge CNAME URLs ending with .jpg, .gif, or .png. Un metodo alternativo per specificare questo modello è la condizione di corrispondenza URL Path Extension (Estensione percorso URL).An alternative way to specify this pattern is with the URL Path Extension match condition.
/images/* /media/*/images/* /media/* OrigineOrigin Gli URL CNAME perimetrali o di rete CDN il cui percorso relativo inizia con una cartella "images" o "media" soddisfano la corrispondenza a questo modello.This pattern is matched by CDN or edge CNAME URLs whose relative path starts with an "images" or "media" folder.
- URL della rete CDN: http://wpc.0001.<dominio>/800001/myorigin/images/sales/event1.png- CDN URL: http://wpc.0001.<domain>/800001/myorigin/images/sales/event1.png
- URL CNAME perimetrale di esempio: http://cdn.mydomain.com/images/sales/event1.png- Sample edge CNAME URL: http://cdn.mydomain.com/images/sales/event1.png

Torna all'inizioBack to top



Valore letterale query URLURL Query Literal

Confronta la stringa di query di una richiesta con il valore specificato.Compares a request's query string to the specified value.

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza.The Matches/Does Not Match option determines the conditions under which the URL Query Literal match condition is met.

  • Matches (Corrisponde): specifica che la richiesta deve contenere una stringa di query URL che corrisponda alla stringa di query specificata.Matches: Requires the request to contain a URL query string that matches the specified query string.
  • Does Not Match (Non corrisponde): specifica che la richiesta deve contenere una stringa di query URL che non corrisponda alla stringa di query specificata.Does Not Match: Requires the request to contain a URL query string that does not match the specified query string.

Informazioni chiave:Key information:

  • Solo le corrispondenze esatte delle stringhe di query soddisfano questa condizione di corrispondenza.Only exact query string matches satisfy this match condition.

  • Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per controllare la distinzione tra maiuscole e minuscole nei confronti delle stringhe di query.Use the Ignore Case option to control the case-sensitivity of query string comparisons.

  • Non includere un punto interrogativo iniziale (?) nel testo del valore della stringa di query.Do not include a leading question mark (?) in the query string value text.

  • Determinati caratteri richiedono la codifica URL.Certain characters require URL encoding. Usare il simbolo di percentuale per applicare la codifica URL ai caratteri seguenti:Use the percentage symbol to URL encode the following characters:

    CharacterCharacter Codifica URLURL Encoding
    SpazioSpace %20%20
    & %25%25
  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:

    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Torna all'inizioBack to top



Parametro query URLURL Query Parameter

Identifica le richieste che contengono il parametro della stringa di query specificato.Identifies requests that contain the specified query string parameter. Questo parametro è impostato su un valore che corrisponde a un modello specificato.This parameter is set to a value that matches a specified pattern. I parametri della stringa di query, ad esempio parametro=valore, nell'URL della richiesta determinano se questa condizione viene soddisfatta.Query string parameters (for example, parameter=value) in the request URL determine whether this condition is met. Questa condizione di corrispondenza identifica un parametro della stringa di query in base al nome e accetta uno o più valori per il valore del parametro.This match condition identifies a query string parameter by its name and accepts one or more values for the parameter value.

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza.The Matches/Does Not Match option determines the conditions under which the URL Query Parameter match condition is met.

  • Matches (Corrisponde): specifica che una richiesta deve contenere il parametro specificato con un valore che corrisponda ad almeno uno dei valori definiti nella condizione di corrispondenza.Matches: Requires a request to contain the specified parameter with a value that matches at least one of the values that are defined in this match condition.
  • Does Not Match (Non corrisponde): specifica che la richiesta soddisfi uno dei criteri seguenti:Does Not Match: Requires that the request meets either of the following criteria:
    • Non contiene il parametro specificato.It does not contain the specified parameter.
    • Contiene il parametro specificato, ma il valore non corrisponde ad alcuno dei valori definiti nella condizione di corrispondenza.It contains the specified parameter, but its value does not match any of the values that are defined in this match condition.

Questa condizione di corrispondenza offre un semplice metodo per specificare le combinazioni di nome/valore del parametro.This match condition provides an easy way to specify parameter name/value combinations. Per maggiore flessibilità per la corrispondenza di un parametro della stringa di query, provare a usare la condizione di corrispondenza URL Query Wildcard (Carattere jolly query URL).For more flexibility if you are matching a query string parameter, consider using the URL Query Wildcard match condition.

Informazioni chiave:Key information:

  • È possibile specificare un solo nome di parametro di query URL per istanza di questa condizione di corrispondenza.Only a single URL query parameter name can be specified per instance of this match condition.

  • Poiché i caratteri jolly non sono supportati per specificare un nome di parametro, solo le corrispondenze esatte dei nomi di parametro sono idonee per il confronto.Because wildcard values are not supported when a parameter name is specified, only exact parameter name matches are eligible for comparison.

  • I valori di parametro possono includere caratteri jolly.Parameter value(s) can include wildcard values.

    • Ogni modello di valore di parametro può contenere uno o più asterischi (*), in cui ogni asterisco può corrispondere a una sequenza di uno o più caratteri.Each parameter value pattern can consist of one or more asterisks (*), where each asterisk can match a sequence of one or more characters.
    • Determinati caratteri richiedono la codifica URL.Certain characters require URL encoding. Usare il simbolo di percentuale per applicare la codifica URL ai caratteri seguenti:Use the percentage symbol to URL encode the following characters:

      CharacterCharacter Codifica URLURL Encoding
      SpazioSpace %20%20
      & %25%25
  • Specificare più valori di parametro della stringa di query delimitandoli con uno spazio singolo.Specify multiple query string parameter values by delimiting each one with a single space. Questa condizione di corrispondenza verrà soddisfatta quando una richiesta contiene una delle combinazioni di nome/valore specificate.This match condition is met when a request contains one of the specified name/value combinations.

    • Esempio 1:Example 1:

      • Configurazione:Configuration:

        ValoreA ValoreBValueA ValueB

      • Questa configurazione corrisponde ai parametri della stringa di query seguenti:This configuration matches the following query string parameters:

        Parametro1=ValoreAParameter1=ValueA

        Parametro1=ValoreBParameter1=ValueB

    • Esempio 2Example 2:

      • Configurazione:Configuration:

        Valore%20A Valore%20BValue%20A Value%20B

      • Questa configurazione corrisponde ai parametri della stringa di query seguenti:This configuration matches the following query string parameters:

        Parametro1=Valore%20AParameter1=Value%20A

        Parametro1=Valore%20BParameter1=Value%20B

  • Questa condizione di corrispondenza verrà soddisfatta solo quando esiste una corrispondenza esatta con almeno una delle combinazioni di nome/valore della stringa di query specificate.This match condition is met only when there is an exact match to at least one of the specified query string name/value combinations.

    Ad esempio, se si usa la configurazione specificata nell'esempio precedente, la combinazione di nome/valore "Parametro1=ValoreAdd" non verrà considerata una corrispondenza.For example, if you use the configuration in the previous example, the parameter name/value combination "Parameter1=ValueAdd" would not be considered a match. Tuttavia, se si specifica uno dei valori seguenti, la corrispondenza alla combinazione di nome/valore verrà soddisfatta:However, if you specify either of the following values, it will match that name/value combination:

    • ValoreA ValoreB ValoreAddValueA ValueB ValueAdd
    • ValoreA* ValoreBValueA* ValueB
  • Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per controllare la distinzione tra maiuscole e minuscole nei confronti delle stringhe di query.Use the Ignore Case option to control the case-sensitivity of query string comparisons.

  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:

    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Scenari di esempioSample scenarios

L'esempio seguente mostra il funzionamento di questa opzione in situazioni specifiche:The following example demonstrates how this option works in specific situations:

NOMEName ValoreValue RisultatoResult
UtenteUser JoeJoe La corrispondenza a questo modello viene soddisfatta quando la stringa di query per un URL richiesto è "?user=joe".This pattern is matched when the query string for a requested URL is "?user=joe."
UtenteUser * La corrispondenza a questo modello viene soddisfatta quando la stringa di query per un URL richiesto contiene un parametro User.This pattern is matched when the query string for a requested URL contains a User parameter.
EmailEmail Joe*Joe* La corrispondenza a questo modello viene soddisfatta quando la stringa di query per un URL richiesto contiene un parametro Email che inizia con "Joe".This pattern is matched when the query string for a requested URL contains an Email parameter that starts with "Joe."

Torna all'inizioBack to top



Espressione regolare query URLURL Query Regex

Identifica le richieste che contengono il parametro della stringa di query specificato.Identifies requests that contain the specified query string parameter. Questo parametro è impostato su un valore che corrisponde a un'espressione regolare specificata.This parameter is set to a value that matches a specified regular expression.

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza.The Matches/Does Not Match option determines the conditions under which the URL Query Regex match condition is met.

  • Matches (Corrisponde): specifica che la richiesta deve contenere una stringa di query URL che corrisponda all'espressione regolare specificata.Matches: Requires the request to contain a URL query string that matches the specified regular expression.
  • Does Not Match (Non corrisponde): specifica che la richiesta deve contenere una stringa di query URL che non corrisponda all'espressione regolare specificata.Does Not Match: Requires the request to contain a URL query string that does not match the specified regular expression.

Informazioni chiave:Key information:

  • Solo le corrispondenze esatte all'espressione regolare specificata soddisfano questa condizione di corrispondenza.Only exact matches to the specified regular expression satisfy this match condition.

  • Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per controllare la distinzione tra maiuscole e minuscole nei confronti delle stringhe di query.Use the Ignore Case option to control the case-sensitivity of query string comparisons.

  • Ai fini di questa opzione, una stringa di query inizia con il primo carattere dopo il delimitatore punto interrogativo (?) per la stringa di query.For the purposes of this option, a query string starts with the first character after the question mark (?) delimiter for the query string.

  • Determinati caratteri richiedono la codifica URL.Certain characters require URL encoding. Usare il simbolo di percentuale per applicare la codifica URL ai caratteri seguenti:Use the percentage symbol to URL encode the following characters:

    CharacterCharacter Codifica URLURL Encoding ValoreValue
    SpazioSpace %20%20 %20%20
    & %25%25 %25%25

    I simboli di percentuale devono essere preceduti da un carattere di escape.Note that percentage symbols must be escaped.

  • I caratteri speciali nelle espressioni regolari devono essere preceduti da un doppio carattere di escape, ad esempio ^$.+, per includere una barra rovesciata nell'espressione regolare.Double-escape special regular expression characters (for example, ^$.+) to include a backslash in the regular expression.

    Ad esempio: For example:

    ValoreValue Interpretato comeInterpreted As
    \+ +
    \\+ \+
  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:

    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Torna all'inizioBack to top



Carattere jolly query URLURL Query Wildcard

Confronta uno o più valori specificati con la stringa di query della richiesta.Compares the specified value(s) against the request's query string.

L'opzione Matches (Corrisponde)/Does Not Match (Non corrisponde) determina le condizioni in base alle quali verrà soddisfatta questa condizione di corrispondenza.The Matches/Does Not Match option determines the conditions under which the URL Query Wildcard match condition is met.

  • Matches (Corrisponde): specifica che la richiesta deve contenere una stringa di query URL che corrisponda al carattere jolly specificato.Matches: Requires the request to contain a URL query string that matches the specified wildcard value.
  • Does Not Match (Non corrisponde): specifica che la richiesta deve contenere una stringa di query URL che non corrisponda al carattere jolly specificato.Does Not Match: Requires the request to contain a URL query string that does not match the specified wildcard value.

Informazioni chiave:Key information:

  • Ai fini di questa opzione, una stringa di query inizia con il primo carattere dopo il delimitatore punto interrogativo (?) per la stringa di query.For the purposes of this option, a query string starts with the first character after the question mark (?) delimiter for the query string.
  • I valori di parametro possono includere caratteri jolly:Parameter values can include wildcard values:

    • Ogni modello di valore di parametro può contenere uno o più asterischi (*), in cui ogni asterisco può corrispondere a una sequenza di uno o più caratteri.Each parameter value pattern can consist of one or more asterisks (*), where each asterisk can match a sequence of one or more characters.
    • Determinati caratteri richiedono la codifica URL.Certain characters require URL encoding. Usare il simbolo di percentuale per applicare la codifica URL ai caratteri seguenti:Use the percentage symbol to URL encode the following characters:

      CharacterCharacter Codifica URLURL Encoding
      SpazioSpace %20%20
      & %25%25
  • È possibile specificare più valori delimitandoli con uno spazio singolo.Specify multiple values by delimiting each one with a single space.

    Ad esempio: Parametro1=ValoreA ValoreB Parametro1=ValoreC&Parametro2=ValoreDFor example: Parameter1=ValueA ValueB Parameter1=ValueC&Parameter2=ValueD

  • Questa condizione verrà soddisfatta solo da corrispondenze esatte ad almeno uno dei modelli di stringa di query specificati.Only exact matches to at least one of the specified query string patterns satisfy this match condition.

  • Usare l'opzione Ignore Case (Ignora maiuscole/minuscole) per controllare la distinzione tra maiuscole e minuscole nei confronti delle stringhe di query.Use the Ignore Case option to control the case-sensitivity of query string comparisons.

  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa condizione di corrispondenza sia incompatibile con le funzionalità seguenti:Due to the manner in which cache settings are tracked, this match condition is incompatible with the following features:

    • Completa riempimento cacheComplete Cache Fill
    • Max-Age interno predefinitoDefault Internal Max-Age
    • Forza Max-Age internoForce Internal Max-Age
    • Ignora origine No-CacheIgnore Origin No-Cache
    • Max-Stale internoInternal Max-Stale

Scenari di esempioSample scenarios

L'esempio seguente mostra il funzionamento di questa opzione in situazioni specifiche:The following example demonstrates how this option works in specific situations:

NOMEName DESCRIZIONEDescription
user=joeuser=joe La corrispondenza a questo modello viene soddisfatta quando la stringa di query per un URL richiesto è "?user=joe".This pattern is matched when the query string for a requested URL is "?user=joe."
*user=* *optout=**user=* *optout=* La corrispondenza a questo modello viene soddisfatta quando la query URL della rete CDN contiene il parametro user o optout.This pattern is matched when the CDN URL query contains either the user or optout parameter.

Torna all'inizioBack to top


Passaggi successiviNext steps