Criterio ResponseCache

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Memorizza nella cache i dati di una risorsa di backend, riducendo il numero di richieste alla risorsa. Poiché le app fanno richieste allo stesso URI, puoi utilizzare questo criterio per restituire le risposte memorizzate nella cache anziché inoltrare le richieste al server di backend. Il criterio ResponseCache può migliorare le prestazioni della tua API riducendo la latenza e il traffico di rete.

Questo criterio è un criterio estensibile e il suo utilizzo potrebbe comportare implicazioni in termini di costi o utilizzo, a seconda della licenza Apigee. Per informazioni sui tipi di criteri e sulle implicazioni per l'utilizzo, consulta Tipi di criteri.

Probabilmente troverai ResponseCache più utile quando i dati di backend utilizzati dalla tua API vengono aggiornati solo periodicamente. Ad esempio, immagina di avere un'API che espone i dati dei bollettini meteo aggiornati solo ogni dieci minuti. Utilizzando ResponseCache per restituire le risposte memorizzate nella cache tra un aggiornamento e l'altro, puoi ridurre il numero di richieste che raggiungono il backend. In questo modo si riduce anche il numero di hop di rete.

Per la memorizzazione nella cache a breve termine per uso generico, ti consigliamo di utilizzare il criterio PopulateCache. Questo criterio viene utilizzato in combinazione con il criterio LookupCache (per leggere le voci della cache) e con il criterio InvalidateCache (per invalidare le voci).

Guarda il video seguente per un'introduzione alle norme relative alla cache delle risposte.

Suggerimento: per una discussione sugli antipattern per il criterio della cache della risposta, consulta Introduzione agli antipattern.

Nota: puoi allegare questo criterio una volta nel flusso di richiesta del proxy e una volta nel flusso di risposta. Per un tutorial video, consulta Tutorial: Implementazione della memorizzazione nella cache delle risposte in Edge. Consulta anche la sezione Codici di errore di seguito.

Esempi

Cache di 10 minuti

Questo esempio mostra come conservare le risposte memorizzate nella cache per 10 minuti.

Immagina di avere un'API all'URL seguente:

http://{org_name}-test.apigee.net/weather/forecastrss?w=23424778

Utilizzi il parametro di query w come chiave della cache. Apigee controlla il valore del parametro di query w ogni volta che viene ricevuta una richiesta. Se nella cache è presente una risposta valida (ovvero non scaduta), il messaggio di risposta memorizzato nella cache viene restituito al client richiedente.

Ora immagina di avere un criterio ResponseCache configurato come segue.

<ResponseCache name="ResponseCache">
    <CacheKey>
        <KeyFragment ref="request.queryparam.w" />
    </CacheKey>
    <ExpirySettings>
        <TimeoutInSeconds>600</TimeoutInSeconds>
    </ExpirySettings>
</ResponseCache>

La prima volta che il proxy API riceve un messaggio di richiesta per il seguente URL, la risposta viene memorizzata nella cache. Alla seconda richiesta entro 10 minuti viene eseguita una ricerca nella cache: la risposta memorizzata nella cache viene restituita all'app senza che nessuna richiesta venga inoltrata al servizio di backend.

http://{org_name}-test.apigee.net/weather/forecastrss?w=23424778

Suggerimento:le intestazioni HTTP e parametri di ricerca vengono completati automaticamente come variabili quando viene ricevuta una richiesta. Qualsiasi intestazione HTTP è disponibile come request.header.{header_name}, ad esempio request.header.user-agent. Qualsiasi parametro di query è disponibile come request.queryparam.{queryparam_name}, ad esempio request.queryparam.action.

Salta la ricerca nella cache

L'esempio seguente mostra come saltare la ricerca nella cache e aggiornarla. Guarda anche questo video sull'utilizzo di SkipCacheLookup.

La condizione facoltativa SkipCacheLookup (se configurata) viene valutata nel percorso della richiesta. Se la condizione restituisce true, la ricerca nella cache viene saltata e la cache viene aggiornata.

