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 |
|---|---|---|---|
| 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 |
| default-value | 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 |
| key | Valor de clave de caché para usar en la búsqueda. Se permiten expresiones de directiva. | Sí | N/D |
| variable-name | 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
- 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
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).
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 mediante Microsoft Copilot en Azure