Compartilhar via


Obter valor do cache

APLICA-SE A: todas as camadas do Gerenciamento de API

Use a política cache-lookup-value para executar a consulta em cache por chave e retornar um valor armazenado em cache. A chave pode ter um valor de cadeia de caracteres arbitrária e geralmente é fornecida usando uma expressão de política.

Observação

É necessário ter uma política correspondente de Armazenar valor em cache.

Importante

O cache interno é volátil e compartilhado por todas as unidades na mesma região, no mesmo serviço de Gerenciamento de API.

Observação

Defina os elementos da política e os elementos filho na ordem fornecida na declaração da política. Saiba mais sobre como definir e editar as políticas de Gerenciamento de API.

Declaração de política

<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 Descrição Obrigatório Padrão
caching-type Escolha entre os seguintes valores do atributo:
- internal para usar o cache interno do Gerenciamento de API,
- external para usar o cache externo, conforme descrito em - ,
- prefer-external para usar cache externo se configurado ou cache interno.

Expressões de política não são permitidas.
Não prefer-external
default-value Um valor que será atribuído à variável se a pesquisa de chave em cache resultou em um erro. Se esse atributo não for especificado, null é atribuído. Expressões de política são permitidas. Não null
chave Valor de chave de cache a usar na pesquisa. Expressões de política são permitidas. Sim N/D
variable-name Nome da variável de contexto a atribuir para o valor pesquisado, se a pesquisa for bem-sucedida. Se a pesquisa resulta em um erro, a variável não será definida. Expressões de política não são permitidas. Sim N/D

Uso

Exemplo

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

Para saber mais e obter exemplos dessa política, veja Cache personalizado no Gerenciamento de API do Azure.

Para obter mais informações sobre como trabalhar com políticas, consulte: