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

Questo articolo offre una descrizione dettagliata delle funzionalità disponibili per il motore regole della rete di distribuzione dei contenuti (CDN) di Azure.This article 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 viene applicata al tipo di richiesta identificata da un set di condizioni di corrispondenza.A feature defines the type of action that is applied to the request type that is identified by a set of match conditions.

Funzionalità di accessoAccess features

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

NOMEName ScopoPurpose
Deny Access (403) (Nega accesso (403))Deny Access (403) Determina se tutte le richieste vengono rifiutate con una risposta 403 Accesso negato.Determines whether all requests are rejected with a 403 Forbidden response.
Token Auth (Autenticazione token)Token Auth Determina se l'autenticazione basata su token viene applicata a una richiesta.Determines whether Token-Based Authentication is applied to a request.
Token Auth Denial Code (Codice rifiuto autenticazione token)Token Auth Denial Code Determina il tipo di risposta che viene restituita a un utente quando una richiesta viene rifiutata a causa dell'autenticazione basata su token.Determines the type of response that is returned to a user when a request is denied due to token-based authentication.
Token Auth Ignore URL Case (Ignora maiuscole/minuscole URL autenticazione token)Token Auth Ignore URL Case Determina se viene applicata la distinzione tra maiuscole e minuscole nei confronti tra URL eseguiti dall'autenticazione basata su token.Determines whether URL comparisons made by Token-Based Authentication are case-sensitive.
Token Auth Parameter (Parametro autenticazione token)Token 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.

