Recuperare valore dalla cache

SI APPLICA A: Tutti i livelli di Gestione API

Usare il criterio cache-lookup-value per eseguire la ricerca nella cache in base alla chiave e restituiscono un valore memorizzato nella cache. La chiave può avere un valore di stringa arbitrario e viene indicata in genere usando un'espressione di criteri.

Nota

Questo criterio deve essere associato a un criterio Archivia valore nella cache corrispondente.

Importante

La cache predefinita è volatile e viene condivisa da tutte le unità nella stessa area nello stesso servizio Gestione API.

Nota

Impostare gli elementi e gli elementi figlio del criterio nell'ordine specificato nell'istruzione del criterio. Altre informazioni su come impostare o modificare i criteri di API Management.

Istruzione del criterio

<cache-lookup-value key="cache key value"
    default-value="value to use if cache lookup resulted in a miss"
    variable-name="name of a variable looked up value is assigned to"
    caching-type="prefer-external | external | internal" />

Attributi

Attributo Descrizione Richiesto Valore predefinito
caching-type Scegliere tra i valori dell'attributo seguenti:
- internal per usare la cache di Gestione API predefinita,
- external per usare la cache esterna, come descritto in Usare una cache Redis esterna in Gestione API di Azure,
- prefer-external per usare la cache esterna se configurata o quella interna in caso contrario.

Le espressioni di criteri non sono consentite.
No prefer-external
default-value Un valore che verrà assegnato alla variabile se la ricerca della chiave nella cache non produce risultati. Se questo attributo viene omesso, viene assegnato null. Le espressioni di criteri sono consentite. No null
key Valore della chiave della cache da usare nella ricerca. Le espressioni di criteri sono consentite. N/D
variable-name Nome della variabile di contesto a cui verrà assegnato il valore cercato, se la ricerca ha esito positivo. Se la ricerca genera un mancato riscontro, la variabile non verrà impostata. Le espressioni di criteri non sono consentite. N/D

Utilizzo

Esempio

<cache-lookup-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    variable-name="userprofile" />

Per ulteriori informazioni ed esempi su questo criterio, vedere Memorizzazione nella cache personalizzata in Gestione API di Azure.

Per ulteriori informazioni sull'utilizzo dei criteri, vedere: