Compartir a través de

Get value from cache (Obtener valor de la caché)

SE APLICA A: todos los niveles de API Management

Use la directiva cache-lookup-value para realizar la búsqueda en la caché por clave y devolver un valor almacenado en caché. La clave puede tener un valor de cadena arbitrario y normalmente se proporciona mediante una expresión de directiva.

Nota

Esta directiva debe tener una directiva Store value in cache (Almacenar valor en la caché) correspondiente.

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-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" />

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
valor predeterminado Un valor que se asignará a la variable si la búsqueda de la clave de caché da lugar a un error. Si no se especifica este atributo, se asigna null. Se permiten expresiones de directiva. No null
clave Valor de clave de caché para usar en la búsqueda. Se permiten expresiones de directiva. Sí N/D
nombre de variable Nombre de la variable de contexto a la que se asignará el valor buscado si la búsqueda tiene éxito. Si la búsqueda no tiene éxito, la variable no se establecerá. No se permiten expresiones de directiva. Sí N/D

Uso

Ejemplo

<cache-lookup-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    variable-name="userprofile" />

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).

Contenido relacionado

Para más información sobre el trabajo con directivas, vea: