Archiviare il valore nella cache
SI APPLICA A: Tutti i livelli di Gestione API
cache-store-value esegue l'archiviazione nella cache in base alla chiave. La chiave può avere un valore di stringa arbitrario e viene indicata in genere usando un'espressione di criteri.
Nota
L'operazione di archiviazione del valore nella cache eseguita da questo criterio è asincrona. Il valore archiviato può essere recuperato usando il criterio Ottenere valore dalla cache. Tuttavia, il valore archiviato potrebbe non essere immediatamente disponibile per il recupero perché l'operazione asincrona che archivia il valore nella cache potrebbe essere ancora in corso.
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 dei criteri. Altre informazioni su come impostare o modificare i criteri di Gestione API.
Istruzione del criterio
<cache-store-value key="cache key value" value="value to cache" duration="seconds" 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 |
| duration | Il valore verrà memorizzato nella cache per il valore di durata specificato, espresso in secondi. Le espressioni di criteri sono consentite. | Sì | N/D |
| key | La chiave della cache in cui verrà archiviato il valore. Le espressioni di criteri sono consentite. | Sì | N/D |
| value | Il valore da memorizzare nella cache. Le espressioni di criteri 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
Esempio
<cache-store-value
key="@("userprofile-" + context.Variables["enduserid"])"
value="@((string)context.Variables["userprofile"])" duration="100000" />
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 con Microsoft Copilot per Azure