Obtenha as respostas para perguntas comuns sobre o Gerenciamento de API do Azure.
O que significa quando um recurso está em visualização?
Quando um recurso está em visualização, isso significa que estamos buscando ativamente comentários sobre como o recurso está funcionando para você. Um recurso no modo de visualização está funcionalmente completo, mas é possível que façamos uma alteração importante em resposta aos comentários dos clientes. É recomendável que você não dependa de um recurso que está na visualização em seu ambiente de produção.
Como faço para descobrir sobre atualizações e alterações no Gerenciamento de API?
Assine os comunicados de atualização publicados nestes locais:
Como proteger a conexão entre o gateway de Gerenciamento de API e meus serviços de back-end?
Você tem várias opções para proteger a conexão entre o gateway de Gerenciamento de API e os serviços de back-end, incluindo:
- Usar autenticação com chave de assinatura. Por conta própria, uma chave de assinatura não é uma forma forte de autenticação, mas costuma ser usada junto com outro método. Para saber mais, confira Autenticação e autorização no Gerenciamento de API.
- Use a autenticação mútua de TLS conforme descrito em Saiba como proteger serviços de back-end usando a autenticação de certificado do cliente no Gerenciamento de API do Azure.
- Use a filtragem de IP em seu serviço de back-end. Em todas as camadas de Gerenciamento de API, exceto na camada de consumo, o endereço IP do gateway permanece constante. Para obter mais informações, confira Endereços IP do Gerenciamento de API do Azure.
- Conecte sua instância de Gerenciamento de API a uma Rede Virtual do Azure.
- Configurar a autorização OAuth 2.0. Para saber mais, confira Autenticação e autorização no Gerenciamento de API.
Como copiar minha instância do serviço de Gerenciamento de API para uma nova instância?
Você tem várias opções, incluindo:
- Usar a funcionalidade de backup e restauração no Gerenciamento de API.
- Crie o seu recurso de backup e restauração usando a API REST do Gerenciamento de API para salvar e restaurar as entidades desejadas de sua instância de serviço.
- Baixe a configuração de serviço usando o Git e carregue-a em uma nova instância.
Posso mover a instância do Gerenciamento de API de uma assinatura para outra?
Sim. Para saber como, confira Mover recursos para um novo grupo de recursos ou assinatura.
Posso gerenciar minha instância de Gerenciamento de API por meio de programação?
Sim, você pode gerenciar o Gerenciamento de API programaticamente usando uma variedade de ferramentas, incluindo:
- A API REST de Gerenciamento de API
- SDKs de cliente do Azure para .NET, JavaScript, Java e outras linguagens
- Azure PowerShell e CLI do Azure
- Modelos do Azure Resource Manager e do Bicep. Confira exemplos de modelos de início rápido.
- Terraform
Como adicionar um usuário ao grupo Administradores?
O grupo de administradores é um grupo de sistema imutável que inclui os administradores de assinatura do Azure. Você não pode adicionar um usuário ao grupo. Para obter mais informações, consulte Como criar e usar grupos para gerenciar contas de desenvolvedor no Gerenciamento de API do Azure.
Por que a política que desejo adicionar não está disponível no editor de política?
Se a política que você deseja adicionar aparecer em cinza ou sombreada no editor de política, verifique se você está no escopo correto para a política. Cada declaração de política foi projetada para uso nas seções de política e escopos específicas. Para examinar as seções da política e os escopos de uma política, confira a seção referência à política.
Como configurar vários ambientes em uma única API?
Para configurar vários ambientes, por exemplo, um ambiente de teste e um ambiente de produção, em uma única API, você tem duas opções. Você pode:
- Hospede APIs diferentes na mesma instância de Gerenciamento de API.
- Hospede as mesmas APIs em instâncias diferentes.
O Gerenciamento de API dá suporte apenas a back-ends da API REST?
O Gerenciamento de API dá suporte a APIs REST, bem como passagem para APIs SOAP, WebSocket e GraphQL. O Gerenciamento de API também dá suporte a APIs sintéticas do GraphQL.
O Gerenciamento de API também se integra às ofertas de computação do Azure comumente usadas para criar e hospedar APIs no Azure, incluindo Funções, Aplicativos Lógicos, Aplicativos de Contêiner e Aplicativos Web.
Há restrições com a importação da minha API?
Confira Restrições de importação de API e problemas conhecidos para formatos OpenAPI (Swagger), WSDL e WADL.
Posso usar CI/CD para desenvolvimento de API?
Sim. Para obter mais informações, confira Usar DevOps e CI/CD para publicar APIs.
Para obter diretrizes de arquitetura, confira Acelerador de zona de destino do Gerenciamento de API do Azure.
Que método de roteamento o Gerenciamento de API usa quando implantado em vários locais geográficos?
O Gerenciamento de API usa o método de roteamento de tráfego de desempenho (menos latência) em implantações em vários locais geográficos. Para saber mais, confira Implantar uma instância de Gerenciamento de API do Azure em várias regiões do Azure.
O Gerenciamento de API funciona com o Azure ExpressRoute?
Sim.
Qual é o tamanho mínimo de sub-rede necessário ao implantar o Gerenciamento de API em uma VNet?
O tamanho mínimo de sub-rede necessário para implantar o Gerenciamento de API é /29. Saiba mais sobre como usar o Gerenciamento de API nas redes virtuais.
O Gerenciamento de API fornece um WAF (firewall do aplicativo Web)?
Embora o Gerenciamento de API não inclua um componente WAF, é recomendável implantar um WAF upstream (na frente) da instância do Gerenciamento de API. Por exemplo, use o Gateway de Aplicativo do Azure ou o Azure Front Door.
Quais são as diferenças entre o gateway gerenciado e o gateway auto-hospedado?
Para obter informações, confira Gateway de API no Gerenciamento de API e visão geral do gateway auto-hospedado.
Como o Gerenciamento de API lida com as barras à direita ao chamar os serviços de back-end?
Historicamente e por convenção, uma URL terminada com uma barra à direita é tratada como um diretório, por exemplo, https://contoso.com/sample/; enquanto a mesma URL sem a barra à direita https://contoso.com/sample; indicaria um arquivo. Isso não é obrigatório; alguns sistemas consideram essas duas URLs únicas, outros consideram iguais. O Gerenciamento de API não faz distinção. Portanto, uma só operação resource aceitará resource ou resource/. No entanto, a distinção pode ser importante para o host de back-end. Alguns servidores Web redirecionarão automaticamente uma URL que não termine com uma barra à direita para a mesma URL terminada em uma barra à direita. Como o Gerenciamento de API é o cliente do back-end (servidor), um redirecionamento automático nem sempre é desejável. Se necessário, crie uma política de regravação de URL para garantir que uma barra à direita seja sempre adicionada à chamada de back-end de saída.
O nome de uma API de Gerenciamento de API pode ser alterado?
Não, você não pode alterar o nome (ou ID) de uma API no Gerenciamento de API do Azure depois de criá-lo. No entanto, você pode alterar o nome de exibição.
Quando você clona uma API, a nova instância é criada com um valor gerado pelo sistema para o nome, que você não pode alterar. Para especificar um nome para a API, crie manualmente uma nova API e importe a definição de API. Para obter mais informações, consulte Como importar uma API.