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
tipo de cache 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
valor padrão 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
nome da variável 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

Notas de utilização

  • O Gerenciamento de API armazena em cache apenas respostas para solicitações HTTP GET.
  • Essa política só pode ser usada uma vez em uma seção de política.
  • Essa política não tem suporte dentro de um fragmento de política.
  • Recomendamos configurar uma política de limite de taxa (ou política de limite de taxa por chave ) imediatamente após qualquer pesquisa de cache. Isso ajuda a impedir que seu serviço de back-end seja sobrecarregado se o cache não estiver disponível.

Exemplo

Este exemplo mostra como usar a cache-lookup-value política para recuperar um perfil de usuário do cache. A chave para a pesquisa de cache é construída usando uma expressão de política que combina uma cadeia de caracteres com o valor da variável de enduserid contexto.

Observação

Adicione uma política de limite de taxa (ou política de limite de taxa por chave ) após a busca no cache para ajudar a limitar o número de chamadas e evitar sobrecarga no serviço backend caso o cache não esteja disponível.

Veja um exemplo de cache-store-value para armazenar o perfil do usuário no cache.

<cache-lookup-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    variable-name="userprofile" />
<rate-limit calls="10" renewal-period="60" />

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

Conteúdo relacionado

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

  • Last updated on