Habilitar o suporte à zona de disponibilidade em instâncias de Gerenciamento de API do Azure

2025-08-11

APLICA-SE A: Premium

Este guia de instruções descreve como habilitar e configurar zonas de disponibilidade em uma instância de Gerenciamento de API do Azure.

Para obter informações mais detalhadas sobre os recursos de confiabilidade do Gerenciamento de API, como zonas de disponibilidade e implantações de várias regiões, consulte Confiabilidade no Gerenciamento de API.

Importante

As alterações na infraestrutura do serviço de Gerenciamento de API (como configuração de domínios personalizados, adição de certificados de CA, dimensionamento, configuração de rede virtual, alterações de zona de disponibilidade e adições de região) podem levar 15 minutos ou mais para serem concluídas, dependendo da camada de serviço e do tamanho da implantação. Espere tempos mais longos para uma instância com um número maior de unidades de escala ou configuração de várias regiões. As alterações contínuas no Gerenciamento de API são executadas cuidadosamente para preservar a capacidade e a disponibilidade.

Enquanto o serviço está sendo atualizado, outras alterações na infraestrutura do serviço não podem ser feitas. No entanto, você pode definir APIs, produtos, políticas e configurações de usuário. O serviço não enfrentará tempo de inatividade do gateway e o Gerenciamento de API continuará a atender solicitações de API sem interrupção (exceto na camada de desenvolvedor).

Pré-requisitos

Para configurar zonas de disponibilidade para Gerenciamento de API, sua instância deve estar em uma das regiões do Azure que dão suporte a zonas de disponibilidade.
Se você não tiver uma instância de Gerenciamento de API, crie uma seguindo a criação de uma nova instância de Gerenciamento de API usando o início rápido do portal do Azure . Selecione a camada de serviço Premium .
Se você tiver uma instância de Gerenciamento de API existente, verifique se ela está na camada Premium (clássica). Se não estiver, atualize para o nível Premium.

Suporte à zona de disponibilidade padrão

Quando você cria uma nova instância de Gerenciamento de API na camada Premium em uma região que oferece suporte a zonas de disponibilidade ou implanta o Gerenciamento de API em várias regiões, o Gerenciamento de API fornece dois tipos de suporte à zona de disponibilidade:

Automático: O Gerenciamento de API fornece suporte automático à zona de disponibilidade quando você não especifica quais zonas de disponibilidade usar.
Manual: O Gerenciamento de API fornece suporte manual à zona de disponibilidade quando você especifica explicitamente quais zonas de disponibilidade usar.

Importante

Para garantir a confiabilidade de sua instância de Gerenciamento de API, recomendamos que você use o suporte automático à zona de disponibilidade. Para obter redundância máxima de zona, recomendamos que você implante um mínimo de duas unidades em cada região onde implanta o Gerenciamento de API para garantir que uma interrupção da zona de disponibilidade não afete sua instância. Para obter mais informações, consulte Confiabilidade no gerenciamento de API.

Suporte manual à zona de disponibilidade

Recomendamos a configuração automática da zona de disponibilidade, mas você pode configurar ou atualizar manualmente as zonas de disponibilidade para um local existente da sua instância de Gerenciamento de API. As seções a seguir fornecem etapas para configurar manualmente a redundância de zona em um local existente de sua instância de Gerenciamento de API, dependendo se a instância é injetada em uma rede virtual.

Observação

Opcionalmente, você pode habilitar uma configuração zonal , onde a instância ou o local do Gerenciamento de API é implantado em uma única zona de disponibilidade. Como não fornece resiliência a uma interrupção nessa zona, essa configuração geralmente não é recomendada, exceto para cenários específicos. Para obter mais informações, consulte Confiabilidade no gerenciamento de API.

Atenção

Se você configurar manualmente as zonas de disponibilidade em uma instância de Gerenciamento de API configurada com dimensionamento automático, talvez seja necessário ajustar as configurações de dimensionamento automático após a configuração. Nesse caso, o número de unidades de gerenciamento de API em regras e limites de dimensionamento automático deve ser um múltiplo do número de zonas. Se você usar como padrão o suporte à zona de disponibilidade automática, não precisará ajustar as configurações de dimensionamento automático.

