Obtenha 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 em versão prévia está funcionalmente concluído, mas alterações significativas podem ser feitas em resposta aos comentários dos clientes. Não recomendamos que você dependa de um recurso que esteja em versão prévia 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 seus serviços de back-end, incluindo:
- Usar autenticação com chave de assinatura. Por si só, uma chave de assinatura não é uma forma forte de autenticação, mas geralmente é 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 do TLS, conforme descrito em 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, consulte endereços IP no 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.
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 outros idiomas.
- Azure PowerShell e CLI do Azure.
- Arquivos do Bicep e Azure Resource Manager. 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 cinza ou esmaecida no editor de políticas, certifique-se de que você está no escopo correto da 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. É possível:
- 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 aos serviços de computação do Azure normalmente usados para criar e hospedar APIs no Azure, incluindo Azure Functions, Azure Logic Apps, Azure Container Apps, e Azure Web Apps.
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 rede virtual?
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 em 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 de 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 que termina com uma barra à direita, por exemplo https://contoso.com/sample/, é tratada como um diretório, enquanto a mesma URL sem a barra à direita (https://contoso.com/sample) indica um arquivo. Esta convenção não é obrigatória. Alguns sistemas consideram essas duas URLs exclusivas, mas outras as consideram iguais. O Gerenciamento de API não faz uma distinção, portanto, uma única operação resource aceitará tanto resource quanto resource/. No entanto, a distinção pode ser importante para o host de back-end. Alguns servidores Web redirecionam automaticamente uma URL que não termina com uma barra à direita para a mesma URL que termina em uma barra à direita. Como o Gerenciamento de API é o cliente para o back-end (servidor), nem sempre um redirecionamento automático é desejável. Se necessário, crie uma política de reescrita 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 depois de criá-la. 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.
Posso integrar o Gerenciamento de API diretamente às soluções de banco de dados do Azure?
Sim, você pode integrar o Gerenciamento de API diretamente a outros serviços do Azure sem um intermediário. Por exemplo, o Gerenciamento de API pode se integrar diretamente às APIs REST do Azure Cosmos DB para operações CRUD, eliminando a necessidade de serviços intermediários como o Azure Functions.