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

In questo articolo elenca le descrizioni dettagliate delle funzionalità disponibili per Azure rete CDN (Content Delivery) motore regole di business.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 applicato al tipo di richiesta identificato da un set di condizioni di corrispondenza.A feature defines the type of action that is applied to the type of request 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
Negare l'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 AuthToken Auth Determina se l'autenticazione basata su Token viene applicato a una richiesta.Determines whether Token-Based Authentication is applied to a request.
Codice di autorizzazione di token di negazioneToken Auth Denial Code Determina il tipo di risposta restituito all'utente quando una richiesta viene negata 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 Ignora maiuscole/minuscole di URLToken Auth Ignore URL Case Determina se i confronti di URL eseguiti dall'autenticazione basata su Token tra maiuscole e minuscole.Determines whether URL comparisons made by Token-Based Authentication are case-sensitive.
Parametro di token di autenticazioneToken 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
Parametri di larghezza di bandaBandwidth 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.
La limitazione della larghezza di bandaBandwidth Throttling Limita la larghezza di banda per la risposta fornita dal server di bordo.Throttles the bandwidth for the response provided by the edge servers.
Ignorare la CacheBypass Cache Determina se la richiesta deve ignorare la memorizzazione nella cache.Determines whether the request should bypass caching.
Trattamento intestazione Cache-ControlCache-Control Header Treatment Controlla la generazione di Cache-Control intestazioni dal server quando è attiva la funzionalità esterne Max-Age edge.Controls the generation of Cache-Control headers by the edge server when External Max-Age feature is active.
Stringa di Query della chiave di cacheCache-Key Query String Determina se la chiave della cache includerà o escluderà i parametri della stringa di query associati a una richiesta.Determines whether the cache-key will include or exclude query string parameters associated with a request.
Riscrittura di chiave di cacheCache-Key Rewrite Riscrive la chiave della cache associata a una richiesta.Rewrites the cache-key associated with a request.
Riempimento Cache completaComplete Cache Fill Determina ciò che accade quando una richiesta determina un mancato riscontro nella cache parziale in un server perimetrale.Determines what happens when a request results in a partial cache miss on an edge server.
Comprimi tipi di FileCompress File Types Definisce i formati di file che verranno compressi nel server.Defines the file formats that will be compressed on the server.
Max-Age interno predefinitoDefault Internal Max-Age Determina l'intervallo Max-Age predefinito per la riconvalida della cache dal server perimetrale al server di origine.Determines the default max-age interval for edge server to origin server cache revalidation.
Scade il trattamento di intestazioneExpires Header Treatment Controlla la generazione di Expires intestazioni da un server perimetrale quando è attiva la funzionalità esterne Max-Age.Controls the generation of Expires headers by an edge server when the External Max-Age feature is active.
Max-Age esternoExternal Max-Age Determina l'intervallo Max-Age per la riconvalida della cache dal browser al server perimetrale.Determines the max-age interval for browser to edge server cache revalidation.
Forzare Max-Age internoForce Internal Max-Age Determina l'intervallo Max-Age per la riconvalida della cache dal server perimetrale al server di origine.Determines the max-age interval for edge server to origin server cache revalidation.
Supporto h. 264 (Download progressivo HTTP)H.264 Support (HTTP Progressive Download) Determina i tipi di formati di file H.264 che possono essere usati per lo streaming di contenuti.Determines the types of H.264 file formats that may be used to stream content.
Onore No-Cache richiestaHonor No-Cache Request Determina se le richieste no-cache di un client HTTP verranno inoltrate al server di origine.Determines whether an HTTP client's no-cache requests will be forwarded to the origin server.
Ignorare origine No-CacheIgnore Origin No-Cache Determina se la rete CDN ignora alcune direttive servite da un server di origine.Determines whether the CDN ignores certain directives served from an origin server.
Ignorare gli intervalli di situazioneIgnore Unsatisfiable Ranges Determina la risposta restituita al client quando una richiesta genera un codice di stato 416 richiesto non Impossibile attenersi all'intervallo.Determines the response that is returned to clients when a request generates a 416 Requested Range Not Satisfiable status code.
Max-aggiornata internoInternal Max-Stale Controlla per quanto tempo dopo la normale scadenza un asset memorizzato nella cache può essere servito da un server perimetrale quando il server perimetrale non è in grado di riconvalidare l'asset memorizzato nella cache con il server di origine.Controls how long past the normal expiration time a cached asset may be served from an edge server when the edge server is unable to revalidate the cached asset with the origin server.
La condivisione della Cache parzialiPartial Cache Sharing Determina se una richiesta può generare contenuto parzialmente memorizzato nella cache.Determines whether a request can generate partially cached content.
PreValidate contenuto memorizzato nella cachePrevalidate Cached Content Determina se il contenuto memorizzato nella cache sarà idoneo per la riconvalida anticipata prima della scadenza della durata (TTL).Determines whether cached content will be eligible for early revalidation before its TTL expires.
Aggiornare i file di Cache a Zero ByteRefresh Zero-Byte Cache Files Determina come richiesta di un client HTTP per un asset di 0 byte cache è gestito dai server edge.Determines how an HTTP client's request for a 0-byte cache asset is handled by the edge servers.
Impostare i codici di stato memorizzabile nella cacheSet Cacheable Status Codes Definisce il set di codici di stato che possono generare contenuto memorizzato nella cache.Defines the set of status codes that can result in cached content.
Distribuzione di contenuti non aggiornati in caso di erroreStale Content Delivery on Error Determina se il contenuto scaduto memorizzato nella cache verrà distribuito quando si verifica un errore durante la riconvalida della cache o quando si recupera il contenuto richiesto dal server di origine del cliente.Determines whether expired cached content will be delivered when an error occurs during cache revalidation or when retrieving the requested content from the customer origin server.
Obsoleti durante RevalidateStale While Revalidate Migliora le prestazioni, consentendo il server gestire i client non aggiornato al richiedente durante la riconvalida edge.Improves performance by allowing the edge servers 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 una nota da aggiungere 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
Intestazione della risposta AgeAge Response Header Determina se un'intestazione di risposta Age verrà inclusa nella risposta inviata al richiedente.Determines whether an Age response header will be included in the response sent to the requester.
Eseguire il debug di intestazioni di risposta della CacheDebug Cache Response Headers Determina se una risposta può includere l'intestazione della risposta X-EC-Debug, che fornisce informazioni sui criteri della cache per la risorsa richiesta.Determines whether a response may include the X-EC-Debug response header, which provides information on the cache policy for the requested asset.
Modificare l'intestazione della richiesta ClientModify Client Request Header Sovrascrive, aggiunge o elimina un'intestazione da una richiesta.Overwrites, appends, or deletes a header from a request.
Modifica intestazione risposta ClientModify Client Response Header Sovrascrive, aggiunge o elimina un'intestazione da una risposta.Overwrites, appends, or deletes a header from a response.
Impostare l'intestazione personalizzata di IP ClientSet Client IP Custom Header Consente di aggiungere l'indirizzo IP del client richiedente alla richiesta come un'intestazione personalizzata.Allows the IP address of the requesting client to be added to the request as a custom request header.

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

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

