Obter valor do cache

  • Artigo

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

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.

Conteúdos relacionados

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