Armazenar valor em cache
APLICA-SE A: Todas as camadas de gerenciamento de API
O cache-store-value executa o armazenamento em cache por chave. A chave pode ter um valor de cadeia arbitrário e é normalmente proporcionada com uma expressão de política.
Nota
A operação de armazenamento do valor em cache executada por essa política é assíncrona. O valor armazenado pode ser recuperado usando Obter valor da política de cache . No entanto, o valor armazenado pode não estar imediatamente disponível para recuperação, uma vez que a operação assíncrona que armazena o valor em 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.
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-store-value key="cache key value" value="value to cache" duration="seconds" caching-type="prefer-external | external | internal" />
Atributos
| Atributo | Description | 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 |
| duration | O valor será armazenado em cache para o valor de duração fornecido, especificado em segundos. São permitidas expressões de política. | Sim | N/A |
| key | Chave de cache em que o valor será armazenado. São permitidas expressões de política. | Sim | N/A |
| valor | O valor a ser armazenado em cache. São permitidas expressões de política. | Sim | N/A |
Utilização
- Seções de política: entrada, saída, back-end, no erro
- Âmbitos de política: global, área de trabalho, produto, API, operação
- Gateways: clássico, v2, consumo, auto-hospedado, espaço de trabalho
Exemplo
<cache-store-value
key="@("userprofile-" + context.Variables["enduserid"])"
value="@((string)context.Variables["userprofile"])" duration="100000" />
Para obter mais informações e exemplos dessa política, consulte Cache personalizado no Gerenciamento de API do Azure.
Políticas relacionadas
Conteúdos relacionados
Para obter mais informações sobre como trabalhar com políticas, consulte:
- Tutorial: Transforme e proteja sua API
- Referência de política para uma lista completa de declarações de política e suas configurações
- Expressões de política
- Definir ou editar políticas
- Reutilizar configurações de política
- Recompra de trechos de política
- Kit de ferramentas de política de Gerenciamento de API do Azure
- Criar políticas usando o Microsoft Copilot no Azure