Un utilizzo comune dell'aggiornamento della cache condizionale è una condizione che definisce un'intestazione HTTP specifica che fa sì che la condizione venga valutata come vera. Un'applicazione client basata su script potrebbe essere configurata per inviare periodicamente una richiesta con l'intestazione HTTP appropriata, provocando esplicitamente l'aggiornamento della cache della risposta.

Ad esempio, immagina una chiamata a un'API all'URL seguente:

'http://{org_name}-test.apigee.net/weather/forecastrss?w=23424778' -H "bypass-cache:true"

Ora immagina il seguente criterio ResponseCache configurato sul proxy. Tieni presente che la condizione bypass-cache è impostata su true.

<ResponseCache name="ResponseCache">
    <CacheKey>
        <KeyFragment ref="request.queryparam.w" />
    </CacheKey>
    <!-- Explicitly refresh the cached response -->
    <SkipCacheLookup>request.header.bypass-cache = "true"</SkipCacheLookup>
    <ExpirySettings>
        <TimeoutInSeconds>600</TimeoutInSeconds>
    </ExpirySettings>
</ResponseCache>

Per ulteriori informazioni sulle condizioni, consulta la sezione Variabili e condizioni.

Riferimento elemento

Il riferimento all'elemento descrive gli elementi e gli attributi del criterio.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ResponseCache async="false" continueOnError="false" enabled="true" name="Response-Cache-1">
    <DisplayName>Response Cache 1</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref="request.uri" />
    </CacheKey>
    <Scope>Exclusive</Scope>
    <ExpirySettings>
        <ExpiryDate/>
        <TimeOfDay/>
        <TimeoutInSeconds ref="flow.variable.here">300</TimeoutInSeconds>
    </ExpirySettings>
    <CacheResource>cache_to_use</CacheResource>
    <CacheLookupTimeoutInSeconds/>
    <ExcludeErrorResponse/>
    <SkipCacheLookup/>
    <SkipCachePopulation/>
    <UseAcceptHeader/>
    <UseResponseCacheHeaders/>
</ResponseCache>

Attributi <ResponseCache>

<ResponseCache async="false" continueOnError="false" enabled="true" name="Response-Cache-1">

La tabella seguente descrive gli attributi comuni a tutti gli elementi principali dei criteri:

Attributo	Descrizione	Predefinito	Presenza
name	Il nome interno del criterio. Il valore dell'attributo name può contenere lettere, numeri, spazi, trattini, trattini bassi e punti. Questo valore non può superare i 255 caratteri. Se vuoi, utilizza l'elemento <DisplayName> per etichettare il criterio nell'editor proxy dell'interfaccia utente di gestione con un nome diverso in linguaggio naturale.	N/D	Obbligatorio
continueOnError	Imposta su false per restituire un errore quando un criterio non va a buon fine. Questo è un comportamento previsto per la maggior parte dei criteri. Imposta su true per continuare l'esecuzione del flusso anche dopo un fallimento del criterio. Vedi anche: Le regole di errore vengono attivate SOLO in uno stato di errore (informazioni su continueOnError) Gestione degli errori all'interno del flusso corrente	falso	Facoltativo
enabled	Imposta su true per applicare il criterio. Imposta false per disattivare il criterio. Il criterio non verrà applicato anche se rimane collegato a un flusso.	true	Facoltativo
async	Questo attributo è stato ritirato.	falso	Ritirato

Elemento <DisplayName>

Da utilizzare insieme all'attributo name per etichettare il criterio nell'editor proxy dell'interfaccia utente di gestione con un nome diverso in linguaggio naturale.

<DisplayName>Policy Display Name</DisplayName>

Predefinito	N/D Se ometti questo elemento, viene utilizzato il valore dell'attributo name del criterio.
Presenza	Facoltativo
Tipo	Stringa

Elemento <CacheKey>

Configura un puntatore univoco a un dato archiviato nella cache.

Le chiavi della cache hanno una dimensione massima di 2 KB.

Nota: puoi aumentare ulteriormente la chiave della cache configurata qui utilizzando i valori delle intestazioni di risposta. Per ulteriori informazioni, consulta Configurare una chiave della cache.