Funzionalità specialiSpecialty features

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

NOMEName ScopoPurpose
Metodi HTTP memorizzabile nella cacheCacheable HTTP Methods Determina il set di metodi HTTP aggiuntivi che possono essere memorizzati nella cache nella rete.Determines the set of additional HTTP methods that can be cached on the network.
Dimensione del corpo della richiesta memorizzabile nella cacheCacheable Request Body Size Definisce la soglia per determinare se una risposta POST può essere memorizzata nella cache.Defines the threshold for determining whether a POST response can be cached.
Variabile utenteUser Variable Solo per uso interno.For internal use only.

Funzionalità di 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
Seguire i reindirizzamentiFollow Redirects Determina se le richieste possono essere reindirizzate al nome host definito nell'intestazione Location restituita da un server di origine del cliente.Determines whether requests can be redirected to the hostname defined in the Location header returned by a customer origin server.
Reindirizzamento dell'URLURL Redirect Reindirizza le richieste tramite l'intestazione Location.Redirects requests via the Location header.
Riscrittura URLURL Rewrite Riscrive l'URL della richiesta.Rewrites the request URL.

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


Intestazione di risposta AgeAge Response Header

Scopo: determina se un'intestazione di risposta Age è incluso 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 della risposta Age è incluso nella risposta inviata al richiedente.The Age response header is included in the response sent to the requester.
DisabledDisabled L'intestazione della risposta Age è escluso 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, saranno attivi.Purpose: Determines whether bandwidth throttling parameters (for example, ec_rate and ec_prebuf) will be active.

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

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

