Usar um cache compatível para Redis externo no Gerenciamento de API do Azure

APLICA-SE A: todas as camadas do Gerenciamento de API

Além de utilizar o cache interno, o Gerenciamento de API do Azure permite armazenar respostas em cache em um cache externo compatível com Redis, como o Redis Gerenciado do Azure.

Usar um cache externo permite a você superar algumas limitações do cache interno:

• Evitar que o cache seja periodicamente limpo durante as atualizações de Gestão de API
• Ter mais controle sobre sua configuração de cache
• Armazenar mais dados do que sua camada de Gerenciamento de API permite
• Usar o armazenamento em cache com a camada Consumo do Gerenciamento de API
• Habilitar o cache nos gateways de Gerenciamento de API auto-hospedados

Para obter contexto e cenários para cache, consulte a visão geral do cache.

Para saber mais sobre o cache, veja Políticas de armazenamento em cache do Gerenciamento de API e Armazenamento em cache personalizado no Gerenciamento de API do Azure.

O que você aprenderá:

Pré-requisitos

Para concluir este tutorial, você precisará:

• Criar uma instância do Gerenciamento de API do Azure

• Entender o cache no Gerenciamento de API do Azure

• Tenha um Redis Gerenciado do Azure ou outro cache compatível com Redis disponível.

  Importante

  O Gerenciamento de API do Azure usa uma cadeia de conexão Redis para se conectar ao cache. Se você usar o Redis Gerenciado do Azure, habilite a autenticação de chave de acesso em seu cache para usar uma cadeia de conexão. Atualmente, você não pode usar autenticação Microsoft Entra para conectar o Gerenciamento de API do Azure ao Azure Managed Redis.

Cache Redis para Kubernetes

Para um gateway auto-hospedado do API Management, o armazenamento precisa de um cache externo. Para que o cache seja eficaz, um gateway auto-hospedado e o cache do qual eles dependem devem estar localizados próximos um do outro para minimizar as latências de pesquisa e armazenamento. As melhores opções são implantar um cache Redis no mesmo cluster de Kubernetes ou em um cluster separado próximo. Saiba mais como implantar o cache Redis em um cluster de Kubernetes.

Adicionar um cache externo

Siga as etapas abaixo para adicionar um cache externo compatível com Redis no Gerenciamento de API do Azure. Você pode limitar o cache a um gateway específico em sua instância de Gerenciamento de API.

Usar a partir da configuração

A configuração Usar de especifica o local da instância de Gerenciamento de API que usará o cache. Selecione uma das seguintes:

• A região do Azure em que a instância de Gerenciamento de API está hospedada (ou um dos locais configurados, se você tiver uma implantação de várias regiões)

• Um local de gateway autônomo

• Padrão, para configurar o cache como o padrão para todos os locais de gateway na instância de Gerenciamento de API

  Um cache usado como Padrão é substituído por um cache usado para uma região ou local correspondente específico.

  Por exemplo, considere uma instância de Gerenciamento de API hospedada nas regiões Leste dos EUA, Sudeste da Ásia e Oeste da Europa. Há dois caches configurados, um para Padrão e outro para Sudeste da Ásia. Neste exemplo, o Gerenciamento de API no Sudeste da Ásia usará seu próprio cache, enquanto as outras duas regiões usarão a entrada de cache Padrão.

Adicionar uma instância do Redis Gerenciado do Azure da mesma assinatura

1. Navegue até sua instância de Gerenciamento de API no portal do Azure.
2. No menu à esquerda, em Implantação + infraestrutura, selecione Cache externo.
3. Selecione + Adicionar.
4. Selecione seu cache no menu suspenso Instância de cache.
5. Selecione Padrão ou especifique a região desejada no menu suspenso Usar de. A Cadeia de conexão é preenchida automaticamente.
6. Selecione Salvar.

Adicione um cache compatível com Redis hospedado fora da assinatura atual do Azure ou do Azure em geral

1. Navegue até sua instância de Gerenciamento de API no portal do Azure.
2. No menu à esquerda, em Implantação + infraestrutura, selecione Cache externo.
3. Selecione + Adicionar.
4. No menu suspenso Instância de cache, selecione Personalizado.
5. Selecione Padrão ou especifique a região desejada no menu suspenso Usar de.
6. Insira sua cadeia de conexão para o cache gerenciado da Azure Redis ou para um cache compatível com Redis no campo Cadeia de conexão.
7. Selecione Salvar.

Adicionar um cache Redis a um gateway auto-hospedado

1. No menu à esquerda, em Implantação + infraestrutura, selecione Cache externo.
2. Selecione + Adicionar.
3. No menu suspenso Instância de cache, selecione Personalizado.
4. Selecione Padrão ou especifique a região desejada no menu suspenso Usar de.
5. Insira a cadeia de conexão do cache Redis no campo Cadeia de conexão.
6. Selecione Salvar.

Usar o cache externo

Depois de adicionar um cache compatível com Redis, configure as políticas de cache para habilitar o cache de resposta ou o cache de valores por chave, no cache externo.

Para um exemplo detalhado, confira Adicionar cache para melhorar o desempenho no Gerenciamento de API do Azure.

Conteúdo relacionado

• Para saber mais sobre as políticas de cache, veja Políticas de cache na Referência de política do Gerenciamento de API.
• Para armazenar em cache itens por chave usando expressões de política, confira Cache personalizado no Gerenciamento de API do Azure.
• Saiba como habilitar o cache semântico para APIs LLM.