Funzionalità del motore regole della rete CDN di AzureAzure CDN rules engine features

Questo argomento offre descrizioni dettagliate delle funzionalità disponibili per il motore regole della rete per la distribuzione di contenuti (CDN, Content Delivery Network) di Azure.This topic lists detailed descriptions of the available features for Azure Content Delivery Network (CDN) Rules Engine.

La terza parte di una regola è la funzionalità.The third part of a rule is the feature. Una funzionalità definisce il tipo di azione che verrà applicato al tipo di richiesta identificata da un set di condizioni di corrispondenza.A feature defines the type of action that will be applied to the type of request identified by a set of match conditions.

AccessoAccess

Queste funzionalità sono progettate per controllare l'accesso al contenuto.These features are designed to control access to content.

NomeName ScopoPurpose
Nega l'accessoDeny Access Determina se tutte le richieste vengono rifiutate con una risposta 403 Accesso negato.Determines whether all requests are rejected with a 403 Forbidden response.
Autenticazione tokenToken Auth Determina se l'autenticazione basata su token verrà applicata a una richiesta.Determines whether Token-Based Authentication will be applied to a request.
Codice rifiuto autenticazione tokenToken Auth Denial Code Determina il tipo di risposta che verrà restituito a un utente quando una richiesta viene rifiutata a causa dell'autenticazione basata su token.Determines the type of response that will be returned to a user when a request is denied due to Token-Based Authentication.
Maiuscole/minuscole URL autenticazione tokenToken Auth Ignore URL Case Determina se verrà applicata la distinzione tra maiuscole e minuscole nei confronti di URL eseguiti dall'autenticazione basata su token.Determines whether URL comparisons made by Token-Based Authentication will be case-sensitive.
Parametro autenticazione tokenToken Auth Parameter Determina se il parametro della stringa di query dell'autenticazione basata su token deve essere rinominato.Determines whether the Token-Based Authentication query string parameter should be renamed.

Nega l'accessoDeny Access

Scopo: determina se tutte le richieste vengono rifiutate con una risposta 403 - Accesso negato.Purpose: Determines whether all requests are rejected with a 403 Forbidden response.

ValoreValue RisultatoResult
EnabledEnabled Fa sì che tutte le richieste che soddisfano i criteri di corrispondenza vengano respinte con una risposta 403 - Accesso negato.Causes all requests that satisfy the matching criteria to be rejected with a 403 Forbidden response.
DisabledDisabled Ripristina il comportamento predefinito.Restores the default behavior. Il comportamento predefinito prevede di consentire al server di origine di determinare il tipo di risposta da restituire.The default behavior is to allow the origin server to determine the type of response that will be returned.

Comportamento predefinito: DisabledDefault Behavior: Disabled

Suggerimento

Un possibile uso di questa funzionalità è quello di associarla a una condizione di corrispondenza Request Header (Intestazione di richiesta) per bloccare l'accesso a riferimenti HTTP che usano collegamenti inline ai contenuti.One possible use for this feature is to associate it with a Request Header match condition to block access to HTTP referrers that are using inline links to your content.

Autenticazione tokenToken Auth

Scopo: determina se l'autenticazione basata su token verrà applicata a una richiesta.Purpose: Determines whether Token-Based Authentication will be applied to a request.

Se l'autenticazione basata su token è abilitata, verranno soddisfatte solo le richieste che forniscono un token crittografato e sono conformi ai requisiti specificati dal token.If Token-Based Authentication is enabled, then only requests that provide an encrypted token and comply to the requirements specified by that token will be honored.

La chiave di crittografia usata per crittografare e decrittografare i valori dei token viene determinata dalle opzioni relative alla chiave primaria e alla chiave di backup disponibili nella pagina di autenticazione del token.The encryption key that will be used to encrypt and decrypt token values is determined by the Primary Key and the Backup Key options on the Token Auth page. Tenere presente che le chiavi di crittografia sono specifiche della piattaforma.Keep in mind that encryption keys are platform-specific.

ValoreValue RisultatoResult
EnabledEnabled Protegge i contenuti richiesti con l'autenticazione basata su token.Protects the requested content with Token-Based Authentication. Verranno soddisfatte solo le richieste provenienti da client che forniscono un token valido e ne soddisfano i requisiti.Only requests from clients that provide a valid token and meet its requirements will be honored. Dall'autenticazione basata su token sono escluse le transazioni FTP.FTP transactions are excluded from Token-Based Authentication.
DisabledDisabled Ripristina il comportamento predefinito.Restores the default behavior. Il comportamento predefinito prevede di consentire alla configurazione dell'autenticazione basata su token di determinare se una richiesta deve essere protetta.The default behavior is to allow your Token-Based Authentication configuration to determine whether a request will be secured.

Comportamento predefinito: Disabled.Default Behavior: Disabled.

Codice rifiuto autenticazione tokenToken Auth Denial Code

Scopo: determina il tipo di risposta che verrà restituita a un utente quando una richiesta viene rifiutata a causa dell'autenticazione basata su token.Purpose: Determines the type of response that will be returned to a user when a request is denied due to Token-Based Authentication.

Di seguito sono elencati i codici di risposta disponibili.The available response codes are listed below.

Codice rispostaResponse Code Nome rispostaResponse Name DescrizioneDescription
301301 Spostato in modo permanenteMoved Permanently Questo codice di stato reindirizza gli utenti non autorizzati all'URL specificato nell'intestazione Location (Percorso).This status code redirects unauthorized users to the URL specified in the Location header.
302302 TrovatoFound Questo codice di stato reindirizza gli utenti non autorizzati all'URL specificato nell'intestazione Location (Percorso).This status code redirects unauthorized users to the URL specified in the Location header. Questo codice di stato costituisce il metodo standard per eseguire un'operazione di reindirizzamento.This status code is the industry standard method of performing a redirect.
307307 Reindirizzamento temporaneoTemporary Redirect Questo codice di stato reindirizza gli utenti non autorizzati all'URL specificato nell'intestazione Location (Percorso).This status code redirects unauthorized users to the URL specified in the Location header.
401401 Non autorizzataUnauthorized La combinazione di questo codice di stato con l'intestazione di risposta WWW-Authenticate consente di richiedere a un utente di eseguire l'autenticazione.Combining this status code with the WWW-Authenticate response header allows you to prompt a user for authentication.
403403 Accesso negatoForbidden Messaggio di stato standard 403 - Accesso negato che viene visualizzato quando un utente non autorizzato prova ad accedere a contenuti protetti.This is the standard 403 Forbidden status message that an unauthorized user will see when trying to access protected content.
404404 File non trovatoFile Not Found Questo codice di stato indica che il client HTTP è riuscito a comunicare con il server, ma i contenuti richiesti non sono stati trovati.This status code indicates that the HTTP client was able to communicate with the server, but the requested content was not found.

Reindirizzamento URLURL Redirection

Questa funzionalità supporta il reindirizzamento dell'URL a un URL definito dall'utente, se configurato per restituire un codice di stato 3xx.This feature supports URL redirection to a user-defined URL when it is configured to return a 3xx status code. Per specificare l'URL definito dall'utente, seguire questa procedura:This user-defined URL can be specified by performing the following steps:

  1. Selezionare un codice di risposta 3xx per la funzionalità Token Auth Denial Code (Codice rifiuto autenticazione token).Select a 3xx response code for the Token Auth Denial Code feature.
  2. Per l'opzione Optional Header Name (Nome intestazione facoltativo) selezionare "Location".Select "Location" from the Optional Header Name option.
  3. Impostare l'opzione Optional Header Value (Valore intestazione facoltativo) sull'URL desiderato.Set the Optional Header Value option to the desired URL.

Se un URL non è definito per un codice di stato 3xx, all'utente verrà restituita la pagina di risposta standard per un codice di stato 3xx.If a URL is not defined for a 3xx status code, then the standard response page for a 3xx status code will be returned to the user.

Il reindirizzamento degli URL può essere usato solo per i codici di risposta 3xx.URL redirection is only applicable for 3xx response codes.

L'opzione Optional Header Value (Valore intestazione facoltativo) supporta caratteri alfanumerici, virgolette e spazi.The Optional Header Value option supports alphanumeric characters, quotation marks, and spaces.

AutenticazioneAuthentication

Questa funzionalità prevede la possibilità di includere l'intestazione WWW-Authenticate quando si risponde a una richiesta non autorizzata di contenuti protetti con l'autenticazione basata su token.This feature supports the capability to include the WWW-Authenticate header when responding to an unauthorized request for content protected by Token-Based Authentication. Se nella configurazione l'intestazione WWW-Authenticate è stata impostata su "basic", all'utente non autorizzato verrà richiesto di specificare le credenziali dell'account.If the WWW-Authenticate header has been set to "basic" in your configuration, then the unauthorized user will be prompted for account credentials.

La configurazione precedente può essere ottenuta seguendo questa procedura:The above configuration can be achieved by performing the following steps:

  1. Selezionare "401" come codice di risposta per la funzionalità Token Auth Denial Code (Codice rifiuto autenticazione token).Select "401" as the response code for the Token Auth Denial Code feature.
  2. Per l'opzione Optional Header Name (Nome intestazione facoltativo) selezionare "WWW-Authenticate".Select "WWW-Authenticate" from the Optional Header Name option.
  3. Impostare l'opzione Optional Header Value (Valore intestazione facoltativo) su "basic".Set the Optional Header Value option to "basic."

L'intestazione WWW-Authenticate può essere usata solo per i codici di risposta 401.The WWW-Authenticate header is only applicable for 401 response codes.

Maiuscole/minuscole URL autenticazione tokenToken Auth Ignore URL Case

Scopo: determina se durante i confronti di URL eseguiti dall'autenticazione basata su token deve essere applicata la distinzione tra maiuscole e minuscole.Purpose: Determines whether URL comparisons made by Token-Based Authentication will be case-sensitive.

I parametri interessati da questa funzionalità sono:The parameters affected by this feature are:

  • ec_url_allowec_url_allow
  • ec_ref_allowec_ref_allow
  • ec_ref_denyec_ref_deny

I valori validi sono:Valid values are:

ValoreValue RisultatoResult
EnabledEnabled Fa sì che il server perimetrale non applichi la distinzione tra maiuscole e minuscole quando confronta gli URL in base ai parametri dell'autenticazione basata su token.Causes our edge server to ignore case when comparing URLs for Token-Based Authentication parameters.
DisabledDisabled Ripristina il comportamento predefinito.Restores the default behavior. Il comportamento predefinito prevede di applicare la distinzioni tra maiuscole e minuscole durante i confronti di URL per l'autenticazione basata su token.The default behavior is for URL comparisons for Token Authentication to be case-sensitive.

Comportamento predefinito: Disabled.Default Behavior: Disabled.

Parametro autenticazione tokenToken Auth Parameter

Scopo: determina se il parametro della stringa di query dell'autenticazione basata su token deve essere rinominato.Purpose: Determines whether the Token-Based Authentication query string parameter should be renamed.

Informazioni chiave:Key information:

  • L'opzione Valore definisce il nome del parametro della stringa di query tramite il quale è possibile specificare un token.The Value option defines the query string parameter name through which a token may be specified.
  • L'opzione Valore non può essere impostata su "ec_token".The Value option cannot be set to "ec_token."
  • Verificare che il nome definito nell'opzione Valore contenga solo caratteri URL validi.Ensure that the name defined in the Value option contains only valid URL characters.
ValoreValue RisultatoResult
EnabledEnabled L'opzione Valore definisce il nome del parametro della stringa di query tramite il quale devono essere definiti i token.The Value option defines the query string parameter name through which tokens should be defined.
DisabledDisabled Un token può essere specificato come un parametro non definito della stringa di query nell'URL della richiesta.A token may be specified as an undefined query string parameter in the request URL.

Comportamento predefinito: Disabled.Default Behavior: Disabled. Un token può essere specificato come un parametro non definito della stringa di query nell'URL della richiesta.A token may be specified as an undefined query string parameter in the request URL.

Memorizzazione nella cacheCaching

Queste funzionalità sono progettate per personalizzare come e quando il contenuto viene memorizzato nella cache.These features are designed to customize when and how content is cached.

