Condividi tramite

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
valore predefinito 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
chiave Valore della chiave della cache da usare nella ricerca. Le espressioni di criteri sono consentite. Sì 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. Sì N/D

Utilizzo

Note sull'utilizzo

  • Gestione API memorizza nella cache solo le risposte alle richieste HTTP GET.
  • Questo criterio può essere usato una sola volta in una sezione di criteri.
  • Questo criterio non è supportato all'interno di un frammento di criteri.
  • È consigliabile configurare criteri di limite di frequenza (o criteri rate-limit-by-key ) immediatamente dopo qualsiasi ricerca nella cache. Ciò consente di evitare che il servizio back-end venga sovraccaricato se la cache non è disponibile.

Esempio

Questo esempio illustra come usare i cache-lookup-value criteri per recuperare un profilo utente dalla cache. La chiave per la ricerca della cache viene costruita usando un'espressione di criteri che combina una stringa con il valore della enduserid variabile di contesto.

Nota

Aggiungi una policy di limite di velocità (o politica limite di velocità per chiave ) dopo la ricerca della cache per aiutare a limitare il numero di chiamate e prevenire sovraccarichi sul servizio backend nel caso in cui la cache non sia disponibile.

Vedere un esempio di cache-store-value per archiviare il profilo utente nella cache.

<cache-lookup-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    variable-name="userprofile" />
<rate-limit calls="10" renewal-period="60" />

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

Contenuto correlato

Per ulteriori informazioni sull'utilizzo dei criteri, vedere:

  • Last updated on