Armazenar valor em cache

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

cache-store-value armazena em cache por chave. A chave pode ter um valor de cadeia de caracteres arbitrária e geralmente é fornecida usando uma expressão de política.

Observação

A operação de armazenar o valor em cache executada por essa política é assíncrona. O valor armazenado pode ser recuperado com o uso da política Obter valor do cache. Porém, o valor armazenado pode não estar imediatamente disponível para recuperação, pois a operação assíncrona que armazena o valor no cache ainda pode estar em andamento.

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-store-value key="cache key value" value="value to cache" duration="seconds" 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
duração	Valor será armazenado em cache para o valor de duração fornecido, especificado em segundos. Expressões de política são permitidas.	Sim	N/D
chave	A chave em cache em que o valor será armazenado. Expressões de política são permitidas.	Sim	N/D
valor	O valor a ser armazenado em cache. Expressões de política são permitidas.	Sim	N/D

Uso

• Seções da política: entrada, saída, back-end, em caso de erro
• Escopos de política: global, espaço de trabalho, produto, API, operação
• Gateways: clássico, v2, consumo, auto-hospedado, workspace

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.
• 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-store-value política para armazenar um perfil de usuário no cache. A chave para a entrada 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.

Veja um exemplo de cache-lookup-value para recuperar o perfil do usuário do cache.

<cache-store-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    value="@((string)context.Variables["userprofile"])" duration="100000" />

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

Políticas relacionadas

• Cache

Conteúdo relacionado

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

• Tutorial: Transformar e proteger sua API
• Referência de Política para uma lista completa das instruções de política e suas configurações
• Expressões de política
• Definir ou editar políticas
• Reutilizar configurações de política
• Repositório de snippets de política
• Repositório de playground de políticas
• Kit de ferramentas de políticas do Gerenciamento de API do Azure
• Obter assistência do Copilot para criar, explicar e solucionar problemas de políticas