NomeName ScopoPurpose
Parametri larghezza di bandaBandwidth Parameters Determina se i parametri di limitazione della larghezza di banda, ad esempio, ec_rate ed ec_prebuf, saranno attivi.Determines whether bandwidth throttling parameters (for example, ec_rate and ec_prebuf) will be active.
Limitazione larghezza di bandaBandwidth Throttling Limita la larghezza di banda per la risposta fornita dai server perimetrali.Throttles the bandwidth for the response provided by our edge servers.
Ignora cacheBypass Cache Determina se la richiesta può sfruttare la tecnologia di memorizzazione nella cache.Determines whether the request can leverage our caching technology.
Gestione intestazione Cache-ControlCache-Control Header Treatment Controlla la generazione delle intestazioni Cache-Control dal server perimetrale quando la funzionalità Max-Age esterna è attiva.Controls the generation of Cache-Control headers by the edge server when External Max-Age feature is active.
Stringa di query chiave cacheCache-Key Query String Determina se la chiave della cache includerà o escluderà i parametri della stringa di query associati a una richiesta.Determines whether the cache-key will include or exclude query string parameters associated with a request.
Riscrittura chiave cacheCache-Key Rewrite Riscrive la chiave della cache associata a una richiesta.Rewrites the cache-key associated with a request.
Completa riempimento cacheComplete Cache Fill Determina ciò che accade quando una richiesta determina un mancato riscontro nella cache parziale in un server perimetrale.Determines what happens when a request results in a partial cache miss on an edge server.
Comprimi tipi di fileCompress File Types Definisce i formati di file che verranno compressi nel server.Defines the file formats that will be compressed on the server.
Max-Age interno predefinitoDefault Internal Max-Age Determina l'intervallo Max-Age predefinito per la riconvalida della cache dal server perimetrale al server di origine.Determines the default max-age interval for edge server to origin server cache revalidation.
Gestione intestazione ExpiresExpires Header Treatment Controlla la generazione delle intestazioni Expires da un server perimetrale quando la funzionalità Max-Age esterna è attiva.Controls the generation of Expires headers by an edge server when the External Max-Age feature is active.
Max-Age esternoExternal Max-Age Determina l'intervallo Max-Age per la riconvalida della cache dal browser al server perimetrale.Determines the max-age interval for browser to edge server cache revalidation.
Forza Max-Age internoForce Internal Max-Age Determina l'intervallo Max-Age per la riconvalida della cache dal server perimetrale al server di origine.Determines the max-age interval for edge server to origin server cache revalidation.
Supporto H.264 (download progressivo HTTP)H.264 Support (HTTP Progressive Download) Determina i tipi di formati di file H.264 che possono essere usati per lo streaming di contenuti.Determines the types of H.264 file formats that may be used to stream content.
Rispetta richiesta No-CacheHonor No-Cache Request Determina se le richieste no-cache di un client HTTP verranno inoltrate al server di origine.Determines whether an HTTP client's no-cache requests will be forwarded to the origin server.
Ignora origine No-CacheIgnore Origin No-Cache Determina se la rete CDN ignorerà alcune direttive servite da un server di origine.Determines whether our CDN will ignore certain directives served from an origin server.
Ignora gli intervalli che non è possibile soddisfareIgnore Unsatisfiable Ranges Determina la risposta che verrà restituita ai client quando una richiesta genera un codice di stato 416 Impossibile attenersi all'intervallo richiesto.Determines the response that will be returned to clients when a request generates a 416 Requested Range Not Satisfiable status code.
Max-Stale internoInternal Max-Stale Controlla per quanto tempo dopo la normale scadenza un asset memorizzato nella cache può essere servito da un server perimetrale quando il server perimetrale non è in grado di riconvalidare l'asset memorizzato nella cache con il server di origine.Controls how long past the normal expiration time a cached asset may be served from an edge server when the edge server is unable to revalidate the cached asset with the origin server.
Condivisione cache parzialePartial Cache Sharing Determina se una richiesta può generare contenuto parzialmente memorizzato nella cache.Determines whether a request can generate partially cached content.
Preconvalida contenuto memorizzato nella cachePrevalidate Cached Content Determina se il contenuto memorizzato nella cache sarà idoneo per la riconvalida anticipata prima della scadenza della durata (TTL).Determines whether cached content will be eligible for early revalidation before its TTL expires.
Aggiorna i file della cache con zero byteRefresh Zero-Byte Cache Files Determina come viene gestita dai server perimetrali una richiesta di un client HTTP di un asset della cache con 0 byte.Determines how an HTTP client's request for a 0-byte cache asset is handled by our edge servers.
Imposta codici di stato inseribile nella cacheSet Cacheable Status Codes Definisce il set di codici di stato che possono generare contenuto memorizzato nella cache.Defines the set of status codes that can result in cached content.
Distribuzione di contenuto non aggiornato in caso di erroreStale Content Delivery on Error Determina se il contenuto scaduto memorizzato nella cache verrà distribuito quando si verifica un errore durante la riconvalida della cache o quando si recupera il contenuto richiesto dal server di origine del cliente.Determines whether expired cached content will be delivered when an error occurs during cache revalidation or when retrieving the requested content from the customer origin server.
Client non aggiornato durante la riconvalidaStale While Revalidate Migliora le prestazioni consentendo ai server perimetrali di servire un client non aggiornato al richiedente mentre avviene la riconvalida.Improves performance by allowing our edge servers to serve stale client to the requester while revalidation takes place.
CommentoComment La funzionalità Commento consente di aggiungere una nota all'interno di una regola.The Comment feature allows a note to be added within a rule.

Parametri larghezza di bandaBandwidth Parameters

Scopo: determina se i parametri di limitazione della larghezza di banda, ad esempio, ec_rate ed ec_prebuf, saranno attivi.Purpose: Determines whether bandwidth throttling parameters (for example, ec_rate and ec_prebuf) will be active.

I parametri di limitazione della larghezza di banda determinano se la velocità di trasferimento dati per una richiesta del client sarà limitata a un valore prestabilito.Bandwidth throttling parameters determine whether the data transfer rate for a client's request will be limited to a custom rate.

ValoreValue RisultatoResult
EnabledEnabled Consente ai server perimetrali di soddisfare richieste di limitazione della larghezza di banda.Allows our edge servers to honor bandwidth throttling requests.
DisabledDisabled Fa sì che i server perimetrali ignorino i parametri di limitazione della larghezza di banda.Causes our edge servers to ignore bandwidth throttling parameters. I contenuti richiesti verranno serviti normalmente, ossia senza limitazione della larghezza di banda.The requested content will be served normally (that is, without bandwidth throttling).

Comportamento predefinito: Enabled.Default Behavior: Enabled.

Limitazione larghezza di bandaBandwidth Throttling

Scopo: limita la larghezza di banda per la risposta fornita dai server perimetrali.Purpose: Throttles the bandwidth for the response provided by our edge servers.

Per impostare correttamente la limitazione della larghezza di banda è necessario che siano definite entrambe le opzioni seguenti.Both of the following options must be defined to properly set up bandwidth throttling.

OpzioneOption DescrizioneDescription
Kbytes per second (KB al secondo)Kbytes per second Impostare questa opzione sulla larghezza di banda massima (KB al secondo) che è possibile usare per inviare la risposta.Set this option to the maximum bandwidth (Kb per second) that may be used to deliver the response.
Prebuf seconds (Secondi prebuf)Prebuf seconds Impostare questa opzione sul numero di secondi di attesa da parte dei server perimetrali prima di attivare la limitazione della larghezza di banda.Set this option to the number of seconds that our edge servers will wait until throttling bandwidth. Lo scopo di questo intervallo di tempo di larghezza di banda senza restrizioni è quello di impedire a un lettore multimediale di riscontrare problemi di stuttering o buffering a causa della limitazione della larghezza di banda.The purpose of this time period of unrestricted bandwidth is to prevent a media player from experiencing stuttering or buffering issues due to bandwidth throttling.

Comportamento predefinito: Disabled.Default Behavior: Disabled.

Ignora cacheBypass Cache

Scopo: determina se la richiesta può sfruttare la tecnologia di memorizzazione nella cache.Purpose: Determines whether the request can leverage our caching technology.

ValoreValue RisultatoResult
EnabledEnabled Fa sì che tutte le richieste giungano al server di origine, anche se i contenuti sono stati precedentemente memorizzati nella cache dei server perimetrali.Causes all requests to fall through to the origin server, even if the content was previously cached on edge servers.
DisabledDisabled Fa sì che i server perimetrali memorizzino gli asset nella cache in base ai criteri della cache definiti nelle relative intestazioni di risposta.Causes edge servers to cache assets according to the cache policy defined in its response headers.

Comportamento predefinito:Default Behavior:

  • HTTP Large: DisabledHTTP Large: Disabled

Cache Control Header Treatment (Gestione intestazioni Cache-Control)Cache Control Header Treatment

Scopo: controlla la generazione delle intestazioni Cache-Control da parte del server perimetrale quando è attiva la funzionalità External Max-Age (Validità massima esterna).Purpose: Controls the generation of Cache-Control headers by the edge server when External Max-Age Feature is active.

Il modo più semplice per ottenere questo tipo di configurazione è inserire le funzionalità External Max-Age (Validità massima esterna) e Cache-Control Header Treatment (Gestione intestazioni Cache-Control) nella stessa istruzione.The easiest way to achieve this type of configuration is to place the External Max-Age and the Cache-Control Header Treatment features in the same statement.

ValoreValue RisultatoResult
OverwriteOverwrite Garantisce che vengano eseguite le azioni seguenti:Ensures that the following actions will take place:
- Sovrascrivere l'intestazione Cache-Control generata dal server di origine.- Overwrites the Cache-Control header generated by the origin server.
- Aggiungere alla risposta l'intestazione Cache-Control prodotta dalla funzionalità External Max-Age (Validità massima esterna)- Adds the Cache-Control header produced by the External Max-Age feature to the response.
Pass-throughPass Through Assicura che l'intestazione Cache-Control prodotta dalla funzionalità External Max-Age (Validità massima esterna) non venga mai aggiunta alla risposta.Ensures that the Cache-Control header produced by the External Max-Age feature is never added to the response.
Se il server di origine produce un'intestazione Cache-Control, ne verrà eseguito il pass-through all'utente finale.If the origin server produces a Cache-Control header, it will pass through to the end-user.
Se il server di origine non produce un'intestazione Cache-Control, è possibile che, a causa di questa opzione, l'intestazione della risposta non contenga un'intestazione Cache-Control.If the origin server does not produce a Cache-Control header, then this option may cause the response header to not contain a Cache-Control header.
Add if Missing (Aggiungi se mancante)Add if Missing Se un'intestazione Cache-Control non è stata ricevuta dal server di origine, questa opzione aggiunge l'intestazione Cache-Control prodotta dalla funzionalità External Max-Age (Validità massima esterna).If a Cache-Control header was not received from the origin server, then this option adds the Cache-Control header produced by the External Max-Age feature. Assicura quindi che a tutti gli asset venga assegnata un'intestazione Cache-Control.This option is useful for ensuring that all assets will be assigned a Cache-Control header.
RimuovereRemove Questa opzione assicura che con la risposta di intestazione non sia inclusa un'intestazione Cache-Control.This option ensures that a Cache-Control header is not included with the header response. Se è già stata assegnata un'intestazione Cache-Control, verrà rimossa dalla risposta di intestazione.If a Cache-Control header has already been assigned, then it will be stripped from the header response.

Comportamento predefinito: Overwrite.Default Behavior: Overwrite.

Stringa di query chiave cacheCache-Key Query String

Scopo: determina se la chiave di cache includerà o escluderà i parametri della stringa di query associati a una richiesta.Purpose: Determines whether the cache-key will include or exclude query string parameters associated with a request.

Informazioni chiave:Key information:

  • Specificare uno o più nomi di parametri della stringa di query.Specify one or more query string parameter name(s). Ogni nome di parametro deve essere delimitato da uno spazio singolo.Each parameter name should be delimited with a single space.
  • Questa funzionalità determina se nella chiave di cache i parametri della stringa di query verranno inclusi o esclusi.This feature determines whether query string parameters will be included or excluded from the cache-key. Di seguito vengono fornite informazioni aggiuntive per ogni opzione seguente.Additional information is provided for each option below.
TipoType DescrizioneDescription
IncludiInclude Indica che nella chiave di cache deve essere incluso ogni parametro specificato.Indicates that each specified parameter should be included in the cache-key. Verrà generata una chiave di cache univoca per ogni richiesta in cui sia contenuto un valore univoco per un parametro della stringa di query definito in questa funzionalità.A unique cache-key will be generated for each request that contains a unique value for a query string parameter defined in this feature.
Includi tuttoInclude All Indica che verrà creata una chiave di cache univoca per ogni richiesta a un asset contenente una stringa di query univoca.Indicates that a unique cache-key will be created for each request to an asset that includes a unique query string. Questo tipo di configurazione, in genere, non è consigliato poiché può comportare una piccola percentuale di riscontri nella cacheThis type of configuration is not typically recommended since it may lead to a small percentage of cache hits. e un conseguente aumento del carico sul server di origine, che dovrà gestire un maggior numero di richieste.This will increase the load on the origin server, since it will have to serve more requests. Questa configurazione consente di duplicare il comportamento di memorizzazione nella cache noto come "unique-cache" nella pagina di memorizzazione nella cache della stringa di query.This configuration duplicates the caching behavior known as "unique-cache" on the Query-String Caching page.
EscludiExclude Indica che verranno esclusi dalla chiave di cache solo i parametri specificati.Indicates that only the specified parameter(s) will be excluded from the cache-key. Verranno inclusi invece tutti gli altri parametri della stringa di query.All other query string parameters will be included in the cache-key.
Escludi tuttoExclude All Indica che verranno esclusi dalla chiave di cache tutti i parametri della stringa di query.Indicates that all query string parameters will be excluded from the cache-key. Questa configurazione consente di duplicare il comportamento di memorizzazione nella cache predefinito, noto come "standard-cache", nella pagina di memorizzazione nella cache della stringa di query.This configuration duplicates the default caching behavior, which is known as "standard-cache" on the Query-String Caching page.