Funzionalità di cachingCaching features

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
Bandwidth Parameters (Parametri larghezza di banda)Bandwidth Parameters Determina se i parametri di limitazione della larghezza di banda, ad esempio ec_rate ed ec_prebuf, sono attivi.Determines whether bandwidth throttling parameters (for example, ec_rate and ec_prebuf) are active.
Bandwidth Throttling (Limitazione larghezza di banda)Bandwidth Throttling Limita la larghezza di banda per la risposta fornita dal POP (Point-Of-Presence).Throttles the bandwidth for the response provided by the point-of-presence (POP).
Bypass Cache (Ignora cache)Bypass Cache Determina se la richiesta deve ignorare la memorizzazione nella cache.Determines whether the request should bypass caching.
Cache-Control Header Treatment (Gestione intestazione Cache-Control)Cache-Control Header Treatment Controlla la generazione di intestazioni Cache-Control da parte del POP quando la funzionalità External Max-Age (Validità massima esterna) è attiva.Controls the generation of Cache-Control headers by the POP when External Max-Age feature is active.
Cache-Key Query String (Stringa di query chiave cache)Cache-Key Query String Determina se la chiave della cache include o esclude i parametri della stringa di query associati a una richiesta.Determines whether the cache-key includes or excludes query string parameters associated with a request.
Cache-Key Rewrite (Riscrittura chiave cache)Cache-Key Rewrite Riscrive la chiave della cache associata a una richiesta.Rewrites the cache-key associated with a request.
Complete Cache Fill (Riempimento completo della cache)Complete Cache Fill Determina ciò che accade quando una richiesta ha come risultato un mancato riscontro nella cache parziale su un POP.Determines what happens when a request results in a partial cache miss on a POP.
Compress File Types (Comprimi tipi di file)Compress File Types Definisce i formati per i file compressi nel server.Defines the file formats for the files that are compressed on the server.
Default Internal Max-Age (Validità massima interna predefinita)Default Internal Max-Age Determina l'intervallo massimo di validità predefinito per la riconvalida della cache dal POP al server di origine.Determines the default max-age interval for POP to origin server cache revalidation.
Expires Header Treatment (Gestione intestazione Expires)Expires Header Treatment Controlla la generazione di intestazioni Expires da parte di un POP quando la funzionalità External Max-Age (Validità massima esterna) è attiva.Controls the generation of Expires headers by a POP when the External Max-Age feature is active.
External Max-Age (Validità massima esterna)External Max-Age Determina l'intervallo massimo di validità per la riconvalida della cache dal browser al POP.Determines the max-age interval for browser to POP cache revalidation.
Force Internal Max-Age (Forza validità massima interna)Force Internal Max-Age Determina l'intervallo massimo di validità per la riconvalida della cache dal POP al server di origine.Determines the max-age interval for POP to origin server cache revalidation.
H.264 Support (HTTP Progressive Download) (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.
Honor No-Cache Request (Rispetta richiesta no-cache)Honor No-Cache Request Determina se le richieste no-cache di un client HTTP vengono inoltrate al server di origine.Determines whether an HTTP client's no-cache requests are forwarded to the origin server.
Ignore Origin No-Cache (Ignora no-cache origine)Ignore Origin No-Cache Determina se la rete CDN deve ignorare alcune direttive servite da un server di origine.Determines whether the CDN ignores certain directives served from an origin server.
Ignore Unsatisfiable Ranges (Ignora gli intervalli che non è possibile soddisfare)Ignore Unsatisfiable Ranges Determina la risposta che viene restituita ai client quando una richiesta genera un codice di stato 416 - Impossibile attenersi all'intervallo richiesto.Determines the response that is returned to clients when a request generates a 416 Requested Range Not Satisfiable status code.
Internal Max-Stale (Tempo di non aggiornamento massimo interno)Internal Max-Stale Controlla l'intervallo di tempo dopo la normale scadenza in cui un asset memorizzato nella cache può essere servito da un POP quando il POP 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 a POP when the POP is unable to revalidate the cached asset with the origin server.
Partial Cache Sharing (Condivisione cache parziale)Partial Cache Sharing Determina se una richiesta può generare contenuto parzialmente memorizzato nella cache.Determines whether a request can generate partially cached content.
Prevalidate Cached Content (Preconvalida contenuto memorizzato nella cache)Prevalidate Cached Content Determina se il contenuto memorizzato nella cache è idoneo per la riconvalida anticipata prima della scadenza della durata (TTL).Determines whether cached content is eligible for early revalidation before its TTL expires.
Refresh Zero-Byte Cache Files (Aggiorna file della cache con zero byte)Refresh Zero-Byte Cache Files Determina come viene gestita dai POP una richiesta di un asset della cache con 0 byte inviata da un client HTTP.Determines how an HTTP client's request for a 0-byte cache asset is handled by the POPs.
Set Cacheable Status Codes (Imposta codici di stato inseribili nella cache)Set 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.
Stale Content Delivery on Error (Distribuzione di contenuto non aggiornato in caso di errore)Stale Content Delivery on Error Determina se il contenuto scaduto memorizzato nella cache viene 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 is delivered when an error occurs during cache revalidation or when retrieving the requested content from the customer origin server.
Stale While Revalidate (Client non aggiornato durante la riconvalida)Stale While Revalidate Migliora le prestazioni consentendo ai POP di servire un client non aggiornato al richiedente mentre avviene la riconvalida.Improves performance by allowing the POPs to serve stale client to the requester while revalidation takes place.

Funzionalità di commentoComment feature

Questa funzionalità è progettata per fornire informazioni aggiuntive all'interno di una regola.This feature is designed to provide additional information within a rule.

NOMEName ScopoPurpose
CommentComment Consente di aggiungere una nota all'interno di una regola.Allows a note to be added within a rule.

Funzionalità di intestazioneHeader features

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
Age Response Header (Intestazione di risposta Age)Age Response Header Determina se un'intestazione di risposta Age viene inclusa nella risposta inviata al richiedente.Determines whether an Age response header is included in the response sent to the requester.
Debug Cache Response Headers (Intestazioni di risposta di debug per la cache)Debug 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.
Modify Client Request Header (Modifica intestazione richiesta client)Modify Client Request Header Sovrascrive, aggiunge o elimina un'intestazione da una richiesta.Overwrites, appends, or deletes a header from a request.
Modify Client Response Header (Modifica intestazione risposta client)Modify Client Response Header Sovrascrive, aggiunge o elimina un'intestazione da una risposta.Overwrites, appends, or deletes a header from a response.
Set Client IP Custom Header (Imposta intestazione personalizzata IP client)Set 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.

Funzionalità di registrazioneLogging features

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
Custom Log Field 1 (Campo 1 log personalizzato)Custom Log Field 1 Determina il formato e il contenuto che vengono assegnati al campo di log personalizzato in un file di log non elaborato.Determines the format and the content that is assigned to the custom log field in a raw log file.
Log Query String (Stringa di query log)Log Query String Determina se una stringa di query viene archiviata insieme all'URL nei log di accesso.Determines whether a query string is stored along with the URL in access logs.

Funzionalità di origineOrigin features

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
Maximum Keep-Alive Requests (Numero massimo di richieste Keep-Alive)Maximum 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.
Proxy Special Headers (Intestazioni speciali proxy)Proxy Special Headers Definisce il set di intestazioni di richiesta specifiche della rete CDN che vengono inoltrate da un POP a un server di origine.Defines the set of CDN-specific request headers that are forwarded from a POP to an origin server.

Funzionalità specializzateSpecialty features

Queste funzionalità offrono caratteristiche avanzate per gli utenti esperti.These features provide advanced functionality for advanced users.

NOMEName ScopoPurpose
Cacheable HTTP Methods (Metodi HTTP inseribili nella cache)Cacheable 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 the network.
Cacheable Request Body Size (Dimensioni corpo richiesta inseribile nella cache)Cacheable 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.
User Variable (Variabile utente)User Variable Solo per uso interno.For internal use only.

Funzionalità URLURL features

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
Follow Redirects (Segui reindirizzamenti)Follow 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.
URL Redirect (Reindirizzamento URL)URL Redirect Reindirizza le richieste tramite l'intestazione Location.Redirects requests via the Location header.
URL Rewrite (Riscrittura URL)URL Rewrite Riscrive l'URL della richiesta.Rewrites the request URL.

Riferimento per le funzionalità del motore regole della rete CDN di AzureAzure CDN rules engine features reference


Intestazione di risposta AgeAge Response Header

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

ValoreValue RisultatoResult
AttivatoEnabled L'intestazione di risposta Age viene inclusa nella risposta inviata al richiedente.The Age response header is included in the response sent to the requester.
DisabledDisabled L'intestazione di risposta Age viene esclusa dalla risposta inviata al richiedente.The Age response header is excluded from the response sent to the requester.

Comportamento predefinito:: Disabled.Default Behavior: Disabled.

Torna all'inizioBack to top



Parametri larghezza di bandaBandwidth Parameters

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

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

ValoreValue RisultatoResult
AttivatoEnabled Consente ai POP di soddisfare le richieste di limitazione della larghezza di banda.Allows the POPs to honor bandwidth throttling requests.
DisabledDisabled Fa in modo che i POP ignorino i parametri di limitazione della larghezza di banda.Causes the POPs to ignore bandwidth throttling parameters. I contenuti richiesti vengono serviti normalmente, ossia senza limitazione della larghezza di banda.The requested content is served normally (that is, without bandwidth throttling).

Comportamento predefinito: Enabled.Default Behavior: Enabled.

Torna all'inizioBack to top



Limitazione larghezza di bandaBandwidth Throttling

Scopo: limita la larghezza di banda per la risposta fornita dai POP.Purpose: Throttles the bandwidth for the response provided by the POPs.

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 che i POP devono attendere prima che sia attivata la limitazione della larghezza di banda.Set this option to the number of seconds for the POPs to wait until bandwidth is throttled. 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.

Torna all'inizioBack to top



Ignora cacheBypass Cache

Scopo: determina se la richiesta deve ignorare la memorizzazione nella cache.Purpose: Determines whether the request should bypass caching.

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

Comportamento predefinito:Default Behavior:

  • HTTP Large: DisabledHTTP Large: Disabled

Torna all'inizioBack to top



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 the 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 supports only 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 are 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 are cached.

Torna all'inizioBack to top



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 vengono memorizzate nella cache le richieste il cui corpo supera le dimensioni specificate.Requests that contain a larger request body are not 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

Torna all'inizioBack to top



Gestione intestazione Cache-ControlCache-Control Header Treatment

Scopo: controlla la generazione di intestazioni Cache-Control da parte del POP quando la funzionalità External Max-Age (Validità massima esterna) è attiva.Purpose: Controls the generation of Cache-Control headers by the POP 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 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 occur:
- 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 viene eseguito il pass-through all'utente finale.If the origin server produces a Cache-Control header, it passes 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 are 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, viene rimossa dalla risposta di intestazione.If a Cache-Control header has already been assigned, then it is removed from the header response.

Comportamento predefinito: Overwrite.Default Behavior: Overwrite.

Torna all'inizioBack to top



Stringa di query chiave cacheCache-Key Query String

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

Informazioni chiave:Key information:

  • Specificare uno o più nomi di parametro di stringa di query e separare ogni nome di parametro con uno spazio singolo.Specify one or more query string parameter names and separate each parameter name with a single space.
  • Questa funzionalità determina se nella chiave di cache i parametri della stringa di query vengono inclusi o esclusi.This feature determines whether query string parameters are included or excluded from the cache-key. La tabella seguente contiene informazioni aggiuntive per ogni opzione.Additional information is provided for each option in the following table.
typeType 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. Viene 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 is generated for each request that contains a unique value for a query string parameter defined in this feature.
Includi tuttoInclude All Indica che viene creata una chiave di cache univoca per ogni richiesta a un asset contenente una stringa di query univoca.Indicates that a unique cache-key is created for each request to an asset that includes a unique query string. Questo tipo di configurazione in genere non è consigliato, perché può comportare una piccola percentuale di riscontri nella cache.This type of configuration is not typically recommended because it can lead to a small percentage of cache hits. Un numero ridotto di riscontri nella cache produce un aumento del carico sul server di origine, che deve gestire un maggior numero di richieste.A low number of cache hits increases the load on the origin server, because it must 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 vengono esclusi dalla chiave di cache solo i parametri specificati.Indicates that only the specified parameter(s) is excluded from the cache-key. Vengono inclusi invece tutti gli altri parametri della stringa di query.All other query string parameters are included in the cache-key.
Escludi tuttoExclude All Indica che vengono esclusi dalla chiave di cache tutti i parametri della stringa di query.Indicates that all query string parameters are excluded from the cache-key. Questa configurazione consente di duplicare il comportamento di memorizzazione nella cache predefinito "standard-cache" nella pagina di memorizzazione nella cache della stringa di query.This configuration duplicates the "standard-cache" default caching behavior on the Query-String Caching page.

Il motore regole consente di personalizzare il modo in cui viene implementata la memorizzazione nella cache della stringa di query.The 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 is performed only on certain locations or file types.

Per duplicare il comportamento di memorizzazione nella cache della stringa di query noto come "no-cache" nella pagina di memorizzazione nella cache della stringa, creare una regola contenente una condizione di corrispondenza URL Query Wildcard (Carattere jolly query URL) e una funzionalità Bypass Cache (Ignora cache).To duplicate the "no-cache" query string caching behavior on the Query-String Caching page, create a rule that contains a URL Query Wildcard match condition and a Bypass Cache feature. Impostare la condizione di corrispondenza URL Query Wildcard (Carattere jolly query URL) su un asterisco (*).Set the URL Query Wildcard match condition to an asterisk (*).

Importante

Se per un qualsiasi percorso in questo account è abilitata l'autorizzazione basata su token, è possibile usare solo la modalità standard-cache per la memorizzazione nella cache delle stringhe di query.If token authorization is enabled for any path on this account, standard-cache mode is the only mode that can be used for query string caching. Per altre informazioni, vedere Controllare il comportamento di memorizzazione nella cache della rete CDN di Azure con stringhe di query.For more information, see Control Azure CDN caching behavior with query strings.

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.<Dominio>/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

Torna all'inizioBack to top



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, the servers 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 viene riscritta la chiave di cache.Define the relative path to the types of requests whose cache-key is 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 HTTP.This 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.

Torna all'inizioBack to top



CommentComment

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.

Torna all'inizioBack to top



Completa riempimento cacheComplete Cache Fill

Scopo: determina ciò che accade quando una richiesta ha come risultato un mancato riscontro nella cache parziale su un POP.Purpose: Determines what happens when a request results in a partial cache miss on a POP.

Un mancato riscontro nella cache parziale descrive lo stato della cache relativo a un asset non completamente scaricato in un POP.A partial cache miss describes the cache status for an asset that was not completely downloaded to a POP. Se un asset è stato solo parzialmente memorizzato nella cache di un POP, la richiesta successiva dell'asset verrà nuovamente inoltrata al server di origine.If an asset is only partially cached on a POP, 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 that are not typically downloaded 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.

Mantenere 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.Keep the default configuration for the HTTP Large platform, because it reduces the load on your customer origin server and increases the speed at which your customers download your content.

ValoreValue RisultatoResult
AttivatoEnabled Ripristina il comportamento predefinito.Restores the default behavior. Il comportamento predefinito prevede di obbligare il POP a inizializzare il recupero in background dell'asset dal server di origine.The default behavior is to force the POP to initiate a background fetch of the asset from the origin server. Al termine di questa operazione, l'asset si troverà nella cache locale del POP.After which, the asset will be in the POP's local cache.
DisabledDisabled Impedisce a un POP di eseguire il recupero in background dell'asset.Prevents a POP from performing a background fetch for the asset. Per effetto di questa impostazione, alla successiva richiesta dell'asset dalla stessa area, il POP richiederà l'asset al server di origine del cliente.The result is that the next request for that asset from that region causes a POP to request it from the customer origin server.

Comportamento predefinito: Enabled.Default Behavior: Enabled.

CompatibilitàCompatibility

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:

  • Numero ASAS Number
  • Indirizzo IP clientClient IP Address
  • Parametro cookieCookie Parameter
  • Espressione regolare parametro cookieCookie Parameter Regex
  • PaeseCountry
  • DispositivoDevice
  • CNAME perifericoEdge Cname
  • Dominio di riferimentoReferring Domain
  • Valore letterale intestazione richiestaRequest Header Literal
  • Espressione regolare intestazione richiestaRequest Header Regex
  • Carattere jolly intestazione richiestaRequest Header Wildcard
  • Metodo richiestaRequest Method
  • Schema richiestaRequest Scheme
  • Valore letterale query URLURL Query Literal
  • Espressione regolare query URLURL Query Regex
  • Carattere jolly query URLURL Query Wildcard
  • Parametro query URLURL Query Parameter

Torna all'inizioBack to top



Comprimi tipi di fileCompress File Types

Scopo: definisce i formati per i file compressi nel server.Purpose: Defines the file formats for the files that are 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 da 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 the 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à comprime solo asset con dimensioni inferiori a 1 MB.This feature only compresses assets whose size is less than 1 MB. Gli asset con dimensioni superiori non vengono compressi dai server.Larger assets are not compressed by the 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. Poiché un'ulteriore compressione di questi tipi di asset non ne diminuisce in modo significativo le dimensioni, è consigliabile non abilitare la compressione su di essi.Because additional compression on these types of assets does not significantly diminish file size, it is recommended that you do not enable compression on them.
  • 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 viene 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 is applied.

Torna all'inizioBack to top



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.

Questo campo personalizzato consente all'utente di determinare i valori delle intestazioni di richiesta e di risposta che vengono archiviati nei file di log.This custom field allows you to determine which request and response header values are 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." Il nome di questo campo può essere personalizzato dalla pagina delle impostazioni del file di log non elaborato.The name of this field can be customized from the Raw Log Settings page.

Il formato per specificare le intestazioni di richiesta e risposta è definito come segue:The format for specifying request and response headers is defined as follows:

Tipo di intestazioneHeader Type FormatFormat EsempiExamples
Intestazione di richiestaRequest Header %{[RequestHeader]()}[i]() %{Accept-Encoding}i%{Accept-Encoding}i
{Referer}i{Referer}i
%{Authorization}i%{Authorization}i
Intestazione di rispostaResponse Header %{[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 sono i seguenti: 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 are as follows: 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 vogliono specificare più intestazioni, usare un separatore per indicare ogni intestazione.If you want to specify multiple headers, 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:
    • 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: -

Torna all'inizioBack to top



Intestazioni di risposta di debug per la cacheDebug Cache Response Headers

Scopo: determina se una risposta può includere intestazioni di risposta X-EC-Debug, che forniscono informazioni sui criteri di cache per l'asset richiesto.Purpose: Determines whether a response can include X-EC-Debug response headers, 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 specificata è 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 specified request.
  • La richiesta specificata definisce il set di intestazioni di risposta di debug per la cache che verrà incluso nella risposta.The specified 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 specificate:Debug cache response headers may be requested by including the following header and the specified directives in the request:

X-EC-Debug: _&lt;Directive1&gt;_,_&lt;Directive2&gt;_,_&lt;DirectiveN&gt;_

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
AttivatoEnabled 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.

Torna all'inizioBack to top



Max-Age interno predefinitoDefault Internal Max-Age

Scopo: determina l'intervallo massimo di validità predefinito per la riconvalida della cache dal POP al server di origine.Purpose: Determines the default max-age interval for POP to origin server cache revalidation. In altre parole, la quantità di tempo che deve trascorrere prima che un POP 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 a POP 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 i tipi di riconvalida della cache dal browser al POP.This action does not affect browser to POP cache revalidations. Questi tipi di riconvalida 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 POP, ma possono influire sulla quantità di traffico di riconvalida inviato dai POP al server di origine.The results of this action do not have an observable effect on the response headers and the content returned from POPs for your content, but it may have an effect on the amount of revalidation traffic sent from POPs 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 predefinito di 7 giorni per le 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.

Valore predefinito: 7 giorniDefault Value: 7 days

CompatibilitàCompatibility

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:

  • Numero ASAS Number
  • Indirizzo IP clientClient IP Address
  • Parametro cookieCookie Parameter
  • Espressione regolare parametro cookieCookie Parameter Regex
  • PaeseCountry
  • DispositivoDevice
  • CNAME perifericoEdge Cname
  • Dominio di riferimentoReferring Domain
  • Valore letterale intestazione richiestaRequest Header Literal
  • Espressione regolare intestazione richiestaRequest Header Regex
  • Carattere jolly intestazione richiestaRequest Header Wildcard
  • Metodo richiestaRequest Method
  • Schema richiestaRequest Scheme
  • Valore letterale query URLURL Query Literal
  • Espressione regolare query URLURL Query Regex
  • Carattere jolly query URLURL Query Wildcard
  • Parametro query URLURL Query Parameter

Torna all'inizioBack to top



Deny Access (403) (Nega accesso (403))Deny Access (403)

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
AttivatoEnabled 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.

Torna all'inizioBack to top



Gestione intestazione ExpiresExpires Header Treatment

Scopo: controlla la generazione di intestazioni Expires da parte di un POP quando la funzionalità External Max-Age (Validità massima esterna) è attiva.Purpose: Controls the generation of Expires headers by a POP 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 verrà 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, viene rimossa dalla risposta di intestazione.If an Expires header has already been assigned, then it is removed from the header response.

Comportamento predefinito: OverwriteDefault Behavior: Overwrite

Torna all'inizioBack to top



Max-Age esternoExternal Max-Age

Scopo: determina l'intervallo massimo di validità per la riconvalida della cache dal browser al POP.Purpose: Determines the max-age interval for browser to POP 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 POP.In other words, the amount of time that will pass before a browser can check for a new version of an asset from a POP.

Abilitando questa funzionalità, dai POP verranno generate intestazioni Cache-Control: max-age e Expires che saranno inviate al client HTTP.Enabling this feature will generate Cache-Control: max-age and Expires headers from the POPs 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 headers 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 i tipi di riconvalida della cache dal POP al server di origine.This action does not affect POP to origin server cache revalidations. Questi tipi di riconvalida vengono determinati dalle intestazioni Cache-Control e 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 and 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, i POP includeranno una direttiva Cache-Control: no-cache e un valore temporale Expires impostato nel passato in ogni risposta inviata al browser.Setting this feature to a negative value causes the POPs to send a Cache-Control: no-cache and an Expires time that is set in the past with each response to the browser. Anche se un client HTTP non memorizza la risposta nella cache, questa impostazione non influisce sulla capacità dei POP 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 the POPs' 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 e Expires memorizzate nella cache con la risposta del server di origine viene eseguito il pass-through al browser.The Cache-Control and Expires headers cached with the response of the origin server will pass through to the browser.

Comportamento predefinito: OffDefault Behavior: Off

Torna all'inizioBack to top



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
AttivatoEnabled 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.

Torna all'inizioBack to top



Forza Max-Age internoForce Internal Max-Age

Scopo: determina l'intervallo massimo di validità per la riconvalida della cache dal POP al server di origine.Purpose: Determines the max-age interval for POP to origin server cache revalidation. In altre parole, la quantità di tempo che deve trascorrere prima che un POP 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 a POP 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 i tipi di riconvalida della cache dal browser al POP.This feature does not affect browser to POP cache revalidations. Questi tipi di riconvalida 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 POP al richiedente.This feature does not have an observable effect on the response delivered by a POP to the requester. Può tuttavia influire sulla quantità di traffico di riconvalida inviato dai POP al server di origine.However, it may have an effect on the amount of revalidation traffic sent from the POPs 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.

Comportamento predefinito: OffDefault Behavior: Off

CompatibilitàCompatibility

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:

  • Numero ASAS Number
  • Indirizzo IP clientClient IP Address
  • Parametro cookieCookie Parameter
  • Espressione regolare parametro cookieCookie Parameter Regex
  • PaeseCountry
  • DispositivoDevice
  • CNAME perifericoEdge Cname
  • Dominio di riferimentoReferring Domain
  • Valore letterale intestazione richiestaRequest Header Literal
  • Espressione regolare intestazione richiestaRequest Header Regex
  • Carattere jolly intestazione richiestaRequest Header Wildcard
  • Metodo richiestaRequest Method
  • Schema richiestaRequest Scheme
  • Valore letterale query URLURL Query Literal
  • Espressione regolare query URLURL Query Regex
  • Carattere jolly query URLURL Query Wildcard
  • Parametro query URLURL Query Parameter

Torna all'inizioBack to top



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.
  • Includere un punto per ogni estensione di file specificata, ad esempio .mp4, .f4v.Include a period when you specify 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.

Torna all'inizioBack to top



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
AttivatoEnabled Consente l'inoltro delle richieste no-cache di un client HTTP al server di origine. Quest'ultimo restituirà al client HTTP il corpo e le intestazioni della risposta tramite il POP.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 POP 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 l'invio di 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 is reported for a request that can 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 di monitorare il numero e la percentuale di richieste inoltrate a un server di origine a causa di questa funzionalità.This report 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.

Torna all'inizioBack to top



Ignora origine No-CacheIgnore Origin No-Cache

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

  • Cache-Control: private
  • Cache-Control: no-store
  • Cache-Control: no-cache
  • Pragma: 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.

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

CompatibilitàCompatibility

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:

  • Numero ASAS Number
  • Indirizzo IP clientClient IP Address
  • Parametro cookieCookie Parameter
  • Espressione regolare parametro cookieCookie Parameter Regex
  • PaeseCountry
  • DispositivoDevice
  • CNAME perifericoEdge Cname
  • Dominio di riferimentoReferring Domain
  • Valore letterale intestazione richiestaRequest Header Literal
  • Espressione regolare intestazione richiestaRequest Header Regex
  • Carattere jolly intestazione richiestaRequest Header Wildcard
  • Metodo richiestaRequest Method
  • Schema richiestaRequest Scheme
  • Valore letterale query URLURL Query Literal
  • Espressione regolare query URLURL Query Regex
  • Carattere jolly query URLURL Query Wildcard
  • Parametro query URLURL Query Parameter

Torna all'inizioBack to top



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 POP 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 a POP and an If-Range request header field was not specified.

ValoreValue RisultatoResult
AttivatoEnabled Impedisce ai POP di rispondere a una richiesta di intervallo di byte non valida con un codice di stato 416 - Impossibile attenersi all'intervallo richiesto.Prevents the POPs 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 the 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.

Torna all'inizioBack to top



Max-Stale internoInternal Max-Stale

Scopo: controlla l'intervallo di tempo dopo la normale scadenza in cui un asset memorizzato nella cache può essere servito da un POP quando il POP 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 a POP when the POP is unable to revalidate the cached asset with the origin server.

In genere, quando scade l'intervallo massimo di validità di un asset, il POP invia una richiesta di riconvalida al server di origine.Normally, when an asset's max-age time expires, the POP 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 POP un lease aggiornato sull'asset memorizzato nella cache o con un codice 200 - OK per fornire al POP una versione aggiornata dell'asset memorizzato nella cache.The origin server will then respond with either a 304 Not Modified to give the POP a fresh lease on the cached asset, or else with 200 OK to provide the POP with an updated version of the cached asset.

Se il POP 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 POP può continuare a servire l'asset non aggiornato.If the POP 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 POP 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 quando un asset viene inizialmente memorizzato nella cache, il POP 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 POP will not serve a stale cached asset. In questo caso, se il POP non è in grado di eseguire la riconvalida con il server di origine alla scadenza dell'intervallo massimo di validità dell'asset, restituisce un errore 504 - Timeout gateway.In such a case, if the POP is unable to revalidate with the origin when the asset's max-age interval has expired, the POP returns a 504 Gateway Timeout error.

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.

Comportamento predefinito: due minutiDefault Behavior: Two minutes

CompatibilitàCompatibility

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:

  • Numero ASAS Number
  • Indirizzo IP clientClient IP Address
  • Parametro cookieCookie Parameter
  • Espressione regolare parametro cookieCookie Parameter Regex
  • PaeseCountry
  • DispositivoDevice
  • CNAME perifericoEdge Cname
  • Dominio di riferimentoReferring Domain
  • Valore letterale intestazione richiestaRequest Header Literal
  • Espressione regolare intestazione richiestaRequest Header Regex
  • Carattere jolly intestazione richiestaRequest Header Wildcard
  • Metodo richiestaRequest Method
  • Schema richiestaRequest Scheme
  • Valore letterale query URLURL Query Literal
  • Espressione regolare query URLURL Query Regex
  • Carattere jolly query URLURL Query Wildcard
  • Parametro query URLURL Query Parameter

Torna all'inizioBack to top



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
AttivatoEnabled 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.

Torna all'inizioBack to top



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 è sconsigliata e può influire negativamente sulle prestazioni.Setting the maximum number of requests to a low value is 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

Torna all'inizioBack to top



Modifica intestazione richiesta clientModify Client Request 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):Request header value (client):
Value1Value1
Valore intestazione richiesta (motore regole):Request header value (rules engine):
Value2Value2
Valore nuova intestazione richiesta:New request header value:
Value1Value2Value1Value2
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):Request header value (client):
Value1Value1
Valore intestazione richiesta (motore regole):Request header value (rules engine):
Value2Value2
Valore nuova intestazione richiesta:New request header value:
Value2Value2
DeleteDelete Elimina l'intestazione di richiesta specificata.Deletes the specified request header. Valore intestazione richiesta (client):Request header value (client):
Value1Value1
Modificare la configurazione dell'intestazione della richiesta client:Modify client request header configuration:
Eliminare l'intestazione della richiesta in questione.Delete the request header in question.
Risultato:Result:
L'intestazione della richiesta specificata non verrà inoltrata al server di origine.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.
  • Eliminando un'intestazione si impedisce che venga inoltrata dai POP a un server di origine.Deleting a header will prevent it from being forwarded to an origin server by the POPs.
  • 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.

Torna all'inizioBack to top



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 risposta specificata non esiste, questa funzionalità la aggiungerà alla risposta.If the specified response 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 POP.By default, response header values are defined by an origin server and by the POPs.

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 risposta esistente.The specified value will be added to the end of the existing response header value. Valore intestazione risposta (client):Response header value (client):
Value1Value1
Valore intestazione risposta (motore regole):Response header value (rules engine):
Value2Value2
Valore nuova intestazione risposta:New response header value:
Value1Value2Value1Value2
OverwriteOverwrite Il valore dell'intestazione di risposta verrà impostato sul valore specificato.The response header value will be set to the specified value. Valore intestazione risposta (client):Response header value (client):
Value1Value1
Valore intestazione risposta (motore regole):Response header value (rules engine):
Value2Value2
Valore nuova intestazione risposta:New response header value:
Value2Value2
DeleteDelete Elimina l'intestazione di risposta specificata.Deletes the specified response header. Valore intestazione risposta (client):Response header value (client):
Value1Value1
Modificare la configurazione dell'intestazione della risposta client:Modify client response header configuration:
Eliminare l'intestazione della risposta in questione.Delete the response header in question.
Risultato:Result:
L'intestazione della risposta specificata non verrà inoltrata al richiedente.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 prevents 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
    • connessioneconnection
    • 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.

Torna all'inizioBack to top



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
AttivatoEnabled 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.

Torna all'inizioBack to top



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é viene ignorato.Time should not be specified and is 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.

Torna all'inizioBack to top



Intestazioni speciali proxyProxy Special Headers

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

Informazioni chiave:Key information:

  • Ogni intestazione di richiesta specifica della rete CDN definita nell'ambito di questa funzionalità viene inoltrata a un server di origine.Each CDN-specific request header defined in this feature is forwarded to an origin server. Le intestazioni escluse non vengono inoltrate.Excluded headers are not forwarded.
  • Per impedire l'inoltro di un'intestazione di richiesta specifica della rete CDN, rimuoverla dall'elenco separato da spazi nel campo dell'elenco di intestazioni.To prevent a CDN-specific request header from being forwarded, remove it from space-separated list in the header list field.

Le intestazioni HTTP seguenti sono incluse nell'elenco predefinito:The following HTTP headers are included in the default list:

  • ViaVia
  • X-Forwarded-ForX-Forwarded-For
  • X-Forwarded-ProtoX-Forwarded-Proto
  • X-HostX-Host
  • X-MidgressX-Midgress
  • X-Gateway-ListX-Gateway-List
  • X-EC-NameX-EC-Name
  • HostHost

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.

Torna all'inizioBack to top



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

Scopo: determina come viene gestita dai POP una richiesta di un asset della cache con 0 byte inviata da un client HTTP.Purpose: Determines how an HTTP client's request for a 0-byte cache asset is handled by the POPs.

I valori validi sono:Valid values are:

ValoreValue RisultatoResult
AttivatoEnabled Fa in modo che il POP recuperi nuovamente l'asset dal server di origine.Causes the POP 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 POP.For example, dynamic content generators on origin servers can inadvertently result in 0-byte responses being sent to the POPs. Questi tipi di risposte vengono in genere memorizzati nella cache dai POP.These types of responses are typically cached by the POPs. 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.

Torna all'inizioBack to top



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.

Torna all'inizioBack to top



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 viene archiviato l'indirizzo IP del client.The Header name option defines the name of the custom request header where the client's IP address is 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. Di conseguenza, è consigliabile usare questa funzionalità con asset che non vengono memorizzati nella cache.Therefore, it is recommended that this feature be used with assets that aren't 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.

Torna all'inizioBack to top



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

Scopo: 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.Purpose: 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
AttivatoEnabled Se si verifica un errore durante una connessione a un server di origine, al richiedente vengono serviti contenuti non aggiornati.Stale content is 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 is forwarded to the requester.

Comportamento predefinito: DisabledDefault Behavior: Disabled

Torna all'inizioBack to top



Client non aggiornato durante la riconvalidaStale While Revalidate

Scopo: migliora le prestazioni consentendo ai POP di servire contenuti non aggiornati al richiedente mentre è in corso la riconvalida.Purpose: Improves performance by allowing the POPs 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 + Tempo di non aggiornamento durante la riconvalidaThis 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.

Torna all'inizioBack to top



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 is 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.

Comportamento predefinito: Disabled.Default Behavior: Disabled.

Questa funzionalità ha la precedenza sulla maggior parte delle funzionalità ad eccezione di Riscrittura URL.This feature takes precedence over most features with the exception of the URL Rewrite feature.

ValoreValue RisultatoResult
AttivatoEnabled 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.

CompatibilitàCompatibility

Non usare Autenticazione token con una condizione di corrispondenza Sempre.Do not use Token Auth with an Always match condition.

Torna all'inizioBack to top



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.

Nella tabella seguente sono elencati i codici di risposta disponibili.The available response codes are listed in the following table.

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 Questo messaggio è il messaggio di stato standard 403 - Accesso negato che viene visualizzato quando un utente non autorizzato prova ad accedere a contenuti protetti.This message 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.

CompatibilitàCompatibility

Non usare Codice rifiuto autenticazione token con una condizione di corrispondenza Sempre.Do not use Token Auth Denial Code with an Always match condition. Usare invece la sezione Custom Denial Handling (Gestione rifiuto personalizzata) della pagina Token Auth (Token di autenticazione) nel portale Manage (Gestione).Instead, use the Custom Denial Handling section in the Token Auth page of the Manage portal. Per altre informazioni, vedere Protezione di asset della rete CDN di Azure con l'autenticazione basata su token.For more information, see Securing Azure CDN assets with token authentication.

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.

AuthenticationAuthentication

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.

Torna all'inizioBack to top



Maiuscole/minuscole URL autenticazione tokenToken Auth Ignore URL Case

Scopo: determina se viene applicata la distinzione tra maiuscole e minuscole nei confronti tra URL eseguiti dall'autenticazione basata su token.Purpose: Determines whether URL comparisons made by Token-Based Authentication are 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
AttivatoEnabled Fa in modo che il POP non applichi la distinzione tra maiuscole e minuscole quando confronta gli URL per i parametri dell'autenticazione basata su token.Causes the POP 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.

Torna all'inizioBack to top



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
AttivatoEnabled 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.

Torna all'inizioBack to top



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. Questo percorso è costituito dalla sezione /XXXX/ e dal nome dell'endpoint.This path 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

Questo esempio dimostra come reindirizzare un URL CNAME perimetrale che viene risolto nell'URL CDN di base: http://marketing.azureedge.net/brochuresThis example, demonstrates 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 perimetrale 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: Reindirizzamento URLThis URL redirection may be achieved through the following configuration: URL redirect

Punti principali:Key points:

  • La funzionalità Reindirizzamento URL definisce gli URL di richiesta che verranno reindirizzati.The URL Redirect feature defines the request URLs that will be redirected. 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 reindirizzate 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 redirected.
  • Tutte le richieste corrispondenti verranno reindirizzate all'URL CNAME periferico definito nell'opzione Destinazione.All matching requests will be redirected to the edge CNAME URL defined in the Destination option.
    • Scenario di esempio #1:Sample scenario #1:
      • Richiesta di esempio (URL CDN): http://marketing.azureedge.net/brochures/widgets.pSample request (CDN URL): http://marketing.azureedge.net/brochures/widgets.pdf
      • URL richiesta (dopo il reindirizzamento): http://cdn.mydomain.com/resources/widgets.pdfRequest URL (after redirect): http://cdn.mydomain.com/resources/widgets.pdf
    • Scenario di esempio #2:Sample scenario #2:
      • Richiesta di esempio (URL CNAME perimetrale): http://marketing.mydomain.com/brochures/widgets.pdfSample request (Edge CNAME URL): http://marketing.mydomain.com/brochures/widgets.pdf
      • URL richiesta (dopo il reindirizzamento): http://cdn.mydomain.com/resources/widgets.pdfRequest URL (after redirect): http://cdn.mydomain.com/resources/widgets.pdf
    • Scenario di esempio #3:Sample scenario #3:
      • Richiesta di esempio (URL CNAME perimetrale): http://brochures.mydomain.com/campaignA/final/productC.pptSample request (Edge CNAME URL): http://brochures.mydomain.com/campaignA/final/productC.ppt
      • URL richiesta (dopo il reindirizzamento): http://cdn.mydomain.com/resources/campaignA/final/productC.pptRequest URL (after redirect): http://cdn.mydomain.com/resources/campaignA/final/productC.ppt
  • La variabile Schema richiesta (%{scheme}) viene usata nell'opzione Destinazione, che assicura che lo schema della richiesta rimanga invariato dopo il reindirizzamento.The Request Scheme (%{scheme}) variable is leveraged in the Destination option, which ensures that the request's scheme remains unchanged after redirection.
  • 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."

Torna all'inizioBack to top



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. Questo percorso è costituito dalla sezione /XXXX/ e dal nome dell'endpoint.This path 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 POP di riscrivere l'URL senza eseguire un reindirizzamento tradizionale.This feature allows the POPs to rewrite the URL without performing a traditional redirect. Questo significa che il richiedente riceve lo stesso codice di risposta che riceverebbe se avesse richiesto l'URL riscritto.That is, the requester receives 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 perimetrale che viene risolto nell'URL CDN di base: http://marketing.azureedge.net/brochures/This example demonstrates 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 perimetrale 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: Reindirizzamento URLThis URL redirection may be achieved through the following configuration: URL redirect

Scenario di esempio 2Sample Scenario 2

Questo esempio dimostra come reindirizzare un URL CNAME perimetrale da MAIUSCOLO a minuscolo mediante espressioni regolari.This example demonstrates how to redirect an edge CNAME URL from UPPERCASE to lowercase using regular expressions.

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

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

Torna all'inizioBack to top



User Variable (Variabile utente)User Variable

Scopo: solo per uso interno.Purpose: For internal use only.

Torna all'inizioBack to top


Passaggi successiviNext Steps