Comportamento predefinito: Enabled.Default Behavior: Enabled.

Torna all'inizioBack to top



Limitazione larghezza di bandaBandwidth Throttling

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

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

OpzioneOption DESCRIZIONEDescription
Kbytes per second (KB al secondo)Kbytes per second Impostare questa opzione sulla larghezza di banda massima (KB al secondo) che è possibile usare per inviare la risposta.Set this option to the maximum bandwidth (Kb per second) that may be used to deliver the response.
Prebuf seconds (Secondi prebuf)Prebuf seconds Impostare questa opzione per il numero di secondi per i server edge di attesa fino a quando non viene applicata una limitazione della larghezza di banda.Set this option to the number of seconds for the edge servers 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 sì che tutte le richieste giungano al server di origine, anche se i contenuti sono stati precedentemente memorizzati nella cache dei server perimetrali.Causes all requests to fall through to the origin server, even if the content was previously cached on edge servers.
DisabledDisabled Fa sì che i server perimetrali memorizzino gli asset nella cache in base ai criteri della cache definiti nelle relative intestazioni di risposta.Causes edge servers to cache assets according to the cache policy defined in its response headers.

Comportamento predefinito:Default Behavior:

  • HTTP Large: DisabledHTTP Large: Disabled

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 HTTP POST.This feature supports only the POST HTTP method. Abilitare la memorizzazione nella cache risposta POST tramite l'impostazione di questa funzionalità POST.Enable POST response caching by setting this feature to POST.
  • Per impostazione predefinita, solo le richieste il cui corpo è inferiore a 14 Kb vengono memorizzati nella cache.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 memorizzati 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 verranno memorizzate nella cache le richieste il cui corpo supera le dimensioni specificate.Requests that contain a larger request body will not be cached.

Informazioni chiave:Key information:

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

Comportamento predefinito: 14 KbDefault Behavior: 14 Kb

Torna all'inizioBack to top



Gestione intestazione Cache-ControlCache-Control Header Treatment

Scopo: controlla la generazione di Cache-Control intestazioni dal server di bordo quando la funzione Max-Age esterno è attiva.Purpose: Controls the generation of Cache-Control headers by the edge server when the External Max-Age Feature is active.

Il modo più semplice per ottenere questo tipo di configurazione è inserire le funzionalità External Max-Age (Validità massima esterna) e 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 Assicura che si verificano le azioni seguenti:Ensures that the following actions occur:
-Sovrascrive il Cache-Control intestazione generati dal server di origine.- Overwrites the Cache-Control header generated by the origin server.
-Aggiunge il Cache-Control intestazione generati dalla caratteristica di Max-Age esterno per la risposta.- Adds the Cache-Control header produced by the External Max-Age feature to the response.
Pass-throughPass Through Assicura che il Cache-Control intestazione generati dalla funzionalità esterne Max-Age mai viene aggiunto 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 viene generato un Cache-Control intestazione, passa attraverso l'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 Cache-Control intestazione, quindi questa opzione può causare l'intestazione della risposta non contengono un Cache-Control intestazione.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 Cache-Control intestazione non è stata ricevuta dal server di origine, quindi questa opzione aggiunge il Cache-Control intestazione generati dalla funzionalità esterne Max-Age.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. Questa opzione è utile per garantire che tutte le risorse vengono assegnate un Cache-Control intestazione.This option is useful for ensuring that all assets are assigned a Cache-Control header.
RimuovereRemove Questa opzione garantisce che un Cache-Control intestazione non è inclusa con la risposta di intestazione.This option ensures that a Cache-Control header is not included with the header response. Se un Cache-Control intestazione è già stata assegnata, quindi viene rimosso 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 di cache includerà o escluderà i parametri della stringa di query associati a una richiesta.Purpose: Determines whether the cache-key will include or exclude query string parameters associated with a request.

Informazioni chiave:Key information:

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

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

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

Scenari di esempioSample Scenarios

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

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

Configurazione di esempio:Sample configuration:

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

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

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

Configurazione di esempio:Sample configuration:

  • Tipo: Includi tuttoType: Include All

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

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

Configurazione di esempio:Sample configuration:

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

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

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

Configurazione di esempio:Sample configuration:

  • Tipo: Escludi tuttoType: Exclude All

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

