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. | 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
- Sezioni del criterio: inbound, outbound, backend, on-error
- Ambiti del criterio: globale, area di lavoro, prodotto, API, operazione
- Gateway: classico, v2, consumo, self-hosted, area di lavoro
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.
Criteri correlati
Contenuto correlato
Per ulteriori informazioni sull'utilizzo dei criteri, vedere:
- Esercitazione: trasformare e proteggere l'API
- Informazioni di riferimento sui criteri per un elenco completo delle istruzioni dei criteri e delle relative impostazioni
- Espressioni di criteri
- Impostare o modificare criteri
- Riutilizzare le configurazioni dei criteri
- Repository dei frammenti di criteri
- Creare criteri usando Microsoft Copilot in Azure