Le funzionalità del motore regole HTTP consente di personalizzare il modo in cui viene implementata la memorizzazione nella cache della stringa di query.The power of HTTP Rules Engine allows you to customize the manner in which query string caching is implemented. È possibile specificare, ad esempio, che la memorizzazione nella cache della stringa di query può essere eseguita solo su determinate posizioni o tipi di file.For example, you can specify that query string caching only be performed on certain locations or file types.

Se nella pagina di memorizzazione nella cache della stringa di query si vuole duplicare il comportamento di memorizzazione nella cache della stringa di query noto come "no-cache", sarà necessario creare una regola contenente una condizione di corrispondenza URL Query Wildcard (Carattere jolly query URL) e una funzionalità Bypass Cache (Ignora cache).If you would like to duplicate the query string caching behavior known as "no-cache" on the Query-String Caching page, then you will need to create a rule that contains a URL Query Wildcard match condition and a Bypass Cache feature. La condizione di corrispondenza URL Query Wildcard (Carattere jolly query URL) deve essere impostata su un asterisco ().The URL Query Wildcard match condition should be set to an asterisk ().

Scenari di esempioSample Scenarios

Il seguente esempio di utilizzo per questa funzionalità fornisce un esempio di richiesta e la chiave di cache predefinita:The following sample usage for this feature provides a sample request and the default cache-key:

  • Richiesta di esempio: http://wpc.0001.<Domain>/800001/Origin/folder/asset.htm?sessionid=1234&language=EN&userid=01Sample request: http://wpc.0001.<Domain>/800001/Origin/folder/asset.htm?sessionid=1234&language=EN&userid=01
  • Chiave di cache predefinita: /800001/Origin/folder/asset.htmDefault cache-key: /800001/Origin/folder/asset.htm
IncludiInclude

Configurazione di esempio:Sample configuration:

  • Tipo: IncludiType: Include
  • Parametri: languageParameter(s): language

Questo tipo di configurazione genera la chiave di cache del parametro della stringa di query seguente:This type of configuration would generate the following query string parameter cache-key:

/800001/Origin/folder/asset.htm?language=EN
Includi tuttoInclude All

Configurazione di esempio:Sample configuration:

  • Tipo: Includi tuttoType: Include All

Questo tipo di configurazione genera la chiave di cache del parametro della stringa di query seguente:This type of configuration would generate the following query string parameter cache-key:

/800001/Origin/folder/asset.htm?sessionid=1234&language=EN&userid=01
EscludiExclude

Configurazione di esempio:Sample configuration:

  • Tipo: EscludiType: Exclude
  • Parametri: sessionid useridParameter(s): sessionid userid

Questo tipo di configurazione genera la chiave di cache del parametro della stringa di query seguente:This type of configuration would generate the following query string parameter cache-key:

/800001/Origin/folder/asset.htm?language=EN
Escludi tuttoExclude All

Configurazione di esempio:Sample configuration:

  • Tipo: Escludi tuttoType: Exclude All

Questo tipo di configurazione genera la chiave di cache del parametro della stringa di query seguente:This type of configuration would generate the following query string parameter cache-key:

/800001/Origin/folder/asset.htm

Riscrittura chiave cacheCache-Key Rewrite

Scopo: riscrive la chiave di cache associata a una richiesta.Purpose: Rewrites the cache-key associated with a request.

Una chiave di cache è il percorso relativo che identifica un asset ai fini della memorizzazione nella cache.A cache-key is the relative path that identifies an asset for the purposes of caching. In altre parole, i server cercano una versione memorizzata nella cache di un asset in base al relativo percorso, così come definito dalla chiave di cache.In other words, our servers will check for a cached version of an asset according to its path as defined by its cache-key.

Per configurare questa funzionalità è necessario definire entrambe le opzioni seguenti:Configure this feature by defining both of the following options:

OpzioneOption DescrizioneDescription
Percorso originaleOriginal Path Consente di definire il percorso relativo dei tipi di richieste di cui verrà riscritta la chiave di cache.Define the relative path to the types of requests whose cache-key will be rewritten. Un percorso relativo può essere definito selezionando un percorso di origine di base e quindi definendo un modello di espressione regolare.A relative path can be defined by selecting a base origin path and then defining a regular expression pattern.
Nuovo percorsoNew Path Consente di definire il percorso relativo della nuova chiave di cache.Define the relative path for the new cache-key. Un percorso relativo può essere definito selezionando un percorso di origine di base e quindi definendo un modello di espressione regolare.A relative path can be defined by selecting a base origin path and then defining a regular expression pattern. Questo percorso relativo può essere creato dinamicamente tramite l'uso di variabili HTTPThis relative path can be dynamically constructed through the use of HTTP variables

Comportamento predefinito: la chiave di cache di una richiesta è determinata dall'URI della richiesta.Default Behavior: A request's cache-key is determined by the request URI.

Completa riempimento cacheComplete Cache Fill

Scopo: determina ciò che accade quando una richiesta genera un mancato riscontro nella cache parziale in un server perimetrale.Purpose: Determines what happens when a request results in a partial cache miss on an edge server.

Un mancato riscontro nella cache parziale descrive lo stato della cache relativo a un asset non completamente scaricato in un server perimetrale.A partial cache miss describes the cache status for an asset that was not completely downloaded to an edge server. Se un asset è stato solo parzialmente memorizzato nella cache di un server perimetrale, la richiesta successiva dell'asset verrà nuovamente inoltrata al server di origine.If an asset is only partially cached on an edge server, then the next request for that asset will be forwarded again to the origin server.

In genere, un mancato riscontro nella cache parziale si verifica dopo che un utente interrompe un download o in caso di asset che vengono richiesti esclusivamente tramite richieste di intervallo HTTP.A partial cache miss typically occurs after a user aborts a download or for assets that are solely requested using HTTP range requests. Questa funzionalità è particolarmente utile per gli asset di grandi dimensioni che gli utenti in genere non scaricano per intero, ad esempio i video.This feature is most useful for large assets where users will not typically download them from start to finish (for example, videos). Ecco perché questa funzionalità è abilitata per impostazione predefinita nella piattaforma HTTP LargeAs a result, this feature is enabled by default on the HTTP Large platform. ed è disabilitata in tutte le altre piattaforme.It is disabled on all other platforms.

È consigliabile lasciare la configurazione predefinita per la piattaforma HTTP Large, poiché riduce il carico sul server di origine del cliente e aumenta la velocità con cui i clienti possono scaricare i contenuti.It is recommended to leave the default configuration for the HTTP Large platform, since it will reduce the load on your customer origin server and increase the speed at which your customers download your content.

In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa funzionalità non possa essere associata alle seguenti condizioni di corrispondenza: Edge, Cname, Request Header Literal (Valore letterale intestazione richiesta), Request Header Wildcard (Carattere jolly intestazione richiesta), URL Query Literal (Valore letterale query URL) e URL Query Wildcard (Carattere jolly query URL).Due to the manner in which cache settings are tracked, this feature cannot be associated with the following Match conditions: Edge Cname, Request Header Literal, Request Header Wildcard, URL Query Literal, and URL Query Wildcard.

ValoreValue RisultatoResult
EnabledEnabled Ripristina il comportamento predefinito.Restores the default behavior. Il comportamento predefinito prevede di obbligare il server periferico a inizializzare il recupero in background dell'asset dal server di origine.The default behavior is to force the edge server to initiate a background fetch of the asset from the origin server. Al termine di questa operazione, l'asset si trova nella cache locale del server perimetrale.After which, the asset will be in the edge server's local cache.
DisabledDisabled Impedisce a un server perimetrale di eseguire il recupero in background dell'asset.Prevents an edge server from performing a background fetch for the asset. In questo modo, alla successiva richiesta dell'asset dalla stessa area, il server perimetrale ne eseguirà la richiesta dal server di origine del cliente.This means that the next request for that asset from that region will cause an edge server to request it from the customer origin server.

Comportamento predefinito: Enabled.Default Behavior: Enabled.

Comprimi tipi di fileCompress File Types

Scopo: definisce i formati di file che verranno compressi nel server.Purpose: Defines the file formats that will be compressed on the server.

Un formato di file può essere specificato usando il rispettivo tipo di elemento multimediale Internet, ad esempio Content-Type.A file format can be specified using its Internet media type (for example, Content-Type). Il tipo di elemento multimediale Internet è costituito dai metadati indipendenti dalla piattaforma che consentono ai server di identificare il formato di file di un asset specifico.Internet media type is platform-independent metadata that allows our servers to identify the file format of a particular asset. Di seguito è riportato un elenco dei tipi di elementi multimediali Internet.A list of common Internet media types is provided below.

Tipo di elemento multimediale InternetInternet Media Type DescrizioneDescription
text/plaintext/plain File di testo normalePlain text files
text/htmltext/html File HTMLHTML files
text/csstext/css Fogli di stile CSSCascading Style Sheets (CSS)
application/x-javascriptapplication/x-javascript JavaScriptJavascript
application/javascriptapplication/javascript JavaScriptJavascript

Informazioni chiave:Key information:

  • È possibile specificare più tipi di elementi multimediali Internet delimitandoli ciascuno con uno spazio singolo.Specify multiple Internet media types by delimiting each one with a single space.
  • Questa funzionalità comprimerà solo asset con dimensioni inferiori a 1 MB.This feature will only compress assets whose size is less than 1 MB. Gli asset con dimensioni superiori non verranno compressi dai server.Larger assets will not be compressed by our servers.
  • Alcuni tipi di contenuti, come le immagini e i contenuti multimediali audio e video, ad esempio JPG, MP3, MP4 e così via, sono già compressi.Certain types of content, such as images, video, and audio media assets (for example, JPG, MP3, MP4, etc.), are already compressed. Un ulteriore compressione di questi tipi di asset, pertanto, non ne diminuirebbe in modo significativo le dimensioni.Additional compression on these types of assets will not significantly diminish file size. È consigliabile quindi non abilitare la compressione su questi tipi di asset.Therefore, it is recommended that you do not enable compression on these types of assets.
  • Non sono supportati i caratteri jolly come gli asterischi.Wildcard characters, such as asterisks, are not supported.
  • Prima di aggiungere questa funzionalità a una regola, assicurarsi di impostare l'opzione di compressione disabilitata nella pagina di compressione relativa alla piattaforma su cui verrà applicata la regola.Before you add this feature to a rule, ensure that you set the Compression Disabled option on the Compression page for the platform to which this rule will be applied.

Max-Age interno predefinitoDefault Internal Max-Age

Scopo: determina l'intervallo di validità massima predefinita per la riconvalida della cache dal server perimetrale al server di origine.Purpose: Determines the default max-age interval for edge server to origin server cache revalidation. In altre parole, la quantità di tempo che deve trascorrere prima che un server perimetrale verifichi se un asset memorizzato nella cache corrisponde all'asset archiviato sul server di origine.In other words, the amount of time that will pass before an edge server will check whether a cached asset matches the asset stored on the origin server.

Informazioni chiave:Key information:

  • Questa azione viene eseguita solo per le risposte generate da un server di origine che non ha assegnato un'indicazione di validità massima nell'intestazione Cache-Control o Expires.This action will only take place for responses from an origin server that did not assign a max-age indication in the Cache-Control or Expires header.
  • Questa azione non viene eseguita per gli asset che non sono considerati memorizzabili nella cache.This action will not take place for assets that are not deemed cacheable.
  • Questa azione non riguarda le riconvalide della cache dal browser al server perimetrale.This action does not affect browser to edge server cache revalidations. Questi tipi di riconvalida, infatti, vengono determinati dalle intestazioni Cache-Control o Expires inviate al browser, che possono essere personalizzate con la funzionalità External Max-Age (Validità massima esterna).These types of revalidations are determined by the Cache-Control or Expires headers sent to the browser, which can be customized with the External Max-Age feature.
  • I risultati di questa azione non producono alcun effetto osservabile sulle intestazioni di risposta e sui contenuti restituiti dai server periferici, ma possono influire sulla quantità di traffico di riconvalida inviato dai server periferici al server di origine.The results of this action do not have an observable effect on the response headers and the content returned from edge servers for your content, but it may have an effect on the amount of revalidation traffic sent from edge servers to your origin server.
  • Per configurare questa funzionalità:Configure this feature by:

    • Selezionare il codice di stato per il quale può essere applicata una validità massima interna predefinita.Selecting the status code for which a default internal max-age can be applied.
    • Specificare un valore intero e quindi selezionare l'unità di tempo desiderata, ad esempio secondi, minuti, ore e così via.Specifying an integer value and then selecting the desired time unit (for example, seconds, minutes, hours, etc.). Questo valore definisce l'intervallo di validità massima interna predefinita.This value defines the default internal max-age interval.
  • Impostare l'unità di tempo su "Off" per assegnare un intervallo di validità massima interna predefinita di 7 giorni alle richieste a cui non è stata assegnata un'indicazione di validità massima nella rispettiva intestazione Cache-Control o Expires.Setting the time unit to "Off" will assign a default internal max-age interval of 7 days for requests that have not been assigned a max-age indication in their Cache-Control or Expires header.

  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa funzionalità non possa essere associata alle seguenti condizioni di corrispondenza:Due to the manner in which cache settings are tracked, this feature cannot be associated with the following match conditions:
    • EdgeEdge
    • CNAMECname
    • Valore letterale intestazione richiestaRequest Header Literal
    • Carattere jolly intestazione richiestaRequest Header Wildcard
    • Metodo richiestaRequest Method
    • Valore letterale query URLURL Query Literal
    • Carattere jolly query URLURL Query Wildcard

Valore predefinito: 7 giorniDefault Value: 7 days

Gestione intestazione ExpiresExpires Header Treatment

Scopo: controlla la generazione delle intestazioni Expires da un server perimetrale quando è attiva la funzionalità External Max-Age (Validità massima esterna).Purpose: Controls the generation of Expires headers by an edge server when the External Max-Age feature is active.

Il modo più semplice per ottenere questo tipo di configurazione è inserire le funzionalità External Max-Age (Validità massima esterna) e Expires Header Treatment (Gestione intestazioni Expires) nella stessa istruzione.The easiest way to achieve this type of configuration is to place the External Max-Age and the Expires Header Treatment features in the same statement.

ValoreValue RisultatoResult
OverwriteOverwrite Garantisce che vengano eseguite le azioni seguenti:Ensures that the following actions will take place:
- Sovrascrivere l'intestazione Expires generata dal server di origine.- Overwrites the Expires header generated by the origin server.
- Aggiungere alla risposta l'intestazione Expires prodotta dalla funzionalità External Max-Age (Validità massima esterna).- Adds the Expires header produced by the External Max-Age feature to the response.
Pass-throughPass Through Assicura che l'intestazione Expires prodotta dalla funzionalità External Max-Age (Validità massima esterna) non venga mai aggiunta alla risposta.Ensures that the Expires header produced by the External Max-Age feature is never added to the response.
Se il server di origine produce un'intestazione Expires, ne verrà eseguito il pass-through all'utente finale.If the origin server produces an Expires header, it will pass through to the end-user.
Se il server di origine non produce un'intestazione Expires, è possibile che, a causa di questa opzione, l'intestazione della risposta non contenga un'intestazione Expires.If the origin server does not produce an Expires header, then this option may cause the response header to not contain an Expires header.
Add if Missing (Aggiungi se mancante)Add if Missing Se un'intestazione Expires non è stata ricevuta dal server di origine, questa opzione aggiunge l'intestazione Expires prodotta dalla funzionalità External Max-Age (Validità massima esterna).If an Expires header was not received from the origin server, then this option adds the Expires header produced by the External Max-Age feature. Assicura quindi che a tutti gli asset venga assegnata un'intestazione Expires.This option is useful for ensuring that all assets will be assigned an Expires header.
RimuovereRemove Assicura che con la risposta di intestazione non sia inclusa un'intestazione Expires.Ensures that an Expires header is not included with the header response. Se è già stata assegnata un'intestazione Expires, verrà rimossa dalla risposta di intestazione.If an Expires header has already been assigned, then it will be stripped from the header response.

Comportamento predefinito: OverwriteDefault Behavior: Overwrite

Max-Age esternoExternal Max-Age

Scopo: determina l'intervallo di validità massima per la riconvalida della cache dal browser al server perimetrale.Purpose: Determines the max-age interval for browser to edge server cache revalidation. In altre parole, la quantità di tempo che deve trascorrere prima che un browser cerchi una nuova versione di un asset da un server periferico.In other words, the amount of time that will pass before a browser can check for a new version of an asset from an edge server.

Abilitando questa funzionalità, dai server periferici verranno generate le intestazioni Cache-Control:max-age e Expires e verranno inviate al client HTTP.Enabling this feature will generate Cache-Control:max-age and Expires headers from our edge servers and send them to the HTTP client. Per impostazione predefinita, queste intestazioni sovrascriveranno quelle create dal server di origine.By default, these headers will overwrite those created by the origin server. Per modificare questo comportamento, tuttavia, è possibile usare le funzionalità Cache-Control Header Treatment (Gestione intestazioni Cache-Control) e Expires Header Treatment (Gestione intestazioni Expires).However, the Cache-Control Header Treatment and the Expires Header Treatment features may be used to alter this behavior.

Informazioni chiave:Key information:

  • Questa azione non riguarda le riconvalide della cache dal server periferico al server di origine.This action does not affect edge server to origin server cache revalidations. Questi tipi di riconvalida, infatti, vengono determinati dalle intestazioni Cache-controllo/Expires ricevute dal server di origine e possono essere personalizzati con le funzionalità Default Internal Max-Age (Validità massima interna predefinita) e Force Internal Max-Age (Forza validità massima interna).These types of revalidations are determined by the Cache-Control/Expires headers received from the origin server, and can be customized with the Default Internal Max-Age and the Force Internal Max-Age features.
  • Configurare questa funzionalità specificando un valore intero e selezionando l'unità di tempo desiderata, ad esempio secondi, minuti, ore e così via.Configure this feature by specifying an integer value and selecting the desired time unit (for example, seconds, minutes, hours, etc.).
  • Se si imposta questa funzionalità su un valore negativo, il server periferico invia una direttiva Cache-Control:no-cache e un valore temporale Expires impostato nel passato con ogni risposta inviata al browser.Setting this feature to a negative value causes our edge servers to send a Cache-Control:no-cache and an Expires time that is set in the past with each response to the browser. Anche nel caso in cui un client HTTP non memorizzi nella cache la risposta, questa impostazione non influisce sulla capacità dei server periferici di memorizzare nella cache la risposta ottenuta dal server di origine.Although an HTTP client will not cache the response, this setting will not affect our edge servers' ability to cache the response from the origin server.
  • Impostando l'unità di tempo su "Off", questa funzionalità viene disabilitata.Setting the time unit to "Off" will disable this feature. Delle intestazioni Cache-Control/Expires memorizzate nella cache con la risposta del server di origine viene eseguito il pass-through al browser.The Cache-Control/Expires headers cached with the response of the origin server will pass through to the browser.

Comportamento predefinito: OffDefault Behavior: Off

Forza Max-Age internoForce Internal Max-Age

Scopo: determina l'intervallo di validità massima per la riconvalida della cache dal server perimetrale al server di origine.Purpose: Determines the max-age interval for edge server to origin server cache revalidation. In altre parole, la quantità di tempo che deve trascorrere prima che un server perimetrale verifichi se un asset memorizzato nella cache corrisponde all'asset archiviato sul server di origine.In other words, the amount of time that will pass before an edge server can check whether a cached asset matches the asset stored on the origin server.

Informazioni chiave:Key information:

  • Questa funzionalità sostituirà l'intervallo di validità massima definito nelle intestazioni Cache-Control o Expires generate da un server di origine.This feature will override the max-age interval defined in Cache-Control or Expires headers generated from an origin server.
  • Questa funzionalità non riguarda le riconvalide della cache dal browser al server perimetrale.This feature does not affect browser to edge server cache revalidations. Questi tipi di riconvalida, infatti, vengono determinati dalle intestazioni Cache-Control o Expires inviate al browser.These types of revalidations are determined by the Cache-Control or Expires headers sent to the browser.
  • Questa funzionalità non produce alcun effetto osservabile sulla risposta fornita da un server perimetrale al richiedente.This feature does not have an observable effect on the response delivered by an edge server to the requester. Può tuttavia influire sulla quantità di traffico di riconvalida inviato dai server perimetrali al server di origine.However, it may have an effect on the amount of revalidation traffic sent from our edge servers to the origin server.
  • Per configurare questa funzionalità:Configure this feature by:

    • Selezionare il codice di stato per il quale verrà applicato un intervallo di validità massima interna.Selecting the status code for which an internal max-age will be applied.
    • Specificare un valore intero e quindi selezionare l'unità di tempo desiderata, ad esempio secondi, minuti, ore e così via.Specifying an integer value and selecting the desired time unit (for example, seconds, minutes, hours, etc.). Questo valore definisce l'intervallo di validità massima della richiesta.This value defines the request's max-age interval.
  • Impostando l'unità di tempo su "Off", questa funzionalità viene disabilitataSetting the time unit to "Off" disables this feature. e agli asset non verrà assegnato un intervallo di validità massima interna.An internal max-age interval will not be assigned to requested assets. Se nell'intestazione originale non sono contenute istruzioni di memorizzazione nella cache, l'asset verrà memorizzato nella cache in base all'impostazione attiva nella funzionalità Default Internal Max-Age (Validità massima interna predefinita).If the original header does not contain caching instructions, then the asset will be cached according to the active setting in the Default Internal Max-Age feature.

  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa funzionalità non possa essere associata alle seguenti condizioni di corrispondenza:Due to the manner in which cache settings are tracked, this feature cannot be associated with the following match conditions:
    • EdgeEdge
    • CNAMECname
    • Valore letterale intestazione richiestaRequest Header Literal
    • Carattere jolly intestazione richiestaRequest Header Wildcard
    • Metodo richiestaRequest Method
    • Valore letterale query URLURL Query Literal
    • Carattere jolly query URLURL Query Wildcard

Comportamento predefinito: OffDefault Behavior: Off

Supporto H.264 (download progressivo HTTP)H.264 Support (HTTP Progressive Download)

Scopo: determina i tipi di formati di file H.264 che possono essere usati per lo streaming di contenuti.Purpose: Determines the types of H.264 file formats that may be used to stream content.

Informazioni chiave:Key information:

  • Nell'opzione Estensioni file definire un set delimitato da spazi di estensioni di file H.264 consentite.Define a space-delimited set of allowed H.264 filename extensions in the File Extensions option. L'opzione Estensioni file sostituirà il comportamento predefinito.The File Extensions option will override the default behavior. Garantire il supporto di file MP4 e F4V includendo queste estensioni durante la configurazione dell'opzione.Maintain MP4 and F4V support by including those filename extensions when setting this option.
  • Assicurarsi di includere un punto per ogni estensione di file aggiunta, ad esempio, .mp4 .f4v.Be sure to include a period when specifying each filename extension (for example, .mp4 .f4v).

Comportamento predefinito: il download progressivo HTTP supporta file multimediali MP4 e F4V per impostazione predefinita.Default Behavior: HTTP Progressive Download supports MP4 and F4V media by default.

Rispetta richiesta no-cacheHonor no-cache request

Scopo:: determina se le richieste no-cache di un client HTTP verranno inoltrate al server di origine.Purpose: Determines whether an HTTP client's no-cache requests will be forwarded to the origin server.

Una richiesta no-cache si verifica quando il client HTTP invia un'intestazione Cache-Control:no-cache e/o Pragma:no-cache nella richiesta HTTP.A no-cache request occurs when the HTTP client sends a Cache-Control:no-cache and/or Pragma:no-cache header in the HTTP request.

ValoreValue RisultatoResult
EnabledEnabled Consente alle richieste no-cache di un client HTTP di essere inoltrate al server di origine e al server di origine di restituire al client HTTP le intestazioni di risposta e il corpo tramite il server periferico.Allows an HTTP client's no-cache requests to be forwarded to the origin server, and the origin server will return the response headers and the body through the edge server back to the HTTP client.
DisabledDisabled Ripristina il comportamento predefinito.Restores the default behavior. Il comportamento predefinito prevede di impedire alle richieste no-cache di essere inoltrate al server di origine.The default behavior is to prevent no-cache requests from being forwarded to the origin server.

Per tutto il traffico di produzione, è consigliabile lasciare questa funzionalità nello stato disabilitato predefinito.For all production traffic, it is highly recommended to leave this feature in its default disabled state. In caso contrario, i server di origine non risulteranno protetti da eventuali utenti finali che attivino inavvertitamente molte richieste no-cache durante l'aggiornamento di pagine Web o dai numerosi lettori multimediali di uso comune codificati per inviare un'intestazione no-cache con ogni richiesta video.Otherwise, origin servers will not be shielded from end-users who may inadvertently trigger many no-cache requests when refreshing web pages, or from the many popular media players that are coded to send a no-cache header with every video request. Se applicata a determinate directory di staging o testing non di produzione, tuttavia, questa funzionalità consente di effettuare il pull on-demand di contenuti aggiornati dal server di origine.Nevertheless, this feature can be useful to apply to certain non-production staging or testing directories, in order to allow fresh content to be pulled on-demand from the origin server.