/800001/Origin/folder/asset.htm

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, il server controlla una versione memorizzata nella cache di un asset in base al relativo percorso come definito in base alla chiave di cache.In other words, the servers will check for a cached version of an asset according to its path as defined by its cache-key.

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

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

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

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 genera un mancato riscontro nella cache parziale in un server perimetrale.Purpose: Determines what happens when a request results in a partial cache miss on an edge server.

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

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

Mantenere la configurazione predefinita per la piattaforma di grandi dimensioni HTTP, poiché riduce il carico sul server di origine cliente e aumenta la velocità con cui i clienti scaricare il contenuto.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.

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

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

Comportamento predefinito: Enabled.Default Behavior: Enabled.

Torna all'inizioBack to top



Comprimi tipi di fileCompress File Types

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

Un formato di file può essere specificato usando il rispettivo tipo di elemento multimediale Internet, ad esempio Content-Type.A file format can be specified using its Internet media type (for example, Content-Type). Tipo di supporto Internet è metadati indipendenti dalla piattaforma che consente ai server di identificare il formato di file di una particolare attività.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à comprimerà solo asset con dimensioni inferiori a 1 MB.This feature will only compress assets whose size is less than 1 MB. Non verrà compresso più grande asset dai server.Larger assets will not be 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. Un ulteriore compressione di questi tipi di asset, pertanto, non ne diminuirebbe in modo significativo le dimensioni.Additional compression on these types of assets will not significantly diminish file size. È consigliabile quindi non abilitare la compressione su questi tipi di asset.Therefore, it is recommended that you do not enable compression on these types of assets.
  • Non sono supportati i caratteri jolly come gli asterischi.Wildcard characters, such as asterisks, are not supported.
  • Prima di aggiungere questa funzionalità a una regola, assicurarsi di impostare l'opzione di compressione disabilitata nella pagina di compressione relativa alla piattaforma su cui verrà applicata la regola.Before you add this feature to a rule, ensure that you set the Compression Disabled option on the Compression page for the platform to which this rule will be applied.

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 consente di determinare quali valori di intestazione di richiesta e risposta vengono archiviati nei file di registro.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." Tuttavia, il nome di questo campo può essere personalizzato dalla pagina delle impostazioni di registro non elaborati.However, the name of this field can be customized from the Raw Log Settings page.

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

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

Informazioni chiave:Key information:

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

Valore predefinito: -Default Value: -

Torna all'inizioBack to top



Intestazioni di risposta di debug per la cacheDebug Cache Response Headers

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

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

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

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

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

Esempio:Example:

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

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

Informazioni chiave:Key information:

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

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

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

Valore predefinito: 7 giorniDefault Value: 7 days

Torna all'inizioBack to top



Negare l'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 Expires intestazioni da un server perimetrale quando è attiva la funzionalità esterne Max-Age.Purpose: Controls the generation of Expires headers by an edge server when the External Max-Age feature is active.

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

ValoreValue RisultatoResult
OverwriteOverwrite Garantisce che vengano eseguite le azioni seguenti:Ensures that the following actions will take place:
-Sovrascrive il Expires intestazione generati dal server di origine.- Overwrites the Expires header generated by the origin server.
-Aggiunge il Expires intestazione generati dalla caratteristica di Max-Age esterno per la risposta.- Adds the Expires header produced by the External Max-Age feature to the response.
Pass-throughPass Through Assicura che il Expires intestazione generati dalla funzionalità esterne Max-Age mai viene aggiunto 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 viene generato un Expires intestazione, passerà 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 Expires intestazione, quindi questa opzione può causare l'intestazione della risposta non contengono un Expires intestazione.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 Expires intestazione non è stata ricevuta dal server di origine, quindi questa opzione aggiunge il Expires intestazione generati dalla funzionalità esterne Max-Age.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. Questa opzione è utile per garantire che tutti gli asset verranno assegnati un Expires intestazione.This option is useful for ensuring that all assets will be assigned an Expires header.
RimuovereRemove Garantisce che un Expires intestazione non è inclusa con la risposta di intestazione.Ensures that an Expires header is not included with the header response. Se un Expires intestazione è già stata assegnata, quindi viene rimosso 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 di validità massima per la riconvalida della cache dal browser al server perimetrale.Purpose: Determines the max-age interval for browser to edge server cache revalidation. In altre parole, la quantità di tempo che deve trascorrere prima che un browser cerchi una nuova versione di un asset da un server periferico.In other words, the amount of time that will pass before a browser can check for a new version of an asset from an edge server.

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

