Compartilhar via


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

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.

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