Questa pagina si applica a Apigee e Apigee ibrido.
Visualizza la documentazione di
Apigee Edge.
Consente di configurare la modalità di recupero dei valori memorizzati nella cache in fase di runtime.
Questo criterio è destinato all'uso nella memorizzazione nella cache a breve termine per uso generico. Viene utilizzato in combinazione con il criterio compileCache (per la scrittura delle voci) e con il criterio InvalidateCache (per l'annullamento della convalida delle voci).
Questo criterio è un criterio estendibile e il suo utilizzo potrebbe avere 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 la pagina Tipi di criteri.
Per memorizzare nella cache le risposte delle risorse di backend, consulta il criterio diResponseCache.
Riferimento elemento
Di seguito sono elencati gli elementi che puoi configurare su questo criterio.
<LookupCache async="false" continueOnError="false" enabled="true" name="Lookup-Cache-1"> <DisplayName>Lookup Cache 1</DisplayName> <Properties/> <CacheKey> <Prefix/> <KeyFragment ref=""/> </CacheKey> <!-- Omit this element if you're using the included shared cache. --> <CacheResource/> <CacheLookupTimeoutInSeconds/> <Scope>Exclusive</Scope> <AssignTo>flowVar</AssignTo> </LookupCache>
Una cache condivisa è inclusa per impostazione predefinita. Per utilizzare la cache condivisa, ometti
l'elemento <CacheResource>
in questa configurazione dei criteri.
Per scoprire di più sul datastore sottostante, consulta Informazioni interne della cache. Per ulteriori informazioni sulla configurazione delle cache, consulta Memorizzazione nella cache per uso generico.
Attributi <LookupCache>
La tabella seguente descrive gli attributi comuni a tutti gli elementi principali dei criteri:
Attributo | Descrizione | Predefinito | Presenza |
---|---|---|---|
name |
Il nome interno della norma. Il valore dell'attributo Facoltativamente, utilizza l'elemento |
N/A | Obbligatorio |
continueOnError |
Impostalo su Imposta su |
false | Facoltativo |
enabled |
Imposta il criterio su Impostala su |
true | Facoltativo |
async |
Questo attributo è obsoleto. |
false | Deprecata |
Elemento <DisplayName>
Utilizzalo in aggiunta 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/A Se ometti questo elemento, viene utilizzato il valore dell'attributo |
---|---|
Presenza | Facoltativo |
Tipo | Stringa |
Elemento <AssignTo>
Specifica la variabile in cui viene assegnata la voce della cache dopo che è stata recuperata dalla cache. La variabile deve essere accessibile in scrittura. Se la ricerca cache non recupera un valore, la variabile non verrà impostata.
<AssignTo>variable_to_receive_cached_value</AssignTo>
Predefinita: |
N/A |
Presenza: |
Obbligatorio |
Tipo: |
String |
Elemento <CacheKey>
Configura un puntatore univoco a un dato archiviato nella cache.
<CacheKey> <Prefix>string</Prefix> <KeyFragment ref="variable_name" /> <KeyFragment>literal_string</KeyFragment> </CacheKey>
Predefinita: |
N/A |
Presenza: |
Obbligatorio |
Tipo: |
N/A |
<CacheKey>
crea il nome di ogni dato archiviato nella
cache.
In fase di runtime, i valori <KeyFragment>
vengono anteposti al valore dell'elemento <Scope>
o al valore <Prefix>
. Ad esempio, quanto segue genera una chiave cache di
UserToken__apiAccessToken__
<value_of_client_id>:
<CacheKey> <Prefix>UserToken</Prefix> <KeyFragment>apiAccessToken</KeyFragment> <KeyFragment ref="request.queryparam.client_id" /> </CacheKey>
Utilizzi l'elemento <CacheKey>
insieme a <Prefix>
e <Scope>
. Per ulteriori informazioni, vedi Utilizzo delle chiavi cache.
Elemento <CacheLookupTimeoutInSeconds>
Specifica il numero di secondi dopo i quali una ricerca di cache non riuscita verrà considerata un fallimento della cache. In questo caso, il flusso riprende lungo il percorso "cache-miss".
<CacheLookupTimeoutInSeconds>30</CacheLookupTimeoutInSeconds>
Predefinita: |
30 |
Presenza: |
Facoltativo |
Tipo: |
Integer |
Elemento<CacheResource>
Specifica la cache in cui devono essere archiviati i messaggi.
Ometti completamente questo elemento se questo criterio (e i criteri processuali e InvalidateCache corrispondenti) utilizzano la cache condivisa inclusa.
<CacheResource>cache_to_use</CacheResource>
Predefinita: |
N/A |
Presenza: |
Facoltativo |
Tipo: |
String |
Per saperne di più sulla configurazione delle cache, consulta l'articolo Memorizzazione nella cache per uso generico.
Elemento <CacheKey>/<KeyFragment>
Specifica un valore che deve essere incluso nella chiave cache. Specifica una variabile di cui rimuovere il riferimento
con l'attributo ref
o con un valore fisso.
<KeyFragment ref="variable_name"/> <KeyFragment>literal_string</KeyFragment>
Predefinita: |
N/A |
Presenza: |
Facoltativo |
Tipo: |
N/A |
In fase di runtime, Apigee crea la chiave cache anteponendo il valore ottenuto dall'elemento <Scope>
o dall'elemento <Prefix>
a una concatenazione dei valori risolti di ciascuno degli elementi <KeyFragment>
.
Per maggiori informazioni, consulta
Utilizzo delle chiavi cache.
Attributi
Attributo | Tipo | Predefinita | Obbligatorio | Descrizione |
---|---|---|---|---|
riferimento | 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 cache.
<Prefix>prefix_string</Prefix>
Predefinita: |
N/A |
Presenza: |
Facoltativo |
Tipo: |
String |
Un elemento <Prefix>
sostituisce qualsiasi elemento <Scope>
.
In fase di runtime, Apigee crea la chiave cache anteponendo il valore ottenuto dall'elemento <Scope>
o dall'elemento <Prefix>
a una concatenazione dei valori risolti di ciascuno degli elementi <KeyFragment>
.
Per maggiori informazioni, consulta
Utilizzo delle chiavi cache.
Elemento <Scope>
Enumerazione utilizzata per creare un prefisso per una chiave cache quando non viene fornito un elemento <Prefix>
nell'elemento <CacheKey>
.
<Scope>scope_enumeration</Scope>
Predefinita: |
"Esclusiva" |
Presenza: |
Facoltativo |
Tipo: |
String |
L'impostazione <Scope>
determina una chiave cache che viene anteposta in base al
valore <Scope>
. Ad esempio, una chiave cache assumerebbe il seguente formato quando
l'ambito è impostato su Exclusive
:
orgName__envName__applicationName__deployedRevisionNumber__proxy|TargetName__
[ serializedCacheKey ].
Se un elemento <Prefix>
è presente in <CacheKey>
, sostituisce un valore dell'elemento <Scope>
. I valori validi includono le enumerazioni
seguenti.
Per ulteriori informazioni, vedi Utilizzo delle chiavi cache.
Valori accettabili
Global |
La chiave cache viene condivisa tra tutti i proxy API di cui è stato eseguito il deployment nell'ambiente. La chiave della cache è anteposta nel formato orgName __ envName __. Se definisci una voce |
Application |
Il nome del proxy API viene utilizzato come prefisso. La chiave della cache è anteposta nel formato orgName__envName__applicationName. |
Proxy |
Come prefisso viene utilizzata la configurazione ProxyEndpoint. La chiave cache è anteposta nel formato orgName__envName__applicationName__deployedRevisionNumber__proxyEndpointName . |
Target |
Come prefisso viene utilizzata la configurazione TargetEndpoint. Chiave cache anteposta nel formato orgName__envName__applicationName__deployedRevisionNumber__targetEndpointName . |
Exclusive |
Predefinita. Si tratta del tipo più specifico e, di conseguenza, presenta il rischio minimo di collisioni degli spazi dei nomi all'interno di una determinata cache. Il prefisso può essere di due tipi:
Chiave cache anteposta nel formato orgName__envName__applicationName__deployedRevisionNumber__proxyNameITargetName Ad esempio, la stringa completa potrebbe essere simile alla seguente: apifactory__test__weatherapi__16__default__apiAccessToken. |
Note sull'utilizzo
Utilizza questo criterio per la memorizzazione nella cache per uso generico. In fase di runtime, il criterio LookupCache recupera un valore dalla cache, assegnandolo alla variabile specificata con l'elementoAssignTo (se non viene recuperato alcun valore, la variabile non verrà impostata). Cerca il valore in base a una chiave cache creata tramite una configurazione che combina gli elementi CacheKey e Scope. In altre parole, per recuperare un determinato valore aggiunto alla cache da un criterio PreparingCache, il criterio LookupCache deve avere elementi correlati alle chiavi cache configurati allo stesso modo del criterio PopulationCache.
La memorizzazione nella cache per uso generico con il criterio ReplaceCache, il criterio LookupCache e il criterio InvalidateCache utilizza una cache configurata da te o una cache condivisa inclusa per impostazione predefinita. Nella maggior parte dei casi, la cache condivisa sottostante dovrebbe soddisfare le tue esigenze. Per utilizzare la cache predefinita, è sufficiente omettere
l'elemento <CacheResource>
.
Per saperne di più sulla configurazione delle cache, consulta l'articolo Memorizzazione nella cache per uso generico. Per scoprire di più sul datastore sottostante, consulta Informazioni interne della cache.
Variabili di flusso
Le variabili di flusso possono essere utilizzate per configurare il comportamento di runtime dinamico per criteri e flussi in base alle intestazioni HTTP o ai contenuti dei messaggi oppure al contesto disponibile nel flusso. Per ulteriori informazioni sulle variabili di flusso, consulta Riferimento per le variabili di flusso.
Le seguenti variabili di flusso predefinite sono disponibili dopo aver personalizzato il comportamento della cache definita in un criterio LookupCache.
Variabili | Tipo | Autorizzazione | Descrizione |
---|---|---|---|
lookupcache.{policy-name}.cachename | String | Sola lettura | Restituisce il nome della cache utilizzato nel criterio. |
lookupcache.{policy-name}.cachekey | String | Sola lettura | Restituisce la chiave utilizzata. |
lookupcache.{policy-name}.cachehit | Booleano | Sola lettura | True se il criterio ha trovato un valore per la chiave cache specificata. |
lookupcache.{nome-criteri}.assignto | String | Sola lettura | Restituisce la variabile a cui è assegnata la cache. |
Codici di errore
Questa sezione descrive i messaggi di errore e le variabili di flusso che vengono impostati quando questo criterio attiva un errore. Queste informazioni sono importanti per sapere se stai sviluppando regole di errore per un proxy. Per scoprire di più, consulta gli articoli Cosa devi sapere sugli errori relativi alle norme e Gestione degli errori.
Prefisso codice di errore
N/A
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.
Nome errore | Causa | Correggi |
---|---|---|
InvalidCacheResourceReference |
Questo errore si verifica se l'elemento <CacheResource> è impostato su un nome che non esiste nell'ambiente in cui viene eseguito il deployment del proxy API. |
build |
InvalidTimeout |
Se l'elemento <CacheLookupTimeoutInSeconds> è impostato su un numero negativo, il deployment del proxy API non va a buon fine. |
build |
CacheNotFound |
Questo errore si verifica se la cache specifica menzionata nel messaggio di errore non è stata creata su un componente specifico dell'processore di messaggi. | build |
Variabili di errore
N/A
Esempio di risposta di errore
N/A