Lo stato della cache visualizzato per una richiesta che può essere inoltrata a un server di origine grazie a questa funzionalità è: TCP_Client_Refresh_Miss.The cache status that will be reported for a request that is allowed to be forwarded to an origin server due to this feature is TCP_Client_Refresh_Miss. Il report sugli stati della cache, disponibile nel modulo di report principale, fornisce informazioni statistiche in base allo stato della cache.The Cache Statuses report, which is available in the Core reporting module, provides statistical information by cache status. Consente quindi di monitorare il numero e la percentuale di richieste inoltrate a un server di origine a causa di questa funzionalità.This allows you to track the number and percentage of requests that are being forwarded to an origin server due to this feature.

Comportamento predefinito: Disabled.Default Behavior: Disabled.

Ignore Origin no-cache (Ignora origine No-Cache)Ignore Origin no-cache

Scopo: determina se la rete CDN ignorerà le seguenti direttive gestite da un server di origine.Purpose: Determines whether our CDN will ignore the following directives served from an origin server:

  • Cache-Control: privateCache-Control: private
  • Cache-Control: no-storeCache-Control: no-store
  • Cache-Control: no-cacheCache-Control: no-cache
  • Pragma: no-cachePragma: no-cache

Informazioni chiave:Key information:

  • Configurare questa funzionalità definendo un elenco delimitato da spazi di codici di stato per i quali dovranno essere ignorate le direttive sopra riportate.Configure this feature by defining a space-delimited list of status codes for which the above directives will be ignored.
  • I codici di stato validi per questa funzionalità sono: 200, 203, 300, 301, 302, 305, 307, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 500, 501, 502, 503, 504 e 505.The set of valid status codes for this feature are: 200, 203, 300, 301, 302, 305, 307, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 500, 501, 502, 503, 504, and 505.
  • Disabilitare questa funzionalità impostandola su un valore vuoto.Disable this feature by setting it to a blank value.
  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa funzionalità non possa essere associata alle seguenti condizioni di corrispondenza:Due to the manner in which cache settings are tracked, this feature cannot be associated with the following match conditions:
    • EdgeEdge
    • CNAMECname
    • Valore letterale intestazione richiestaRequest Header Literal
    • Carattere jolly intestazione richiestaRequest Header Wildcard
    • Metodo richiestaRequest Method
    • Valore letterale query URLURL Query Literal
    • Carattere jolly query URLURL Query Wildcard

Comportamento predefinito: il comportamento prevede di rispettare le direttive sopra riportate.Default Behavior: The default behavior is to honor the above directives.

Ignora gli intervalli che non è possibile soddisfareIgnore Unsatisfiable Ranges

Scopo: determina la risposta che verrà restituita ai client quando una richiesta genera un codice di stato 416 Impossibile attenersi all'intervallo richiesto.Purpose: Determines the response that will be returned to clients when a request generates a 416 Requested Range Not Satisfiable status code.

Per impostazione predefinita, questo codice di stato viene restituito quando la richiesta di intervallo di byte specificata non può essere soddisfatta da un server periferico e non è stato specificato un campo di intestazione di richiesta If-Range.By default, this status code is returned when the specified byte-range request cannot be satisfied by an edge server and an If-Range request header field was not specified.

ValoreValue RisultatoResult
EnabledEnabled Impedisce ai server periferici di rispondere a una richiesta di intervallo di byte non valida con un codice di stato 416 - Impossibile attenersi all'intervallo richiesto.Prevents our edge servers from responding to an invalid byte-range request with a 416 Requested Range Not Satisfiable status code. I server forniranno invece l'asset richiesto e restituiranno al client il codice 200 - OK.Instead our servers will deliver the requested asset and return a 200 OK to the client.
DisabledDisabled Ripristina il comportamento predefinito.Restores the default behavior. Il comportamento predefinito prevede di rispettare il codice di stato 416 - Impossibile attenersi all'intervallo richiesto.The default behavior is to honor the 416 Requested Range Not Satisfiable status code.

Comportamento predefinito: Disabled.Default Behavior: Disabled.

Max-Stale internoInternal Max-Stale

Scopo: controlla per quanto tempo, dopo la normale scadenza, un asset memorizzato nella cache può essere servito da un server perimetrale quando il server perimetrale non è in grado di riconvalidare l'asset memorizzato nella cache con il server di origine.Purpose: Controls how long past the normal expiration time a cached asset may be served from an edge server when the edge server is unable to revalidate the cached asset with the origin server.

In genere, quando l'intervallo di validità massima di un asset scade, il server periferico invia una richiesta di riconvalida al server di origine.Normally, when an asset's max-age time expires, the edge server will send a revalidation request to the origin server. Il server di origine risponde quindi con un codice di stato 304 - Non modificato per fornire al server periferico un lease aggiornato sull'asset memorizzato nella cache o con un codice 200 - OK per fornire al server periferico una versione aggiornata dell'asset memorizzato nella cache.The origin server will then respond with either a 304 Not Modified to give the edge server a fresh lease on the cached asset, or else with 200 OK to provide the edge server with an updated version of the cached asset.

Se il server periferico non è in grado di stabilire una connessione con il server di origine durante il tentativo di riconvalida, la funzionalità Internal Max-Stale (Tempo di non aggiornamento massimo interno) controlla se e per quanto tempo il server periferico può continuare a servire l'asset non aggiornato.If the edge server is unable to establish a connection with the origin server while attempting such a revalidation, then this Internal Max-Stale feature controls whether, and for how long, the edge server may continue to serve the now-stale asset.

Questo intervallo di tempo inizia nel momento in cui scade la validità massima dell'asset, non quando la riconvalida ha esito negativo.Note that this time interval starts when the asset's max-age expires, not when the failed revalidation occurs. Il periodo massimo durante il quale un asset può essere servito senza riconvalida corrisponde quindi alla quantità di tempo determinata dalla combinazione dei valori Max-Age (Validità massima) e Max-Stale (Tempo di non aggiornamento massimo).Therefore, the maximum period during which an asset can be served without successful revalidation is the amount of time specified by the combination of max-age plus max-stale. Se, ad esempio, un asset è stato memorizzato nella cache alle 9.00 con una validità massima di 30 minuti e un tempo di non aggiornamento massimo di 15 minuti, in caso di tentativo di riconvalida non riuscito alle 9.44 un utente finale riceverebbe l'asset memorizzato nella cache non aggiornato, mentre in caso di tentativo di riconvalida non riuscito alle 9.46 l'utente finale riceverebbe un codice di stato 504 - Timeout gateway.For example, if an asset was cached at 9:00 with a max-age of 30 minutes and a max-stale of 15 minutes, then a failed revalidation attempt at 9:44 would result in an end-user receiving the stale cached asset, while a failed revalidation attempt at 9:46 would result in the end user receiving a 504 Gateway Timeout.

Qualsiasi valore configurato per questa funzionalità viene sostituito dall'intestazione Cache-Control:must-revalidate o Cache-Control:proxy-revalidate ricevuta dal server di origine.Any value configured for this feature is superseded by Cache-Control:must-revalidate or Cache-Control:proxy-revalidate headers received from the origin server. Se una di queste intestazioni viene ricevuta dal server di origine all'inizio della procedura di memorizzazione dell'asset nella cache, il server periferico non servirà un asset memorizzato nella cache non aggiornato.If either of those headers is received from the origin server when an asset is initially cached, then the edge server will not serve a stale cached asset. In questo caso, se il server periferico non è in grado di eseguire la riconvalida con il server di origine alla scadenza dell'intervallo di validità massima dell'asset, il server periferico restituirà un codice di stato 504 - Timeout gateway.In such a case, if the edge server is unable to revalidate with the origin when the asset's max-age interval has expired, then the edge server will return a 504 Gateway Timeout.

Informazioni chiave:Key information:

  • Per configurare questa funzionalità:Configure this feature by:

    • Selezionare il codice di stato in base al quale verrà applicato il tempo di non aggiornamento massimo.Selecting the status code for which a max-stale will be applied.
    • Specificare un valore intero e quindi selezionare l'unità di tempo desiderata, ad esempio secondi, minuti, ore e così via.Specifying an integer value and then selecting the desired time unit (for example, seconds, minutes, hours, etc.). Questo valore definisce il tempo di non aggiornamento massimo interno che verrà applicato.This value defines the internal max-stale that will be applied.
  • Impostando l'unità di tempo su "Off", questa funzionalità viene disabilitata.Setting the time unit to "Off" will disable this feature. Un asset memorizzato nella cache non verrà servito dopo la normale scadenza.A cached asset will not be served beyond its normal expiration time.

  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa funzionalità non possa essere associata alle seguenti condizioni di corrispondenza:Due to the manner in which cache settings are tracked, this feature cannot be associated with the following match conditions:
    • EdgeEdge
    • CNAMECname
    • Valore letterale intestazione richiestaRequest Header Literal
    • Carattere jolly intestazione richiestaRequest Header Wildcard
    • Metodo richiestaRequest Method
    • Valore letterale query URLURL Query Literal
    • Carattere jolly query URLURL Query Wildcard

Comportamento predefinito: due minutiDefault Behavior: Two minutes

Condivisione cache parzialePartial Cache Sharing

Scopo: determina se una richiesta può generare contenuti parzialmente memorizzati nella cache.Purpose: Determines whether a request can generate partially cached content.

Questa cache parziale può essere quindi usata per soddisfare nuove richieste dei contenuti desiderati fino a quando non risultano completamente memorizzati nella cache.This partial cache may then be used to fulfill new requests for that content until the requested content is fully cached.

ValoreValue RisultatoResult
EnabledEnabled Le richieste possono generare contenuti parzialmente memorizzati nella cache.Requests can generate partially cached content.
DisabledDisabled Le richieste possono generare solo una versione completamente memorizzata nella cache dei contenuti richiesti.Requests can only generate a fully cached version of the requested content.

Comportamento predefinito: Disabled.Default Behavior: Disabled.

Preconvalida contenuto memorizzato nella cachePrevalidate Cached Content

Scopo: determina se i contenuti memorizzati nella cache saranno idonei per la riconvalida anticipata prima della scadenza della durata (TTL).Purpose: Determines whether cached content will be eligible for early revalidation before its TTL expires.

Definire l'intervallo di tempo prima della scadenza della durata dei contenuti richiesti durante il quale i contenuti saranno idonei per la riconvalida anticipata.Define the amount of time prior to the expiration of the requested content's TTL during which it will be eligible for early revalidation.

Informazioni chiave:Key information:

  • Se si imposta l'unità di tempo su "Off", la riconvalida dovrà essere eseguita dopo la scadenza della durata dei contenuti memorizzati nella cache.Selecting "Off" as the time unit requires revalidation to take place after the cached content's TTL has expired. Non è necessario specificare alcun valore di tempo, poiché verrebbe ignorato.Time should not be specified and it will be ignored.

Comportamento predefinito: Off.Default Behavior: Off. La riconvalida può aver luogo solo dopo la scadenza della durata dei contenuti memorizzati nella cache.Revalidation may only take place after the cached content's TTL has expired.

Aggiorna i file della cache con zero byteRefresh Zero Byte Cache Files

Scopo: determina come viene gestita dai server perimetrali una richiesta da parte di un client HTTP di un asset della cache con 0 byte.Purpose: Determines how an HTTP client's request for a 0-byte cache asset is handled by our edge servers.

I valori validi sono:Valid values are:

ValoreValue RisultatoResult
EnabledEnabled Fa sì che il server periferico recuperi nuovamente l'asset dal server di origine.Causes our edge server to refetch the asset from the origin server.
DisabledDisabled Ripristina il comportamento predefinito.Restores the default behavior. Il comportamento predefinito prevede di rendere disponibili asset di cache validi su richiesta.The default behavior is to serve up valid cache assets upon request.

Questa funzionalità non è necessaria per eseguire correttamente operazioni di memorizzazione nella cache o distribuzione di contenuti, ma può essere utile come soluzione alternativa.This feature is not required for correct caching and content delivery, but may be useful as a workaround. I generatori di contenuti dinamici nei server di origine, ad esempio, possono determinare inavvertitamente l'invio di risposte con 0 byte ai server periferici.For example, dynamic content generators on origin servers can inadvertently result in 0-byte responses being sent to the edge servers. Questi tipi di risposte, in genere, vengono memorizzati nella cache dai server periferici.These types of responses are typically cached by our edge servers. Presupponendo che una risposta con 0 byte non sia mai una risposta validaIf you know that a 0-byte response is never a valid response

per questo tipo di contenuti, questa funzionalità può impedire che ai client vengano serviti questi tipi di asset.for such content, then this feature can prevent these types of assets from being served to your clients.

Comportamento predefinito: Disabled.Default Behavior: Disabled.

Imposta codici di stato inseribile nella cacheSet Cacheable Status Codes

Scopo: definisce il set di codici di stato che possono generare contenuti memorizzati nella cache.Purpose: Defines the set of status codes that can result in cached content.

Per impostazione predefinita, la memorizzazione nella cache è abilitata solo per le risposte 200 - OK.By default, caching is only enabled for 200 OK responses.

Definire un set delimitato da spazi dei codici di stato desiderati.Define a space-delimited set of the desired status codes.