Instância não injetada em uma rede virtual

Para configurar manualmente o suporte à zona de disponibilidade em um local existente de uma instância de Gerenciamento de API, siga estas etapas:

Compreenda completamente todos os requisitos e considerações para zonas de disponibilidade no Gerenciamento de API.
No portal do Azure, vá para sua instância de Gerenciamento de API.
No menu Implantação + infraestrutura, selecione Locais.
Selecione o local que você deseja habilitar. O local deve suportar zonas de disponibilidade, conforme mencionado anteriormente nos pré-requisitos.
Em Unidades, selecione o número de unidades de escala que pretende na localização.
Em Zonas de disponibilidade, deixe a configuração Automático (recomendado) ou, opcionalmente, selecione uma ou mais zonas. Se você selecionar zonas específicas, o número de unidades selecionadas deverá ser distribuído uniformemente pelas zonas de disponibilidade. Por exemplo, se você selecionar três unidades, deverá selecionar três zonas para que cada zona hospede uma unidade.
Selecione Aplicar e, em seguida, selecione Guardar.

Instância injetada em uma rede virtual

Para configurar manualmente o suporte à zona de disponibilidade em um local existente de uma instância de Gerenciamento de API injetada em uma rede virtual, siga estas etapas:

Entenda completamente todos os requisitos e considerações para habilitar a redundância de zona no Gerenciamento de API.
Crie um endereço IP público no local para habilitar as zonas de disponibilidade. Para obter requisitos detalhados, consulte as diretrizes de rede virtual.
No portal do Azure, vá para sua instância de Gerenciamento de API.
No menu Implantação + infraestrutura, selecione Locais.
Selecione o local que você deseja habilitar. O local deve suportar zonas de disponibilidade, conforme mencionado anteriormente nos pré-requisitos.
Em Unidades, selecione o número de unidades de escala que pretende na localização.
Em Zonas de disponibilidade, deixe a configuração Automático (recomendado) ou, opcionalmente, selecione uma ou mais zonas. Se você selecionar zonas específicas, o número de unidades selecionadas deverá ser distribuído uniformemente pelas zonas de disponibilidade. Por exemplo, se você selecionar três unidades, deverá selecionar três zonas para que cada zona hospede uma unidade.
Em Endereço IP público, selecione um endereço IP público no local.
Selecione Aplicar e, em seguida, selecione Guardar.

Nova localização do gateway

Para adicionar um novo local à sua instância de Gerenciamento de API e configurar zonas de disponibilidade nesse local, siga estas etapas:

Compreenda completamente todos os requisitos e considerações para habilitar zonas de disponibilidade no Gerenciamento de API.
Se sua instância de Gerenciamento de API for implantada em uma rede virtual no local principal, configure uma rede virtual, uma sub-rede e um endereço IP público opcional no novo local onde você planeja habilitar as zonas de disponibilidade.
No portal do Azure, vá para sua instância de Gerenciamento de API.
No menu Implantação + infraestrutura, selecione Locais.
Selecione + Adicionar para adicionar um novo local. O local deve suportar zonas de disponibilidade, conforme mencionado anteriormente nos pré-requisitos.
Em Unidades, selecione o número de unidades de escala que pretende na localização.
Em Zonas de disponibilidade, deixe a configuração Automático (recomendado) ou, opcionalmente, selecione uma ou mais zonas. Se você selecionar zonas específicas, o número de unidades selecionadas deverá ser distribuído uniformemente pelas zonas de disponibilidade. Por exemplo, se você selecionar três unidades, deverá selecionar três zonas para que cada zona hospede uma unidade.
Se sua instância de Gerenciamento de API for implantada em uma rede virtual, em Rede, selecione a rede virtual, a sub-rede e o endereço IP público disponíveis no local.
Selecione Adicionar e, em seguida, selecione Guardar.

Partilhar via