Ferramentas de persistência no Edge

Você está visualizando a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
info

O que está aqui

Os mecanismos do Apigee Edge para armazenamento em cache e persistência incluem persistência de curto prazo e de longo prazo. Há políticas para armazenamento em cache de resposta e de uso geral. Use a API de gerenciamento para gerenciar caches.

Armazenamento em cache de resposta de back-end

É possível armazenar em cache a resposta de um recurso de back-end com a política de Response cache.

Isso é especialmente útil quando os dados de back-end são atualizados periodicamente. A política ResponseCache pode reduzir as chamadas para fontes de dados de back-end.

Com a política ResponseCache, também é possível fazer com que o Edge analise determinados cabeçalhos de cache de resposta HTTP e execute ações de acordo com as diretivas de cabeçalho. Por exemplo, em respostas de destinos de back-end, o Edge aceita o cabeçalho Cache-Control. Esse cabeçalho pode ser usado para controlar a idade máxima de uma resposta armazenada em cache, entre outras coisas. Para mais informações, consulte Suporte para cabeçalhos de resposta HTTP.

Armazenamento em cache de curto prazo para fins gerais

Usando políticas para armazenamento em cache de uso geral, é possível manter todos os objetos que seu proxy exigir em várias sessões de solicitação/resposta.

Com as políticas Populate Cache, LookupCache e InvalidateCache, é possível preencher, recuperar e limpar dados em cache no tempo de execução.

Por exemplo, é possível armazenar temporariamente os dados abaixo:

  • IDs de sessão para gerenciamento de sessão.
  • Credenciais para chamadas realizadas (como chaves de API ou tokens de acesso OAuth).
  • Conteúdo de resposta que precisa ser paginado para aplicativos.

No ambiente de execução, as políticas de cache copiam valores entre variáveis de proxy e o cache configurado especificado por você. Quando um valor é colocado no cache, ele é copiado da variável especificada para o cache. Quando ele é recuperado do cache, ele é copiado na variável para uso pelo proxy.

Para ver um exemplo com código, consulte Exemplo: armazenamento em cache de uso geral.

Persistência de longo prazo com mapas de chave-valor (KVMs, na sigla em inglês)

Para armazenar dados estruturados indefinidamente ou criptografados, crie e preencha mapas de chave-valor (KVMs) que contêm pares de chave/valor arbitrários. Por exemplo, é possível armazenar os seguintes dados:

  • Um mapa que correlaciona os endereços IP com os códigos de país.
  • Uma lista de endereços IP para inclusão/exclusão de lista.
  • Um mapa correlacionando URLs longos com URLs encurtados.
  • Dados específicos do ambiente, como contagens de cotas e prazos de validade do token OAuth.

Os KVMs podem ter um destes três escopos: organização, ambiente, apiproxy. Por exemplo, se for preciso usar pares de chave-valor para todas as APIs de uma organização, crie uma KVM no escopo da organização. Ou se apenas um proxy de API específico deve ter acesso a chaves/valores, crie a KVM no escopo apiproxy. É possível criar, gerenciar e extrair mapas de chave-valor de várias maneiras. Para mais informações, consulte Como trabalhar com mapas de chave-valor.

Como gerenciar o cache com a API de gerenciamento

Se você quiser criar, consultar, atualizar, excluir e limpar o cache fora do escopo das políticas em um fluxo de mensagens, use a API de gerenciamento de caches.