Informazioni chiave:Key information:

  • Abilitare la funzionalità Ignore Origin No-Cache (Ignora origine No-Cache).Enable the Ignore Origin No-Cache feature. In caso contrario, è possibile che le risposte diverse da 200 - OK non vengano memorizzate nella cache.If this feature is not enabled, then non-200 OK responses may not be cached.
  • I codici di stato validi per questa funzionalità sono: 203, 300, 301, 302, 305, 307, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 500, 501, 502, 503, 504 e 505.The set of valid status codes for this feature are: 203, 300, 301, 302, 305, 307, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 500, 501, 502, 503, 504, and 505.
  • Questa funzionalità non può essere usata per disabilitare la memorizzazione nella cache delle risposte che generano un codice di stato 200 - OK.This feature cannot be used to disable caching for responses that generate a 200 OK status code.

Comportamento predefinito: la memorizzazione nella cache è abilitata solo per le risposte che generano un codice di stato 200 - OK.Default Behavior: Caching is enabled only for responses that generate a 200 OK status code.

Distribuzione di contenuto non aggiornato in caso di erroreStale Content Delivery on Error

Scopo:Purpose:

Determina se il contenuto scaduto memorizzato nella cache verrà distribuito quando si verifica un errore durante la riconvalida della cache o quando si recupera il contenuto richiesto dal server di origine del cliente.Determines whether expired cached content will be delivered when an error occurs during cache revalidation or when retrieving the requested content from the customer origin server.

ValoreValue RisultatoResult
EnabledEnabled Se si verifica un errore durante una connessione a un server di origine, al richiedente vengono serviti contenuti non aggiornati.Stale content will be served to the requester when an error occurs during a connection to an origin server.
DisabledDisabled L'errore del server di origine viene inoltrato al richiedente.The origin server's error will be forwarded to the requester.

Comportamento predefinito: DisabledDefault Behavior: Disabled

Client non aggiornato durante la riconvalidaStale While Revalidate

Scopo: migliora le prestazioni consentendo ai server perimetrali di servire contenuti non aggiornati al richiedente mentre è in corso la riconvalida.Purpose: Improves performance by allowing our edge servers to serve stale content to the requester while revalidation takes place.

Informazioni chiave:Key information:

  • Il comportamento di questa funzionalità varia in base all'unità di tempo selezionata.The behavior of this feature varies according to the selected time unit.
    • Unità di tempo: specificare un intervallo di tempo e selezionare un'unità di tempo, ad esempio secondi, minuti, ore e così via, per consentire la distribuzione di contenuti non aggiornati.Time Unit: Specify a length of time and select a time unit (for example, Seconds, Minutes, Hours, etc.) to allow stale content delivery. Questo tipo di configurazione consente alla rete CDN di estendere l'intervallo di tempo durante il quale può distribuire contenuti prima di richiedere la convalida in base alla formula seguente: Durata + Stale While Revalidate Time (Client non aggiornato durante la riconvalida)This type of setup allows the CDN to extend the length of time that it may deliver content before requiring validation according to the following formula:TTL + Stale While Revalidate Time
    • Off: selezionare "Off" per richiedere la riconvalida prima che possa essere servita una richiesta di contenuti non aggiornati.Off: Select "Off" to require revalidation before a request for stale content may be served.
      • Non specificare un intervallo di tempo poiché non è applicabile e verrebbe ignorato.Do not specify a length of time since it is inapplicable and will be ignored.

Comportamento predefinito: Off.Default Behavior: Off. La riconvalida deve aver luogo prima che possano essere serviti i contenuti richiesti.Revalidation must take place before the requested content can be served.

CommentoComment

Scopo: consente di aggiungere una nota all'interno di una regola.Purpose: Allows a note to be added within a rule.

Uno dei possibili usi di questa funzionalità è quello di fornire informazioni aggiuntive sullo scopo generale di una regola o sui motivi per cui alla regola è stata aggiunta una determinata funzionalità o condizione di corrispondenza.One use for this feature is to provide additional information on the general purpose of a rule or why a particular match condition or feature was added to the rule.

Informazioni chiave:Key information:

  • Non possono essere specificati più di 150 caratteri.A maximum of 150 characters may be specified.
  • Usare solo caratteri alfanumerici.Use only alphanumeric characters.
  • Questa funzionalità non influisce sul comportamento della regola.This feature does not affect the behavior of the rule. È stata concepita al solo scopo di mettere a disposizione un'area in cui poter fornire informazioni da usare come riferimento futuro o per risolvere un problema relativo alla regola.It is merely meant to provide an area where you can provide information for future reference or that may help when troubleshooting the rule.

headersHeaders

Queste funzionalità sono progettate per aggiungere, modificare o eliminare le intestazioni dalla richiesta o dalla risposta.These features are designed to add, modify, or delete headers from the request or response.

NomeName ScopoPurpose
Intestazione di risposta AgeAge Response Header Determina se un'intestazione di risposta Age verrà inclusa nella risposta inviata al richiedente.Determines whether an Age response header will be included in the response sent to the requester.
Intestazioni di risposta di debug per la cacheDebug Cache Response Headers Determina se una risposta può includere l'intestazione di risposta X-EC-Debug che fornisce informazioni sul criterio di cache per l'asset richiesto.Determines whether a response may include the X-EC-Debug response header which provides information on the cache policy for the requested asset.
Modifica intestazione richiesta clientModify Client Request Header Sovrascrive, aggiunge o elimina un'intestazione da una richiesta.Overwrites, appends, or deletes a header from a request.
Modificare intestazione risposta clientModify Client Response Header Sovrascrive, aggiunge o elimina un'intestazione da una risposta.Overwrites, appends, or deletes a header from a response.
Imposta intestazione personalizzata IP clientSet Client IP Custom Header Consente di aggiungere l'indirizzo IP del client richiedente alla richiesta come un'intestazione personalizzata.Allows the IP address of the requesting client to be added to the request as a custom request header.

Intestazione di risposta AgeAge Response Header

Scopo: determina se un'intestazione di risposta Age verrà inclusa nella risposta inviata al richiedente.Purpose: Determines whether an Age response header will be included in the response sent to the requester.

ValoreValue RisultatoResult
EnabledEnabled L'intestazione di risposta Age verrà inclusa nella risposta inviata al richiedente.The Age response header will be included in the response sent to the requester.
DisabledDisabled L'intestazione di risposta Age verrà esclusa dalla risposta inviata al richiedente.The Age response header will be excluded from the response sent to the requester.

Comportamento predefinito:: Disabled.Default Behavior: Disabled.

Intestazioni di risposta di debug per la cacheDebug Cache Response Headers

Scopo: determina se una risposta può includere l'intestazione di risposta X-EC-Debug che fornisce informazioni sui criteri di cache per l'asset richiesto.Purpose: Determines whether a response may include the X-EC-Debug response header which provides information on the cache policy for the requested asset.

Le intestazioni di risposta di debug per la cache vengono incluse nella risposta quando sono soddisfatte entrambe le condizioni seguenti:Debug cache response headers will be included in the response when both of the following are true:

  • Nella richiesta desiderata è stata abilitata la funzionalità relativa alle intestazioni di risposta di debug per la cache.The Debug Cache Response Headers Feature has been enabled on the desired request.
  • La richiesta precedente definisce il set di intestazioni di risposta di debug per la cache incluso nella risposta.The above request defines the set of debug cache response headers that will be included in the response.

Le intestazioni di risposta di debug per la cache possono essere richieste includendo nella richiesta l'intestazione seguente e le direttive desiderate:Debug cache response headers may be requested by including the following header and the desired directives in the request:

X-EC-Debug: Direttiva1,Direttiva2,DirettivaNX-EC-Debug: Directive1,Directive2,DirectiveN

Esempio:Example:

X-EC-Debug: x-ec-cache,x-ec-check-cacheable,x-ec-cache-key,x-ec-cache-stateX-EC-Debug: x-ec-cache,x-ec-check-cacheable,x-ec-cache-key,x-ec-cache-state

ValoreValue RisultatoResult
EnabledEnabled Le richieste di intestazioni di risposta di debug per la cache restituiranno una risposta che include l'intestazione X-EC-Debug.Requests for debug cache response headers will return a response that includes the X-EC-Debug header.
DisabledDisabled L'intestazione di risposta X-EC-Debug verrà esclusa dalla risposta.The X-EC-Debug response header will be excluded from the response.

Comportamento predefinito: Disabled.Default Behavior: Disabled.

Modificare intestazione risposta clientModify Client Response Header

Scopo: ogni richiesta contiene un set di intestazioni di richiesta che la descrivono.Purpose: Each request contains a set of request headers that describe it. Questa funzionalità può:This feature can either:

  • Aggiungere o sovrascrivere il valore assegnato a un'intestazione di richiesta.Append or overwrite the value assigned to a request header. Se l'intestazione di richiesta specificata non esiste, questa funzionalità la aggiungerà alla richiesta.If the specified request header does not exist, then this feature will add it to the request.
  • Eliminare dalla richiesta un'intestazione di richiesta.Delete a request header from the request.

Le richieste inoltrate a un server di origine rifletteranno le modifiche apportate da questa funzionalità.Requests that are forwarded to an origin server will reflect the changes made by this feature.

Su un'intestazione di richiesta è possibile eseguire una delle azioni seguenti:One of the following actions can be performed on a request header:

OpzioneOption DescrizioneDescription EsempioExample
AppendAppend Il valore specificato verrà aggiunto alla fine del valore dell'intestazione di richiesta esistente.The specified value will be added to the end of the existing request header value. Valore intestazione richiesta (Client):Value1Request header value (Client):Value1
Valore intestazione richiesta (Motore regole HTTP): Value2Request header value (HTTP Rules Engine): Value2
Valore nuova intestazione di richiesta: Value1Value2New request header value: Value1Value2
OverwriteOverwrite Il valore dell'intestazione di richiesta verrà impostato sul valore specificato.The request header value will be set to the specified value. Valore intestazione richiesta (Client):Value1Request header value (Client):Value1
Valore intestazione richiesta (Motore regole HTTP): Value2Request header value (HTTP Rules Engine): Value2
Valore nuova intestazione richiesta: Value2New request header value: Value2
EliminaDelete Elimina l'intestazione di richiesta specificata.Deletes the specified request header. Valore intestazione richiesta (Client):Value1Request header value (Client):Value1
Configurazione Modify Client Request Header (Modifica intestazione richiesta client): elimina l'intestazione di richiesta in questione.Modify Client Request Header configuration: Delete the request header in question.
Risultato: l'intestazione di richiesta specificata non verrà inoltrata al server di origine.Result: The specified request header will not be forwarded to the origin server.

Informazioni chiave:Key information:

  • Assicurarsi che il valore specificato nell'opzione Nome corrisponda esattamente all'intestazione di richiesta desiderata.Ensure that the value specified in the Name option is an exact match for the desired request header.
  • Ai fini dell'identificazione di un'intestazione non viene fatta distinzione tra maiuscole e minuscole.Case is not taken into account for the purpose of identifying a header. Per identificare l'intestazione Cache-Control, ad esempio, è possibile usare una delle varianti di nome seguenti:For example, any of the following variations of the Cache-Control header name can be used to identify it:
    • cache-controlcache-control
    • CACHE-CONTROLCACHE-CONTROL
    • cachE-ControlcachE-Control
  • Quando si specifica un nome di intestazione, assicurarsi di usare solo caratteri alfanumerici, trattini o caratteri di sottolineatura.When specifying a header name, use only alphanumeric characters, dashes, or underscores.
  • L'eliminazione di un'intestazione impedisce che venga inoltrata a un server di origine dai server perimetrali.Deleting a header will prevent it from being forwarded to an origin server by our edge servers.
  • Le intestazioni seguenti sono riservate e non possono essere modificate da questa funzionalità:The following headers are reserved and cannot be modified by this feature:
    • forwardedforwarded
    • hosthost
    • viavia
    • Avvisowarning
    • x-forwarded-forx-forwarded-for
    • Tutti i nomi di intestazione che iniziano con "x-ec" sono riservati.All header names that start with "x-ec" are reserved.

Modificare intestazione risposta clientModify Client Response Header

Ogni risposta contiene un set di intestazioni di risposta che la descrivono.Each response contains a set of response headers that describe it. Questa funzionalità può:This feature can either:

  • Aggiungere o sovrascrivere il valore assegnato a un'intestazione di risposta.Append or overwrite the value assigned to a response header. Se l'intestazione di richiesta specificata non esiste, questa funzionalità la aggiungerà alla risposta.If the specified request header does not exist, then this feature will add it to the response.
  • Eliminare dalla risposta un'intestazione di risposta.Delete a response header from the response.

Per impostazione predefinita, i valori delle intestazioni di risposta vengono definiti da un server di origine e dai server periferici.By default, response header values are defined by an origin server and by our edge servers.

Su un'intestazione di risposta è possibile eseguire una delle azioni seguenti:One of the following actions can be performed on a response header:

