Store value in cache (Almacenar valor en la caché)
SE APLICA A: todos los niveles de API Management
La directiva cache-store-value realiza el almacenamiento en caché mediante una clave. La clave puede tener un valor de cadena arbitrario y normalmente se proporciona mediante una expresión de directiva.
Nota
La operación de almacenar el valor en caché que realiza esta directiva es asincrónica. El valor almacenado se puede recuperar mediante la directiva Get value from cache (Obtener valor de la caché). Sin embargo, puede que el valor almacenado no esté disponible inmediatamente para la recuperación, ya que la operación asincrónica que almacena el valor en caché puede estar aún en curso.
Importante
La caché integrada es volátil y se comparte entre todas las unidades de la misma región del mismo servicio de API Management.
Nota:
Establezca los elementos de la directiva y los elementos secundarios en el orden proporcionado en la instrucción de directiva. Obtenga más información sobre el establecimiento o modificación de directivas de API Management.
Instrucción de la directiva
<cache-store-value key="cache key value" value="value to cache" duration="seconds" caching-type="prefer-external | external | internal" />
Atributos
| Atributo | Descripción | Necesario | Valor predeterminado |
|---|---|---|---|
| caching-type | Elija entre los siguientes valores del atributo: - internal para usar la caché de API Management integrada,- external para usar la caché externa tal como se describe en - ,- prefer-external para usar la caché externa si está configurada o, en caso contrario, la caché interna.No se permiten expresiones de directiva. |
No | prefer-external |
| duration | El valor se almacenará en la caché según el valor de duración proporcionado, especificado en segundos. Se permiten expresiones de directiva. | Sí | N/D |
| key | La clave de caché con la que se almacenará el valor. Se permiten expresiones de directiva. | Sí | N/D |
| value | El valor que se almacenará en la caché. Se permiten expresiones de directiva. | Sí | N/D |
Uso
- Secciones de directiva: entrante, saliente, back-end, on-error
- Ámbitos de la directiva: global, área de trabajo, producto, API, operación
- Puertas de enlace: clásica, v2, consumo y autohospedada
Ejemplo
<cache-store-value
key="@("userprofile-" + context.Variables["enduserid"])"
value="@((string)context.Variables["userprofile"])" duration="100000" />
Para más información y ver ejemplos de esta directiva, consulte Custom caching in Azure API Management (Almacenamiento en caché personalizado en Azure API Management).
Directivas relacionadas
Contenido relacionado
Para más información sobre el trabajo con directivas, vea:
- Tutorial: Transformación y protección de una API
- Referencia de directivas para una lista completa de instrucciones de directivas y su configuración
- Expresiones de directiva
- Establecimiento o edición de directivas
- Reutilización de configuraciones de directivas
- Repositorio de fragmentos de código de directiva
- Creación de directivas con Microsoft Copilot para Azure