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 | 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 |
| 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 |
| key | Valor da chave de cache a ser usado na pesquisa. São permitidas expressões de política. | Sim | N/A |
| variable-name | 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
- 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-lookup-value
key="@("userprofile-" + context.Variables["enduserid"])"
variable-name="userprofile" />
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