OpzioneOption DescrizioneDescription EsempioExample
AppendAppend Il valore specificato verrà aggiunto alla fine del valore dell'intestazione di richiesta esistente.The specified value will be added to the end of the existing request header value. Valore intestazione risposta (Client):Value1Response header value (Client):Value1
Valore intestazione risposta (Motore regole HTTP): Value2Response header value (HTTP Rules Engine): Value2
Valore nuova intestazione risposta: Value1Value2New Response header value: Value1Value2
OverwriteOverwrite Il valore dell'intestazione di richiesta verrà impostato sul valore specificato.The request header value will be set to the specified value. Valore intestazione risposta (Client):Value1Response header value (Client):Value1
Valore intestazione risposta (Motore regole HTTP): Value2Response header value (HTTP Rules Engine): Value2
Valore nuova intestazione risposta: Value2New response header value: Value2
EliminaDelete Elimina l'intestazione di richiesta specificata.Deletes the specified request header. Valore intestazione richiesta (Client):Value1Request header value (Client): Value1
Configurazione Modify Client Request Header (Modifica intestazione richiesta client): elimina l'intestazione di risposta in questione.Modify Client Request Header configuration: Delete the response header in question.
Risultato: l'intestazione di risposta specificata non verrà inoltrata al richiedente.Result: The specified response header will not be forwarded to the requester.

Informazioni chiave:Key information:

  • Assicurarsi che il valore specificato nell'opzione Nome corrisponda esattamente all'intestazione di risposta desiderata.Ensure that the value specified in the Name option is an exact match for the desired response header.
  • Ai fini dell'identificazione di un'intestazione non viene fatta distinzione tra maiuscole e minuscole.Case is not taken into account for the purpose of identifying a header. Per identificare l'intestazione Cache-Control, ad esempio, è possibile usare una delle varianti di nome seguenti:For example, any of the following variations of the Cache-Control header name can be used to identify it:
    • cache-controlcache-control
    • CACHE-CONTROLCACHE-CONTROL
    • cachE-ControlcachE-Control
  • L'eliminazione di un'intestazione impedisce che venga inoltrata al richiedente.Deleting a header will prevent it from being forwarded to the requester.
  • Le intestazioni seguenti sono riservate e non possono essere modificate da questa funzionalità:The following headers are reserved and cannot be modified by this feature:
    • accept-encodingaccept-encoding
    • ageage
    • connectionconnection
    • content-encodingcontent-encoding
    • content-lengthcontent-length
    • content-rangecontent-range
    • datedate
    • serverserver
    • trailertrailer
    • transfer-encodingtransfer-encoding
    • Aggiornamentoupgrade
    • varyvary
    • viavia
    • Avvisowarning
    • Tutti i nomi di intestazione che iniziano con "x-ec" sono riservati.All header names that start with "x-ec" are reserved.

Imposta intestazione personalizzata IP clientSet Client IP Custom Header

Scopo: aggiunge un'intestazione personalizzata che identifica il client richiedente in base all'indirizzo IP della richiesta.Purpose: Adds a custom header that identifies the requesting client by IP address to the request.

L'opzione Nome intestazione definisce il nome dell'intestazione di richiesta personalizzata in cui verrà archiviato l'indirizzo IP del client.The Header name option defines the name of the custom request header where the client's IP address will be stored.

Questa funzionalità consente a un server di origine del cliente di trovare gli indirizzi IP dei client tramite un'intestazione di richiesta personalizzata.This feature allows a customer origin server to find out client IP addresses through a custom request header. Se la richiesta viene gestita dalla cache, al server di origine non verrà comunicato l'indirizzo IP del client.If the request is served from cache, then the origin server will not be informed of the client's IP address. È consigliabile quindi usare questa funzionalità con reti ADN e asset che non verranno memorizzati nella cache.Therefore, it is recommended that this feature be used with ADN or assets that will not be cached.

Assicurarsi che il nome di intestazione specificato non coincida con nessuno dei nomi seguenti:Ensure that the specified header name does not match any of the following names:

  • Nomi di intestazioni di richiesta standard.Standard request header names. L'elenco dei nomi di intestazioni standard è disponibile in RFC 2616.A list of standard header names can be found in RFC 2616.
  • Nomi di intestazioni riservate:Reserved header names:
    • forwarded-forforwarded-for
    • hosthost
    • varyvary
    • viavia
    • Avvisowarning
    • x-forwarded-forx-forwarded-for
    • Tutti i nomi di intestazione che iniziano con "x-ec" sono riservati.All header names that start with "x-ec" are reserved.

LogLogs

Queste funzionalità sono progettate per personalizzare i dati archiviati nei file di log non elaborati.These features are designed to customize the data stored in raw log files.

NomeName ScopoPurpose
Campo 1 log personalizzatoCustom Log Field 1 Determina il formato e il contenuto che verranno assegnati al campo di log personalizzato in un file di log non elaborato.Determines the format and the content that will be assigned to the custom log field in a raw log file.
Stringa di query logLog Query String Determina se una stringa di query verrà archiviata insieme all'URL nei log di accesso.Determines whether a query string will be stored along with the URL in access logs.

Campo 1 log personalizzatoCustom Log Field 1

Scopo: determina il formato e i contenuti che verranno assegnati al campo di log personalizzato in un file di log non elaborato.Purpose: Determines the format and the content that will be assigned to the custom log field in a raw log file.

Lo scopo principale di questo campo personalizzato è quello di consentire all'utente di determinare i valori delle intestazioni di richiesta e di risposta che verranno archiviati nei file di log.The main purpose behind this custom field is to allow you to determine which request and response header values will be stored in your log files.

Per impostazione predefinita, il campo del log personalizzato è denominato "x-ec_custom-1".By default, the custom log field is called "x-ec_custom-1." Questo nome, tuttavia, può essere personalizzato dalla pagina delle impostazioni del file di log non elaborato.However, the name of this field can be customized from the Raw Log Settings page.

Di seguito è definita la formattazione da usare per specificare le intestazioni di richiesta e di risposta.The formatting that you should use to specify request and response headers is defined below.

Tipo di intestazioneHeader Type FormatFormat EsempiExamples
Intestazione di richiestaRequest Header %{RequestHeader}i%{RequestHeader}i %{Accept-Encoding}i%{Accept-Encoding}i
{Referer}i{Referer}i
%{Authorization}i%{Authorization}i
Intestazione di rispostaResponse Header %{ResponseHeader}o%{ResponseHeader}o %{Age}o%{Age}o
%{Content-Type}o%{Content-Type}o
%{Cookie}o%{Cookie}o

Informazioni chiave:Key information:

  • Un campo di log personalizzato può contenere qualsiasi combinazione di campi di intestazione e testo normale.A custom log field can contain any combination of header fields and plain text.
  • I caratteri validi per questo campo comprendono: caratteri alfanumerici, ad esempio 0-9, a-z e A-Z, trattini, due punti, punti e virgola, apostrofi, virgole, punti, caratteri di sottolineatura, segni di uguale, parentesi, parentesi quadre e spazi.Valid characters for this field include the following: alphanumeric (0-9, a-z, and A-Z), dashes, colons, semi-colons, apostrophes, commas, periods, underscores, equal signs, parentheses, brackets, and spaces. Il simbolo di percentuale e le parentesi graffe sono consentiti solo se vengono usati per specificare un campo di intestazione.The percentage symbol and curly braces are only allowed when used to specify a header field.
  • L'ortografia di ogni campo di intestazione specificato deve corrispondere esattamente al nome di intestazione di richiesta/risposta desiderato.The spelling for each specified header field must match the desired request/response header name.
  • Se si vuole specificare più intestazioni, è consigliabile usare un separatore per indicare ogni intestazione.If you would like to specify multiple headers, then it is recommended that you use a separator to indicate each header. Per ogni intestazione, ad esempio, è possibile usare un'abbreviazione.For example, you could use an abbreviation for each header. Di seguito è riportata una sintassi di esempio.Sample syntax is provided below.
    • AE: %{Accept-Encoding}i A: %{Authorization}i CT: %{Content-Type}oAE: %{Accept-Encoding}i A: %{Authorization}i CT: %{Content-Type}o

Valore predefinito: -Default Value: -

Stringa di query logLog Query String

Scopo: determina se una stringa di query verrà archiviata insieme all'URL nei log di accesso.Purpose: Determines whether a query string will be stored along with the URL in access logs.

ValoreValue RisultatoResult
EnabledEnabled Consente l'archiviazione di stringhe di query durante la registrazione degli URL in un log di accesso.Allows the storage of query strings when recording URLs in an access log. Se un URL non contiene una stringa di query, questa opzione non produrrà alcun effetto.If a URL does not contain a query string, then this option will not have an effect.
DisabledDisabled Ripristina il comportamento predefinito.Restores the default behavior. Il comportamento predefinito prevede di ignorare le stringhe di query durante la registrazione degli URL in un log di accesso.The default behavior is to ignore query strings when recording URLs in an access log.

Comportamento predefinito: Disabled.Default Behavior: Disabled.

OrigineOrigin

Queste funzionalità sono progettate per controllare in che modo la rete CDN comunica con un server di origine.These features are designed to control how the CDN communicates with an origin server.

NomeName ScopoPurpose
Numero massimo di richieste Keep-AliveMaximum Keep-Alive Requests Definisce il numero massimo di richieste per una connessione Keep-Alive prima della chiusura.Defines the maximum number of requests for a Keep-Alive connection before it is closed.
Intestazioni speciali proxyProxy Special Headers Definisce il set di intestazioni di richiesta specifiche della rete CDN che verranno inoltrate da un server perimetrale a un server di origine.Defines the set of CDN-specific request headers that will be forwarded from an edge server to an origin server.

Numero massimo di richieste Keep-AliveMaximum Keep-Alive Requests

Scopo: definisce il numero massimo di richieste per una connessione Keep-Alive prima della chiusura.Purpose: Defines the maximum number of requests for a Keep-Alive connection before it is closed.

L'impostazione del numero massimo di richieste su un valore basso è fortemente sconsigliata e può influire negativamente sulle prestazioni.Setting the maximum number of requests to a low value is strongly discouraged and may result in performance degradation.

Informazioni chiave:Key information:

  • Specificare questo valore come un numero intero.Specify this value as a whole integer.
  • Non includere virgole o punti nel valore specificato.Do not include commas or periods in the specified value.

Valore predefinito: 10.000 richiesteDefault Value: 10,000 requests

Intestazioni speciali proxyProxy Special Headers

Scopo: definisce il set di intestazioni di richiesta specifiche della rete CDN che verranno inoltrate da un server perimetrale a un server di origine.Purpose: Defines the set of CDN-specific request headers that will be forwarded from an edge server to an origin server.

Informazioni chiave:Key information:

  • Ogni intestazione di richiesta specifica della rete CDN definita nell'ambito di questa funzionalità verrà inoltrata a un server di origine.Each CDN-specific request header defined in this feature will be forwarded to an origin server.
  • Impedire che un'intestazione di richiesta specifica della rete CDN venga inviata a un server di origine rimuovendola dall'elenco.Prevent a CDN-specific request header from being forwarded to an origin server by removing it from this list.

Comportamento predefinito: tutte le intestazioni di richiesta specifiche della rete CDN verranno inoltrate al server di origine.Default Behavior: All CDN-specific request headers will be forwarded to the origin server.

Funzionalità specializzateSpecialty

Queste funzionalità offrono caratteristiche avanzate che devono essere usate solo dagli utenti esperti.These features provide advanced functionality that should only be used by advanced users.

NomeName ScopoPurpose
Metodi HTTP inseribile nella cacheCacheable HTTP Methods Determina il set di metodi HTTP aggiuntivi che possono essere memorizzati nella cache nella rete.Determines the set of additional HTTP methods that can be cached on our network.
Dimensioni corpo richiesta inseribile nella cacheCacheable Request Body Size Definisce la soglia per determinare se una risposta POST può essere memorizzata nella cache.Defines the threshold for determining whether a POST response can be cached.

Metodi HTTP inseribile nella cacheCacheable HTTP Methods

Scopo: determina il set di metodi HTTP aggiuntivi che possono essere memorizzati nella cache nella rete.Purpose: Determines the set of additional HTTP methods that can be cached on our network.

Informazioni chiave:Key information:

  • Questa funzionalità presuppone che le risposte GET vengano sempre memorizzate nella cache.This feature assumes that GET responses should always be cached. Di conseguenza, è opportuno non includere il metodo GET HTTP quando si imposta questa funzionalità.As a result, the GET HTTP method should not be included when setting this feature.
  • Questa funzionalità supporta solo il metodo POST HTTP.This feature only supports the POST HTTP method. Per abilitare la memorizzazione nella cache della risposta POST, impostare questa funzionalità su POST.Enable POST response caching by setting this feature to:POST
  • Per impostazione predefinita, vengono memorizzate nella cache solo le richieste con un corpo di dimensioni inferiori a 14 Kb.By default, only requests whose body is smaller than 14 Kb will be cached. Usare la funzionalità Cacheable Request Body Size (Dimensioni corpo richiesta inseribile nella cache) per impostare le dimensioni massime del corpo della richiesta.Use the Cacheable Request Body Size Feature to set the maximum request body size.

Comportamento predefinito: vengono memorizzate nella cache solo le risposte GET.Default Behavior: Only GET responses will be cached.

Dimensioni corpo richiesta inseribile nella cacheCacheable Request Body Size

Scopo: definisce la soglia per determinare se una risposta POST può essere memorizzata nella cache.Purpose: Defines the threshold for determining whether a POST response can be cached.

Questa soglia viene determinata specificando la dimensione massima del corpo della richiesta.This threshold is determined by specifying a maximum request body size. Non verranno memorizzate nella cache le richieste il cui corpo supera le dimensioni specificate.Requests that contain a larger request body will not be cached.

Informazioni chiave:Key information:

  • Questa funzionalità è applicabile solo se le risposte POST sono idonee per la memorizzazione nella cache.This Feature is only applicable when POST responses are eligible for caching. Usare la funzionalità Cacheable HTTP Methods (Metodi HTTP inseribili nella cache) per abilitare la memorizzazione nella cache di richieste POST.Use the Cacheable HTTP Methods Feature to enable POST request caching.
  • Il corpo della richiesta viene preso in considerazione per:The request body is taken into consideration for:
    • Valori x-www-form-urlencodedx-www-form-urlencoded values
    • Garantire una chiave di cache univocaEnsuring a unique cache-key
  • La definizione di un valore molto alto per le dimensioni massime del corpo della richiesta può rallentare le prestazioni in fase di distribuzione dei contenuti.Defining a large maximum request body size may impact data delivery performance.
    • Valore consigliato: 14 KbRecommended Value: 14 Kb
    • Valore minimo: 1 KbMinimum Value: 1 Kb

Comportamento predefinito: 14 KbDefault Behavior: 14 Kb

URLURL

Queste funzionalità consentono il reindirizzamento o la riscrittura di una richiesta in un URL diverso.These features allow a request to be redirected or rewritten to a different URL.

NomeName ScopoPurpose
Segui reindirizzamentiFollow Redirects Determina se le richieste possono essere reindirizzate al nome host definito nell'intestazione Location restituita da un server di origine del cliente.Determines whether requests can be redirected to the hostname defined in the Location header returned by a customer origin server.
Reindirizzamento URLURL Redirect Reindirizza le richieste tramite l'intestazione Location.Redirects requests via the Location header.
Riscrittura URLURL Rewrite Riscrive l'URL della richiesta.Rewrites the request URL.

Segui reindirizzamentiFollow Redirects

Scopo: determina se le richieste possono essere reindirizzate al nome host definito nell'intestazione Location restituita da un server di origine del cliente.Purpose: Determines whether requests can be redirected to the hostname defined in the Location header returned by a customer origin server.

Informazioni chiave:Key information:

  • Le richieste possono essere reindirizzate solo ai CNAME periferici che corrispondono alla stessa piattaforma.Requests can only be redirected to edge CNAMEs that correspond to the same platform.
ValoreValue RisultatoResult
EnabledEnabled Le richieste possono essere reindirizzate.Requests can be redirected.
DisabledDisabled Le richieste non verranno reindirizzate.Requests will not be redirected.

Comportamento predefinito: Disabled.Default Behavior: Disabled.

Reindirizzamento URLURL Redirect

Scopo: reindirizza le richieste tramite l'intestazione Location.Purpose: Redirects requests via the Location header.

Per configurare questa funzionalità è necessario impostare le opzioni seguenti:The configuration of this feature requires setting the following options:

OpzioneOption DescrizioneDescription
CodiceCode Selezionare il codice di risposta che verrà restituito al richiedente.Select the response code that will be returned to the requester.
Source & Pattern (Origine e modello)Source & Pattern Queste impostazioni definiscono un modello di URI di richiesta che identifica il tipo di richieste che possono essere reindirizzate.These settings define a request URI pattern that identifies the type of requests that may be redirected. Verranno reindirizzate solo le richieste il cui URL soddisfa entrambi i criteri seguenti:Only requests whose URL satisfies both of the following criteria will be redirected:

Origine (o un punto di accesso dei contenuti): selezionare un percorso relativo che identifica un server di origine.Source (or content access point): Select a relative path that identifies an origin server. È costituito dalla sezione "/XXXX/" e dal nome dell'endpoint.This is the "/XXXX/" section and your endpoint name.
Origine (modello): deve essere definito un modello che identifica le richieste in base al percorso relativo.Source (pattern): A pattern that identifies requests by relative path must be defined. Questo modello di espressione regolare deve definire un percorso che inizia immediatamente dopo il punto di accesso dei contenuti selezionato in precedenza (vedere sopra).This regular expression pattern must define a path that starts directly after the previously selected content access point (see above).
- Assicurarsi che i criteri dell'URI di richiesta, ad esempio origine e modello, definiti in precedenza non entrino in conflitto con le condizioni di corrispondenza definite per questa funzionalità.- Ensure that the request URI criteria (that is, Source & Pattern) previously defined doesn't conflict with any match conditions defined for this feature.
- Specificare un criterio; se si usa un valore vuoto come criterio, viene eseguito il confronto di tutte le stringhe.- Specify a pattern; if you use a blank value as the pattern, all strings are matched.
DestinationDestination Definire l'URL a cui verranno reindirizzate le richieste precedenti.Define the URL to which the above requests will be redirected.
Costruire l'URL in modo dinamico usando:Dynamically construct this URL using:
- Un modello di espressione regolare- A regular expression pattern
- Variabili HTTP- HTTP variables
Sostituire nel modello di destinazione i valori acquisiti nel modello di origine usando $n dove n identifica un valore in base all'ordine in cui è stato acquisito.Substitute the values captured in the source pattern into the destination pattern using $n where n identifies a value by the order in which it was captured. Ad esempio, $1 rappresenta il primo valore acquisito nel modello di origine e $2 rappresenta il secondo valore.For example, $1 represents the first value captured in the source pattern, while $2 represents the second value.

È consigliabile usare un URL assoluto,It is highly recommended to use an absolute URL. poiché l'uso di un URL relativo può reindirizzare gli URL CDN su un percorso non valido.The use of a relative URL may redirect CDN URLs to an invalid path.

Scenario di esempioSample Scenario

In questo esempio viene descritto come reindirizzare un URL CNAME periferico che viene risolto in questo URL CDN di base: http://marketing.azureedge.net/brochuresIn this example, we will demonstrate how to redirect an edge CNAME URL that resolves to this base CDN URL: http://marketing.azureedge.net/brochures

Le richieste idonee verranno reindirizzate a questo URL CNAME periferico di base: http://cdn.mydomain.com/resourcesQualifying requests will be redirected to this base edge CNAME URL: http://cdn.mydomain.com/resources

Questo reindirizzamento URL può essere ottenuto tramite la configurazione seguente: This URL redirection may be achieved through the following configuration:

Punti principali:Key points:

Riscrittura URLURL Rewrite

Scopo: riscrive l'URL della richiesta.Purpose: Rewrites the request URL.

Informazioni chiave:Key information:

  • Per configurare questa funzionalità è necessario impostare le opzioni seguenti:The configuration of this feature requires setting the following options:
OpzioneOption DescrizioneDescription
Source & Pattern (Origine e modello)Source & Pattern Queste impostazioni definiscono un modello di URI di richiesta che identifica il tipo di richieste che possono essere riscritte.These settings define a request URI pattern that identifies the type of requests that may be rewritten. Verranno riscritte solo le richieste il cui URL soddisfa entrambi i criteri seguenti:Only requests whose URL satisfies both of the following criteria will be rewritten:
- Origine (o un punto di accesso dei contenuti): selezionare un percorso relativo che identifica un server di origine.- Source (or content access point): Select a relative path that identifies an origin server. È costituito dalla sezione "/XXXX/" e dal nome dell'endpoint.This is the "/XXXX/" section and your endpoint name.
- Origine (modello): deve essere definito un modello che identifica le richieste in base al percorso relativo.- Source (pattern): A pattern that identifies requests by relative path must be defined. Questo modello di espressione regolare deve definire un percorso che inizia immediatamente dopo il punto di accesso dei contenuti selezionato in precedenza (vedere sopra).This regular expression pattern must define a path that starts directly after the previously selected content access point (see above).
Assicurarsi che i criteri dell'URI di richiesta, ad esempio origine e modello, definiti in precedenza non entrino in conflitto con le condizioni di corrispondenza definite per questa funzionalità.Verify that the request URI criteria (that is, Source & Pattern) previously defined doesn't conflict with any of the match conditions defined for this feature. Specificare un criterio; se si usa un valore vuoto come criterio, tutte le stringhe vengono confrontate.Specify a pattern; if you use a blank value as the pattern, all strings are matched.
DestinationDestination Definire l'URL relativo in cui verranno riscritte le richieste precedenti:Define the relative URL to which the above requests will be rewritten by:
1. Selezionando un punto di accesso dei contenuti che identifichi un server di origine.1. Selecting a content access point that identifies an origin server.
2. Definendo di un percorso tramite:2. Defining a relative path using:
- Un modello di espressione regolare- A regular expression pattern
- Variabili HTTP- HTTP variables

Sostituire nel modello di destinazione i valori acquisiti nel modello di origine usando $n dove n identifica un valore in base all'ordine in cui è stato acquisito.Substitute the values captured in the source pattern into the destination pattern using $n where n identifies a value by the order in which it was captured. Ad esempio, $1 rappresenta il primo valore acquisito nel modello di origine e $2 rappresenta il secondo valore.For example, $1 represents the first value captured in the source pattern, while $2 represents the second value.

Questa funzionalità consente ai server periferici di riscrivere l'URL senza eseguire un reindirizzamento tradizionale.This feature allows our edge servers to rewrite the URL without performing a traditional redirect. In questo modo, il richiedente riceverà lo stesso codice di risposta come se fosse stato richiesto l'URL riscritto.This means that the requester will receive the same response code as if the rewritten URL had been requested.

Scenario di esempio 1Sample Scenario 1

Questo esempio dimostra come reindirizzare un URL CNAME periferico che viene risolto in questo URL CDN di base: http://marketing.azureedge.net/brochures/In this example, we will demonstrate how to redirect an edge CNAME URL that resolves to this base CDN URL: http://marketing.azureedge.net/brochures/

Le richieste idonee verranno reindirizzate a questo URL CNAME periferico di base: http://MyOrigin.azureedge.net/resources/Qualifying requests will be redirected to this base edge CNAME URL: http://MyOrigin.azureedge.net/resources/

Questo reindirizzamento URL può essere ottenuto tramite la configurazione seguente: This URL redirection may be achieved through the following configuration:

Scenario di esempio 2Sample Scenario 2

Questo esempio dimostra come reindirizzare un URL CNAME periferico da MAIUSCOLO a minuscolo mediante espressioni regolari.In this example, we will demonstrate how to redirect an edge CNAME URL from UPPERCASE to lowercase using regular expressions.

Questo reindirizzamento URL può essere ottenuto tramite la configurazione seguente: This URL redirection may be achieved through the following configuration:

Punti principali:Key points:

  • La funzionalità di riscrittura URL definisce gli URL di richiesta che verranno riscritti.The URL Rewrite feature defines the request URLs that will be rewritten. Non sono quindi necessarie condizioni di corrispondenza aggiuntive.As a result, additional match conditions are not required. Anche se la condizione di corrispondenza è stata definita come "Always" (Sempre), verranno riscritte solo le richieste che puntano alla cartella "brochures" nell'origine cliente "marketing".Although the match condition was defined as "Always," only requests that point to the "brochures" folder on the "marketing" customer origin will be rewritten.

  • I segmenti di URL acquisiti dalla richiesta vengono aggiunti al nuovo URL tramite "$1."The URL segments that were captured from the request are appended to the new URL via "$1."

CompatibilitàCompatibility

Questa funzionalità include i criteri di corrispondenza che devono essere soddisfatti affinché possa essere applicata a una richiesta.This feature includes matching criteria that must be met before it can be applied to a request. Per evitare conflitti tra i criteri di corrispondenza impostati, questa funzionalità non è compatibile con le seguenti condizioni di corrispondenza:In order to prevent setting up conflicting match criteria, this feature is incompatible with the following match conditions:

  • Numero ASAS Number
  • Origine CDNCDN Origin
  • Indirizzo IP clientClient IP Address
  • Origine clienteCustomer Origin
  • Schema richiestaRequest Scheme
  • Directory percorso URLURL Path Directory
  • Estensione percorso URLURL Path Extension
  • Nome file percorso URLURL Path Filename
  • Valore letterale percorso URLURL Path Literal
  • Espressione regolare percorso URLURL Path Regex
  • Carattere jolly percorso URLURL Path Wildcard
  • Valore letterale query URLURL Query Literal
  • Parametro query URLURL Query Parameter
  • Espressione regolare query URLURL Query Regex
  • Carattere jolly query URLURL Query Wildcard

Passaggi successiviNext Steps