Informazioni chiave:Key information:

  • Questa azione non riguarda le riconvalide della cache dal server periferico al server di origine.This action does not affect edge server to origin server cache revalidations. Questi tipi di riconvalide sono determinati dalle Cache-Control e Expires intestazioni ricevute dal server di origine e può essere personalizzate con il predefinito interno Max-Age e le funzionalità interne Force Max-Age.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.).
  • L'impostazione di questa funzionalità su un valore negativo, server edge di inviare un Cache-Control: no-cache e Expires ora in cui è impostato in precedenza con ogni risposta per il browser.Setting this feature to a negative value causes the edge servers to send a Cache-Control: no-cache and an Expires time that is set in the past with each response to the browser. Anche se un client HTTP non verrà memorizzati nella cache la risposta, questa impostazione non influirà il possibilità dei server edge per memorizzare nella cache la risposta dal server di origine.Although an HTTP client will not cache the response, this setting will not affect the edge servers' ability to cache the response from the origin server.
  • Impostando l'unità di tempo su "Off", questa funzionalità viene disabilitata.Setting the time unit to "Off" will disable this feature. Il Cache-Control e Expires intestazioni memorizzate nella cache con la risposta del server di origine verranno passati 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 di validità massima per la riconvalida della cache dal server perimetrale al server di origine.Purpose: Determines the max-age interval for edge server to origin server cache revalidation. In altre parole, la quantità di tempo che deve trascorrere prima che un server perimetrale verifichi se un asset memorizzato nella cache corrisponde all'asset archiviato sul server di origine.In other words, the amount of time that will pass before an edge server can check whether a cached asset matches the asset stored on the origin server.

Informazioni chiave:Key information:

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

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

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

Comportamento predefinito: OffDefault Behavior: Off

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.
  • Assicurarsi di includere un punto per ogni estensione di file aggiunta, ad esempio, .mp4 .f4v.Be sure to include a period when specifying each filename extension (for example, .mp4 .f4v).

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

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 di no-cache si verifica quando il client HTTP invia un Cache-Control: no-cache e/o Pragma: no-cache intestazione 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 alle richieste no-cache di un client HTTP di essere inoltrate al server di origine e al server di origine di restituire al client HTTP le intestazioni di risposta e il corpo tramite il server periferico.Allows an HTTP client's no-cache requests to be forwarded to the origin server, and the origin server will return the response headers and the body through the edge server back to the HTTP client.
DisabledDisabled Ripristina il comportamento predefinito.Restores the default behavior. Il comportamento predefinito prevede di impedire alle richieste no-cache di essere inoltrate al server di origine.The default behavior is to prevent no-cache requests from being forwarded to the origin server.

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

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

Comportamento predefinito: Disabled.Default Behavior: Disabled.

Torna all'inizioBack to top



Ignora origine No-CacheIgnore Origin No-Cache

Scopo: determina se la rete CDN ignorerà le direttive seguenti servite 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.
  • In base al modo in cui vengono monitorate le impostazioni della cache, è possibile che questa funzionalità non possa essere associata alle seguenti condizioni di corrispondenza:Due to the manner in which cache settings are tracked, this feature cannot be associated with the following match conditions:
    • EdgeEdge
    • CNAMECname
    • Valore letterale intestazione richiestaRequest Header Literal
    • Carattere jolly intestazione richiestaRequest Header Wildcard
    • Metodo richiestaRequest Method
    • Valore letterale query URLURL Query Literal
    • Carattere jolly query URLURL Query Wildcard

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

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 server periferico e non è stato specificato un campo di intestazione di richiesta If-Range.By default, this status code is returned when the specified byte-range request cannot be satisfied by an edge server and an If-Range request header field was not specified.

ValoreValue RisultatoResult
AttivatoEnabled Impedisce che il server di edge risponde a una richiesta di intervallo di byte non valido con un codice di stato 416 richiesto non Impossibile attenersi all'intervallo.Prevents the edge servers from responding to an invalid byte-range request with a 416 Requested Range Not Satisfiable status code. I server verranno invece recapitare la risorsa richiesta e restituire un messaggio 200 OK al client.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 per quanto tempo, dopo la normale scadenza, un asset memorizzato nella cache può essere servito da un server perimetrale quando il server perimetrale non è in grado di riconvalidare l'asset memorizzato nella cache con il server di origine.Purpose: Controls how long past the normal expiration time a cached asset may be served from an edge server when the edge server is unable to revalidate the cached asset with the origin server.

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

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

