Integrar uma instância do Gerenciamento de API do Azure a uma rede virtual privada para conexões de saída
APLICA-SE A: Standard v2 | Premium v2
Este artigo orienta você pelo processo de configuração integração de rede virtual para sua instância de Gerenciamento de API do Azure Standard v2 ou Premium v2 (versão prévia). Com a integração de rede virtual, sua instância pode fazer solicitações de saída para APIs hospedadas em uma sub-rede delegada de uma única rede virtual conectada.
Quando uma instância de Gerenciamento de API é integrada a uma rede virtual para solicitações de saída, os pontos de extremidade do gateway e do portal do desenvolvedor permanecem publicamente acessíveis. A instância de Gerenciamento de API pode alcançar serviços de back-end públicos e isolados pela rede.
Se você quiser injetar uma instância de Gerenciamento de API Premium v2 em uma rede virtual para isolar o tráfego de entrada e de saída, consulte Injetar uma instância Premium v2 em uma rede virtual.
Importante
- A integração de rede virtual de saída descrita neste artigo está disponível apenas para instâncias de Gerenciamento de API nas camadas Standard v2 e Premium v2. Para obter opções de rede nas diferentes camadas, consulte Usar uma rede virtual com o Gerenciamento de API do Azure.
- Você pode habilitar a integração de rede virtual ao criar uma instância de Gerenciamento de API na camada Standard v2 ou Premium v2 ou depois que a instância é criada.
- Atualmente, você não pode alternar entre a injeção de rede virtual e a integração de rede virtual para uma instância Premium v2.
Pré-requisitos
- Uma instância do Gerenciamento de API do Azure no tipo de preço Standard v2 ou Premium v2
- (Opcional) Para teste, uma API de back-end de exemplo hospedada em uma sub-rede diferente na rede virtual. Por exemplo, consulte Tutorial: Estabelecer o acesso ao site privado do Azure Functions.
- Uma rede virtual com uma sub-rede em que as APIs de back-end do Gerenciamento de API estão hospedadas. Consulte as seções a seguir para obter requisitos e recomendações para a rede virtual e a sub-rede.
Local da rede
- A rede virtual deve estar na mesma região e assinatura do Azure que a instância do Gerenciamento de API.
Requisitos de sub-rede
- A sub-rede não pode ser compartilhada com outro recurso do Azure.
Tamanho da sub-rede
- Mínimo: /27 (32 endereços)
- Recomendado: /24 (256 endereços) – para acomodar o dimensionamento da instância de Gerenciamento de API
Grupo de segurança de rede
Um grupo de segurança de rede deve ser associado à sub-rede.
Delegação de sub-rede
A sub-rede precisa ser delegada ao serviço Microsoft.Web/serverFarms.
Observação
Talvez seja necessário registrar o provedor de recursos Microsoft.Web/serverFarms na assinatura para que você possa delegar a sub-rede ao serviço.
Para obter mais informações sobre como configurar a delegação de sub-rede, consulte Adicionar ou remover uma delegação de sub-rede.
Permissões
Você deve ter pelo menos as seguintes permissões de controle de acesso baseadas em função na sub-rede ou em um nível mais alto para configurar a integração de rede virtual:
| Ação | Descrição |
|---|---|
| Microsoft.Network/virtualNetworks/read | Ler a definição de rede virtual |
| Microsoft.Network/virtualNetworks/subnets/read | Ler uma definição de sub-rede de rede virtual |
| Microsoft.Network/virtualNetworks/subnets/join/action | Ingressar em uma rede virtual |
Configurar a integração de rede virtual
Esta seção orienta você pelo processo de configurar a integração de rede virtual externa para uma instância existente do Gerenciamento de API do Azure.
No portal do Azure, navegue até a instância do Gerenciamento de API.
No menu à esquerda, em Implantação + Infraestrutura, selecione Rede.
No cartão de tráfego de saída, selecione integração de rede virtual.
Na folha Rede virtual, habilite a caixa de seleção de Rede virtual.
Selecione o local da instância de Gerenciamento de API.
Na Rede virtual, selecione a rede virtual e a sub-rede delegada que você deseja integrar.
Selecione Aplicar e depois em Salvar. A rede virtual é integrada.
(Opcional) Testar a integração de rede virtual
Se você tiver uma API hospedada na rede virtual, poderá importá-la para sua instância de Gerenciamento e testar a integração de rede virtual. Para obter etapas básicas, consulte Importar e publicar uma API.