<CacheKey>
    <Prefix>string</Prefix>
    <KeyFragment ref="variable_name" />
    <KeyFragment>literal_string</KeyFragment>
</CacheKey>

Valore predefinito:	N/D
Presenza:	Obbligatorio
Tipo:	N/D

<CacheKey> genera il nome di ogni elemento di dati memorizzato nella cache. La chiave viene spesso impostata utilizzando un valore delle intestazioni delle entità o dei parametri di query. In questi casi, l'attributo ref dell'elemento deve specificare una variabile contenente il valore della chiave.

In fase di esecuzione, ai valori <KeyFragment> viene anteposto il valore dell'elemento <Scope> o il valore <Prefix>. Ad esempio, il seguente genera una chiave della cache di UserToken__apiAccessToken__<value_of_client_id>:

<CacheKey>
    <Prefix>UserToken</Prefix>
    <KeyFragment>apiAccessToken</KeyFragment>
    <KeyFragment ref="request.queryparam.client_id" />
</CacheKey>

L'elemento <CacheKey> viene utilizzato in combinazione con <Prefix> e <Scope>. Per ulteriori informazioni, consulta Utilizzo delle chiavi della cache.

Elemento <CacheLookupTimeoutInSeconds>

Specifica il numero di secondi dopo i quali una ricerca nella cache non riuscita verrà considerata un fallimento della cache. In questo caso, il flusso riprende lungo il percorso di mancata corrispondenza della cache.

<CacheLookupTimeoutInSeconds>30</CacheLookupTimeoutInSeconds>

Valore predefinito:	30
Presenza:	Facoltativo
Tipo:	Numero intero

Elemento <CacheResource>

Specifica la cache in cui devono essere archiviati i messaggi. Ometti questo elemento per utilizzare la cache condivisa inclusa. Devi specificare un CacheResource per nome se vuoi poter cancellare amministrativamente le voci contenute nella cache. Per saperne di più, consulta l'API Caches.

<CacheResource>cache_to_use</CacheResource>

Valore predefinito:	N/D
Presenza:	Facoltativo
Tipo:	Stringa

Elemento <CacheKey>/<KeyFragment>

Specifica un valore da includere nella chiave della cache, creando uno spazio dei nomi per abbinare le richieste alle risposte memorizzate nella cache.

<KeyFragment ref="variable_name"/>
<KeyFragment>literal_string</KeyFragment>

Valore predefinito:	N/D
Presenza:	Facoltativo
Tipo:	N/D

Può essere una chiave (un nome statico fornito da te) o un valore (una voce dinamica impostata facendo riferimento a una variabile). Tutti i frammenti specificati combinati (più il prefisso) vengono concatenati per creare la chiave della cache.

<KeyFragment>apiAccessToken</KeyFragment>
<KeyFragment ref="request.queryparam.client_id" />

L'elemento <KeyFragment> viene utilizzato in combinazione con <Prefix> e <Scope>. Per ulteriori informazioni, consulta Utilizzo delle chiavi della cache.

Attributi

Attributo	Tipo	Predefinito	Obbligatorio	Descrizione
ref	string		No	La variabile da cui ottenere il valore. Non deve essere utilizzato se questo elemento contiene un valore letterale.

Elemento <CacheKey>/<Prefix>

Specifica un valore da utilizzare come prefisso della chiave della cache.

<Prefix>prefix_string</Prefix>

Valore predefinito:	N/D
Presenza:	Facoltativo
Tipo:	Stringa

Utilizza questo valore anziché <Scope> quando vuoi specificare il tuo valore anziché un valore enumerato <Scope>. Se definito, <Prefix> antepone il valore della chiave della cache per le voci scritte nella cache. Un valore dell'elemento <Prefix> sostituisce un valore dell'elemento <Scope>.

L'elemento <Prefix> viene utilizzato in combinazione con <CacheKey> e <Scope>. Per ulteriori informazioni, consulta Utilizzo delle chiavi della cache.

Elemento <ExcludeErrorResponse>