Questo intervallo di tempo inizia nel momento in cui scade la validità massima dell'asset, non quando la riconvalida ha esito negativo.Note that this time interval starts when the asset's max-age expires, not when the failed revalidation occurs. Il periodo massimo durante il quale un asset può essere servito senza riconvalida corrisponde quindi alla quantità di tempo determinata dalla combinazione dei valori Max-Age (Validità massima) e Max-Stale (Tempo di non aggiornamento massimo).Therefore, the maximum period during which an asset can be served without successful revalidation is the amount of time specified by the combination of max-age plus max-stale. Ad esempio, se è stato memorizzato nella cache di un asset alle 9:00 con una durata massima di 30 minuti e aggiornata un numero massimo di 15 minuti, quindi un tentativo non riuscito riconvalida 9:44 restituirà un utente finale riceve l'asset memorizzati nella cache non aggiornata, durante un tentativo non riuscito riconvalida 9:46 comporterebbe en utente riceve un Timeout del Gateway 504 d.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à è stata sostituita da Cache-Control: must-revalidate o Cache-Control: proxy-revalidate intestazioni ricevute dal server di origine.Any value configured for this feature is superseded by Cache-Control: must-revalidate or Cache-Control: proxy-revalidate headers received from the origin server. Se una di queste intestazioni viene ricevuta dal server di origine all'inizio della procedura di memorizzazione dell'asset nella cache, il server periferico non servirà un asset memorizzato nella cache non aggiornato.If either of those headers is received from the origin server when an asset is initially cached, then the edge server will not serve a stale cached asset. In tal caso, se il server perimetrale non è in grado di riconvalida con l'origine quando l'intervallo di durata massima dell'asset è scaduto, il server perimetrale restituisce un errore di Timeout del Gateway 504.In such a case, if the edge server is unable to revalidate with the origin when the asset's max-age interval has expired, the edge server 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.

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

Comportamento predefinito: due minutiDefault Behavior: Two minutes

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 è fortemente sconsigliata e può influire negativamente sulle prestazioni.Setting the maximum number of requests to a low value is strongly discouraged and may result in performance degradation.

Informazioni chiave:Key information:

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

Valore predefinito: 10.000 richiesteDefault Value: 10,000 requests

Torna all'inizioBack to top



Modifica intestazione richiesta clientModify Client Request Header

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

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

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

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

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

Informazioni chiave:Key information:

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

Torna all'inizioBack to top



Modificare intestazione risposta clientModify Client Response Header

Ogni risposta contiene un set di intestazioni di risposta che lo 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 di intestazione di risposta vengono definiti da un server di origine e dai server edge.By default, response header values are defined by an origin server and by the edge servers.

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

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

Informazioni chiave:Key information:

  • Assicurarsi che il valore specificato nell'opzione Nome corrisponda esattamente all'intestazione di risposta desiderata.Ensure that the value specified in the Name option is an exact match for the desired response header.
  • Ai fini dell'identificazione di un'intestazione non viene fatta distinzione tra maiuscole e minuscole.Case is not taken into account for the purpose of identifying a header. Ad esempio, uno dei seguenti variazioni del Cache-Control nome di intestazione è utilizzabile per facilitarne l'identificazione: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 in modo da essere inoltrato 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é verrebbe ignorato.Time should not be specified and it will be ignored.

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

Torna all'inizioBack to top



Intestazioni speciali proxyProxy Special Headers

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

Informazioni chiave:Key information:

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

Comportamento predefinito: tutte le intestazioni di richiesta specifici 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 la modalità di gestione di richiesta del client HTTP per un asset della cache di 0 byte per il server di edge.Purpose: Determines how an HTTP client's request for a 0-byte cache asset is handled by the edge servers.

I valori validi sono:Valid values are:

ValoreValue RisultatoResult
AttivatoEnabled Fa sì che il server perimetrale di recupero di risorse dal server di origine.Causes the edge server to refetch the asset from the origin server.
DisabledDisabled Ripristina il comportamento predefinito.Restores the default behavior. Il comportamento predefinito prevede di rendere disponibili asset di cache validi su richiesta.The default behavior is to serve up valid cache assets upon request.

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

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

Comportamento predefinito: Disabled.Default Behavior: Disabled.

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 della richiesta personalizzato in cui è memorizzato 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. È consigliabile quindi usare questa funzionalità con reti ADN e asset che non verranno memorizzati nella cache.Therefore, it is recommended that this feature be used with ADN or assets that will not be cached.

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

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

Torna all'inizioBack to top



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

Scopo: determina se il contenuto memorizzato nella cache scaduto verrà recapitato quando si verifica un errore durante la riconvalida della cache o quando si recupera il contenuto richiesto dal server di origine 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 Contenuto aggiornato viene servito al richiedente quando si verifica un errore durante una connessione a un server di origine.Stale content is served to the requester when an error occurs during a connection to an origin server.
DisabledDisabled 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 il server edge fornire contenuto aggiornato al richiedente durante la riconvalida.Purpose: Improves performance by allowing the edge servers to serve stale content to the requester while revalidation takes place.

Informazioni chiave:Key information:

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

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

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 utilizzato per crittografare e decrittografare i valori del token è la chiave primaria e le opzioni di Backup della chiave nella pagina autenticazione 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.

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.

Comportamento predefinito: Disabled.Default Behavior: Disabled.

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.

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

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

Reindirizzamento URLURL Redirection

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

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

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

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

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

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 i confronti di URL eseguiti dall'autenticazione basata su Token tra maiuscole e minuscole.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 sì che il server perimetrale ignorare la distinzione quando si confrontano gli URL per i parametri di autenticazione basata su Token.Causes the edge server to ignore case when comparing URLs for Token-Based Authentication parameters.
DisabledDisabled Ripristina il comportamento predefinito.Restores the default behavior. Il comportamento predefinito prevede di applicare la distinzioni tra maiuscole e minuscole durante i confronti di URL per l'autenticazione basata su token.The default behavior is for URL comparisons for Token Authentication to be case-sensitive.

Comportamento predefinito: Disabled.Default Behavior: Disabled.

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

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

Scenario di esempioSample Scenario

Questo esempio viene illustrato come reindirizzare un bordo URL CNAME corrispondente a questo URL di base della rete CDN: 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 periferico di base: http://cdn.mydomain.com/resourcesQualifying requests will be redirected to this base edge CNAME URL: http://cdn.mydomain.com/resources

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

Punti principali:Key points:

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. È costituito dalla sezione "/XXXX/" e dal nome dell'endpoint.This is the "/XXXX/" section and your endpoint name.
- Origine (modello): deve essere definito un modello che identifica le richieste in base al percorso relativo.- Source (pattern): A pattern that identifies requests by relative path must be defined. Questo modello di espressione regolare deve definire un percorso che inizia immediatamente dopo il punto di accesso dei contenuti selezionato in precedenza (vedere sopra).This regular expression pattern must define a path that starts directly after the previously selected content access point (see above).
Assicurarsi che i criteri dell'URI di richiesta, ad esempio origine e modello, definiti in precedenza non entrino in conflitto con le condizioni di corrispondenza definite per questa funzionalità.Verify that the request URI criteria (that is, Source & Pattern) previously defined doesn't conflict with any of the match conditions defined for this feature. Specificare un criterio; se si usa un valore vuoto come criterio, tutte le stringhe vengono confrontate.Specify a pattern; if you use a blank value as the pattern, all strings are matched.
DestinationDestination Definire l'URL relativo in cui verranno riscritte le richieste precedenti:Define the relative URL to which the above requests will be rewritten by:
1. Selezionando un punto di accesso dei contenuti che identifichi un server di origine.1. Selecting a content access point that identifies an origin server.
2. Definendo di un percorso tramite:2. Defining a relative path using:
- Un modello di espressione regolare- A regular expression pattern
- Variabili HTTP- HTTP variables

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

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

Scenario di esempio 1Sample Scenario 1

Questo esempio viene illustrato come reindirizzare un bordo URL CNAME corrispondente a questo URL di base della rete CDN: 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 periferico di base: http://MyOrigin.azureedge.net/resources/Qualifying requests will be redirected to this base edge CNAME URL: http://MyOrigin.azureedge.net/resources/

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

Scenario di esempio 2Sample Scenario 2

In questo esempio viene illustrato come reindirizzare l'URL di CNAME da maiuscolo a minuscolo tramite espressioni regolari un bordo.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: This URL redirection may be achieved through the following configuration:

Punti principali:Key points:

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

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

CompatibilitàCompatibility

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

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

Torna all'inizioBack to top



Variabile utenteUser Variable

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

Torna all'inizioBack to top


Fasi successiveNext Steps