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 |
|---|---|---|---|
| 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 |
| default-value | 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 |
| variable-name | 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
- 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
Exemplo
<cache-lookup-value
key="@("userprofile-" + context.Variables["enduserid"])"
variable-name="userprofile" />
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
- Kit de ferramentas de políticas do Gerenciamento de API do Azure
- Criar políticas usando o Microsoft Copilot no Azure