Partilhar via

Obter valor do cache

APLICA-SE A: Todas as camadas de gerenciamento de API

Use a política para executar a cache-lookup-value pesquisa de cache por chave e retornar um valor armazenado em cache. A chave pode ter um valor de cadeia arbitrário e é normalmente proporcionada com uma expressão de política.

Nota

Essa política deve ter um valor de Loja correspondente na política de 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.

Nota

Defina os elementos da política e os elementos filho na ordem fornecida na declaração de política. Saiba mais sobre como definir ou editar 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 Necessário Predefinição
tipo de cache Escolha entre os seguintes valores do atributo:
- internalpara usar o cache interno de Gerenciamento de API,
- external para usar o cache externo conforme descrito em Usar um Cache Redis do Azure externo no Gerenciamento de API do Azure,
- prefer-external para usar o cache externo, se configurado, ou o cache interno de outra forma.

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 de cache resultar em uma falha. Se este atributo não for especificado, null será atribuído. São permitidas expressões de política. Não null
chave Valor da chave de cache a ser usado na pesquisa. São permitidas expressões de política. Sim N/A
nome-variável Nome da variável de contexto à qual o valor pesquisado será atribuído, se a pesquisa for bem-sucedida. Se a pesquisa resultar em uma falha, a variável não será definida. Expressões de política não são permitidas. Sim N/A

Utilização

Notas de utilização

  • O Gerenciamento de API armazena em cache apenas as respostas às solicitações HTTP GET.
  • Esta política só pode ser utilizada uma vez numa secção de política.
  • Esta política não é suportada 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 evitar que o serviço de back-end fique 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.

Nota

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

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

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

Para obter mais informações e exemplos dessa política, consulte Cache personalizado no Gerenciamento de API do Azure.

Conteúdos relacionados

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

  • Last updated on