Questo criterio può memorizzare nella cache le risposte HTTP con qualsiasi codice di stato. Ciò significa che sia le risposte di successo che quelle di errore possono essere memorizzate nella cache, inclusi i codici di stato 2xx e 3xx.

Imposta questo elemento su true (valore predefinito) per escludere le risposte di errore. Impostalo su false se non vuoi escludere le risposte del target della cache con codici di stato di errore HTTP.

Nota: i codici di stato da 200 a 205 vengono comunque memorizzati nella cache quando questo elemento è impostato su true. Si tratta dei codici di stato HTTP che Apigee conteggia come codici di "successo" e non puoi escluderli con questo elemento.

Per una discussione sugli schemi della cache delle risposte in cui questo elemento è utile, consulta Introduzione agli antipattern.

<ExcludeErrorResponse>true</ExcludeErrorResponse>

Valore predefinito:	true
Presenza:	Facoltativo
Tipo:	Booleano

Elemento <ExpirySettings>

Specifica quando deve scadere una voce della cache. Se presente, <TimeoutInSeconds> sostituisce sia <TimeOfDay> che <ExpiryDate>.

<ExpirySettings>
  <TimeOfDay ref="time_variable">expiration_time</TimeOfDay>
  <TimeoutInSeconds ref="duration_variable">seconds_until_expiration</TimeoutInSeconds>
  <ExpiryDate ref="date_variable">expiration_date</ExpiryDate>
</ExpirySettings>

Valore predefinito:	N/D
Presenza:	Obbligatorio
Tipo:	N/D

Elemento <ExpirySettings>/<ExpiryDate>

Specifica la data di scadenza di una voce della cache. Utilizza il modulo mm-dd-yyyy. Se presente, l'elemento fratello <TimeoutInSeconds> di questo elemento sostituisce <ExpiryDate>.

<ExpirySettings>
    <ExpiryDate ref="{date_variable}">expiration_date</ExpiryDate>
</ExpirySettings>

Valore predefinito:	N/D
Presenza:	Facoltativo
Tipo:	Stringa

Attributi

<ExpiryDate ref="" />

Attributo	Descrizione	Predefinito	Presenza	Tipo
ref	La variabile da cui ottenere il valore. Non deve essere utilizzato se questo elemento contiene un valore letterale.	N/D	Facoltativo	Stringa

Elemento <ExpirySettings>/<TimeOfDay>

L'ora alla quale deve scadere una voce della cache. Utilizza il modulo hh:mm:ss . Se presente, l'elemento fratello <TimeoutInSeconds> di questo elemento sostituisce <TimeOfDay>.

Inserisci l'ora del giorno nel formato HH:mm:ss, dove HH rappresenta l'ora su un orologio a 24 ore. Ad esempio, 14:30:00 per le 14:30.

Per l'ora del giorno, le impostazioni internazionali e il fuso orario predefiniti variano a seconda di dove viene eseguito il codice (non è possibile conoscerli quando configuri il criterio).

<ExpirySettings>
    <TimeOfDay ref="time_variable">expiration_time</TimeOfDay>
</ExpirySettings>

Valore predefinito:	N/D
Presenza:	Facoltativo
Tipo:	Stringa

Attributi

Attributo	Descrizione	Predefinito	Presenza	Tipo
ref	Variabile con il valore della data di scadenza.	N/D	Facoltativo	Stringa

Elemento <ExpirySettings>/<TimeoutInSec>

Nota: deprecato. Utilizza TimeoutInSeconds. Se sono presenti entrambi gli elementi TimeoutInSec e TimeoutInSeconds, Apigee utilizza TimeoutInSeconds.

Il numero di secondi dopo i quali deve scadere una voce della cache.

Elemento <ExpirySettings>/<TimeoutInSeconds>

Il numero di secondi dopo i quali deve scadere una voce della cache. Se presente, questo elemento sostituisce i suoi elementi fratelli <TimeOfDay> e <ExpiryDate>.

<ExpirySettings>
    <TimeoutInSeconds ref="duration_variable">seconds_until_expiration</TimeoutInSeconds>
</ExpirySettings>

Nota: fornisci un valore di timeout predefinito da utilizzare se il riferimento non riceve un valore da duration_variable.

Valore predefinito:	N/D
Presenza:	Facoltativo
Tipo:	Stringa

Attributi

Attributo	Descrizione	Predefinito	Presenza	Tipo
ref	Variabile con il valore del timeout.	N/D	Facoltativo	Stringa

Elemento <Scope>

Enumerazione utilizzata per creare un prefisso per una chiave della cache quando nell'elemento <CacheKey> non è specificato un elemento <Prefix>.

<Scope>scope_enumeration</Scope>

Valore predefinito:	"Esclusiva"
Presenza:	Facoltativo
Tipo:	Stringa

L'impostazione <Scope> determina una chiave della cache che viene anteposta in base al valore <Scope>. Ad esempio, una chiave della cache assumerebbe la seguente forma quando lo scopo è impostato su Exclusive : orgName__envName__apiProxyName__deployedRevisionNumber__proxy|TargetName__ [ serializedCacheKey ].

Se in <CacheKey> è presente un elemento <Prefix>, questo supplanta un valore dell'elemento <Scope>. I valori validi includono le enumerazioni riportate di seguito.

L'elemento <Scope> viene utilizzato in combinazione con <CacheKey> e <Prefix>. Per ulteriori informazioni, consulta Utilizzo delle chiavi della cache.

Valori accettabili

Valore dell'ambito	Descrizione
Global	La chiave della cache è condivisa tra tutti i proxy API di cui è stato eseguito il deployment nell'ambiente. La chiave della cache viene premessa nel formato orgName __ envName __. Se definisci una voce <CacheKey> con il valore <KeyFragment> apiAccessToken e un ambito <Global>, ogni voce viene archiviata come orgName__envName__apiAccessToken, seguita dal valore serializzato del token di accesso. Per un proxy API di cui è stato eseguito il deployment in un ambiente chiamato 'test' in un'organizzazione chiamata 'apifactory', i token di accesso vengono archiviati nella seguente chiave della cache: apifactory__test__apiAccessToken.
Application	Il nome del proxy API viene utilizzato come prefisso. La chiave della cache viene anteposta nel formato orgName__envName__apiProxyName.
Proxy	La configurazione di ProxyEndpoint viene utilizzata come prefisso. La chiave della cache viene anteposta nel formato orgName__envName__apiProxyName__deployedRevisionNumber__proxyEndpointName .
Target	La configurazione di TargetEndpoint viene utilizzata come prefisso. Chiave della cache anteposta nel formato orgName__envName__apiProxyName__deployedRevisionNumber__targetEndpointName .
Exclusive	Valore predefinito. È il valore più specifico e, pertanto, presenta un rischio minimo di collisioni di spazi dei nomi all'interno di una determinata cache. Il prefisso può essere di due tipi: Se il criterio è associato al flusso ProxyEndpoint, il prefisso è del formato ApiProxyName_ProxyEndpointName. Se il criterio è allegato a TargetEndpoint, il prefisso è del tipo ApiProxyName_TargetName. Chiave della cache anteposta nel formato orgName__envName__apiProxyName__deployedRevisionNumber__proxyNameITargetName Ad esempio, la stringa completa potrebbe avere il seguente aspetto: apifactory__test__weatherapi__16__default__apiAccessToken .

Elemento <SkipCacheLookup>

Definisce un'espressione che, se restituisce true in fase di esecuzione, specifica che la ricerca nella cache deve essere saltata e la cache deve essere aggiornata. Consulta anche Il video sulle norme relative a ResponseCache sull'utilizzo di SkipCacheLookup.

<SkipCacheLookup>variable_condition_expression</SkipCacheLookup>

Valore predefinito:	N/D
Presenza:	Facoltativo
Tipo:	Stringa

Nell'esempio seguente, se la variabile bypass-cache è impostata su true in un'intestazione in arrivo, la ricerca nella cache viene saltata e la cache viene aggiornata.

<SkipCacheLookup>request.header.bypass-cache = "true"</SkipCacheLookup>

