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
Tipo de almacenamiento en caché	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
duración	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
clave	La clave de caché con la que se almacenará el valor. Se permiten expresiones de directiva.	Sí	N/D
valor	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, autohospedada y área de trabajo

Notas de uso

• API Management solo almacena en caché las respuestas a las solicitudes HTTP GET.
• Esta directiva solo se puede usar una vez en una sección de directiva.
• Se recomienda configurar una directiva de límite de velocidad (o directiva de límite de velocidad por clave ) inmediatamente después de cualquier búsqueda de caché. Esto ayuda a evitar que el servicio back-end se sobrecargue si la memoria caché no está disponible.

Ejemplo

En este ejemplo se muestra cómo usar la cache-store-value directiva para almacenar un perfil de usuario en la memoria caché. La clave de la entrada de caché se construye mediante una expresión de directiva que combina una cadena con el valor de la enduserid variable de contexto.

Consulte un ejemplo de cache-lookup-value para recuperar el perfil de usuario de la memoria caché.

<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

• Almacenamiento en caché

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
• Repositorio de área de juegos de directivas
• Kit de herramientas de directivas de Azure API Management
• Obtener ayuda de Copilot para crear, explicar y solucionar problemas de directivas