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 |
|---|---|---|---|
| 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 |
| duration | 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 |
| value | 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
Exemplo
<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
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
- Criar políticas usando o Microsoft Copilot para Azure