Elemento <SkipCachePopulation>

Definisce un'espressione che, se restituisce true in fase di esecuzione, specifica che deve essere saltata una scrittura nella cache. Guarda anche questo video sull'utilizzo di SkipCachePopulation.

<SkipCachePopulation>variable_condition_expression</SkipCachePopulation>

Valore predefinito:	N/D
Presenza:	Facoltativo
Tipo:	Stringa

Ad esempio, il codice seguente salta la scrittura nella cache se il codice di stato della risposta è 400 o superiore:

<SkipCachePopulation>response.status.code >= 400</SkipCachePopulation>

Elemento <UseAcceptHeader>

Imposta su true per aggiungere alla chiave della cache di una voce della cache della risposta i valori delle intestazioni Accept della risposta.

Apigee utilizza gli intestazioni di richiesta Accept, Accept-Encoding, Accept-Language e Accept-Charset per calcolare la chiave della cache. Questo approccio impedisce a un cliente di ricevere un tipo di media che non ha richiesto.

Ad esempio, immagina che vengano inviate due richieste dallo stesso URL, dove la prima accetta gzip e la seconda no. La prima richiesta verrà memorizzata nella cache e la voce memorizzata nella cache sarà probabilmente una risposta compressa con gzip. La seconda richiesta leggerà il valore memorizzato nella cache e potrà quindi restituire una voce compressa con gzip a un client che non è in grado di leggere gzip.

Per saperne di più, consulta Configurare una chiave della cache.

<UseAcceptHeader>false</UseAcceptHeader>

Valore predefinito:	falso
Presenza:	Facoltativo
Tipo:	Booleano

Elemento <UseResponseCacheHeaders>

Imposta su true per fare in modo che le intestazioni di risposta HTTP vengano prese in considerazione durante l'impostazione della "durata (TTL)" della risposta nella cache. In questo caso, Apigee prende in considerazione i valori delle seguenti intestazioni di risposta, confrontandoli con quelli impostati da <ExpirySettings> durante l'impostazione del TTL:

• Cache-Control s-maxage
• Cache-Control max-age
• Expires

Per ulteriori dettagli, consulta Impostare la scadenza della voce della cache.

<UseResponseCacheHeaders>false</UseResponseCacheHeaders>

Valore predefinito:	falso
Presenza:	Facoltativo
Tipo:	Booleano

Note sull'utilizzo

La dimensione massima di ogni oggetto memorizzato nella cache è 256 KB. Per informazioni dettagliate su come Apigee elabora la cache, consulta Componenti interni della cache.

Tramite la configurazione nel criterio ResponseCache, puoi chiedere ad Apigee di includere le intestazioni di risposta HTTP nell'impostazione della scadenza della voce della cache e delle chiavi della cache. Questa sezione descrive come utilizzare il criterio con le intestazioni per gestire la scadenza e le chiavi della cache.

Per scoprire di più su come Apigee gestisce le intestazioni di risposta con il criterio ResponseCache, consulta Supporto per le intestazioni della risposta HTTP.

Nota: per altri suggerimenti sulle best practice relativi al criterio ResponseCache, consulta le best practice per la progettazione e lo sviluppo di proxy API.

Impostazione della scadenza della voce della cache

Come per il criterio PopulateCache, puoi impostare la scadenza (il tempo di vita) di una voce della cache della risposta utilizzando l'elemento <ExpirySettings>. Nel criterio ResponseCache, puoi anche chiedere ad Apigee di prendere in considerazione le intestazioni di risposta se sono presenti.

Per utilizzare le intestazioni di risposta, imposta il valore dell'elemento <UseResponseCacheHeaders> su true. Questa impostazione fa sì che Apigee tenga conto delle intestazioni di risposta, le confronti con il valore impostato da <ExpirySettings> e poi utilizzi il valore più basso tra i due. Quando esamina le intestazioni di risposta, Apigee sceglie il valore disponibile come descritto di seguito:

Ad esempio, immagina che una risposta venga memorizzata nella cache con i seguenti valori:

• Nessun valore Cache-Control s-maxage
• Un valore Cache-Control max-age pari a 300
• Una data Expires tra tre giorni
• Un valore <ExpirySettings> TimeoutInSeconds pari a 600.

In questo caso, per il TTL verrà utilizzato il valore Cache-Control max-age perché è inferiore al valore <ExpirySettings> e perché non esiste un valore Cache-Control s-maxage (che ha la precedenza su max-age).

Configurazione di una chiave della cache

Come per i criteri della cache per uso generico, come il criterio PopulateCache, con ResponseCache utilizzi gli elementi <CacheKey> e <Scope> per configurare la creazione della chiave della cache per le voci della cache. Con ResponseCache puoi anche rendere le chiavi della cache più significative aggiungendo le intestazioni Accept di risposta ai valori delle chiavi.

Per informazioni generali sulla configurazione delle chiavi di cache, consulta Utilizzo delle chiavi di cache. Per informazioni sull'utilizzo delle intestazioni Accept, consulta <UseAcceptHeader>.

Informazioni sulla crittografia della cache

Apigee e Apigee hybrid (versione 1.4 e successive): i dati della cache e KVM sono sempre criptati.

Variabili di flusso

Le seguenti variabili di flusso predefinite vengono completate quando viene eseguito un criterio ResponseCache. Per ulteriori informazioni sulle variabili di flusso, consulta la sezione Riferimento alle variabili di flusso.

Variabili	Tipo	Autorizzazione	Descrizione
responsecache.{policy_name}.cachename	Stringa	Sola lettura	Restituisce la cache utilizzata nel criterio
responsecache.{policy_name}.cachekey	Stringa	Sola lettura	Restituisce la chiave utilizzata
responsecache.{policy_name}.cachehit	Booleano	Sola lettura	Vero se l'esecuzione del criterio è riuscita
responsecache.{policy_name}.invalidentry	Booleano	Sola lettura	True se la voce della cache non è valida

Codici di errore

Questa sezione descrive i messaggi di errore e le variabili di flusso impostate quando questo criterio attiva un errore. Queste informazioni sono importanti se stai sviluppando regole di errore per un proxy. Per scoprire di più, consulta Informazioni importanti sugli errori relativi alle norme e Gestione degli errori.

Prefisso del codice di errore

N/D

Errori di runtime

Questo criterio non genera errori di runtime.

Errori di deployment

Questi errori possono verificarsi quando esegui il deployment di un proxy contenente questo criterio.

Suggerimento:hai bisogno di aiuto per risolvere un errore? Fai clic su nella colonna Correggi per informazioni dettagliate sulla risoluzione dei problemi.

Nome dell'errore	Causa	Correggi
InvalidTimeout	Se l'elemento <CacheLookupTimeoutInSeconds> del criterio ResponseCache è impostato su un numero negativo, il deployment del proxy API non va a buon fine.
InvalidCacheResourceReference	Questo errore si verifica se l'elemento <CacheResource> in un criterio ResponseCache è impostato su un nome che non esiste nell'ambiente in cui viene eseguito il deployment del proxy API.
ResponseCacheStepAttachmentNotAllowedReq	Questo errore si verifica se lo stesso criterio ResponseCache è associato a più percorsi di richiesta all'interno di qualsiasi flusso di un proxy API.
ResponseCacheStepAttachmentNotAllowedResp	Questo errore si verifica se lo stesso criterio ResponseCache è associato a più percorsi di risposta all'interno di qualsiasi flusso di un proxy API.
InvalidMessagePatternForErrorCode	Questo errore si verifica se l'elemento <SkipCacheLookup> o <SkipCachePopulation> in un criterio ResponseCache contiene una condizione non valida.
CacheNotFound	Questo errore si verifica se la cache specifica indicata nel messaggio di errore non è stata creata su un componente di processore di messaggi specifico.

Variabili di errore

N/D

Esempio di risposta di errore

N/D

Schema

Ogni tipo di norma è definito da uno schema XML (.xsd). Come riferimento, gli schemi delle norme sono disponibili su GitHub.