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 feedback sobre como o recurso está funcionando para você. Um recurso na visualização está funcionalmente completo, mas é possível que façamos uma alteração significativa em resposta ao feedback dos clientes. Recomendamos que você não dependa de um recurso que esteja em visualização em seu ambiente de produção.
Como faço para saber mais sobre atualizações e alterações no Gerenciamento de API?
Inscreva-se para atualizar anúncios publicados nestes locais:
- Notas de versão do Azure API Management.
- Atualizações do Azure
Como posso 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:
- Use a autenticação de 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 obter mais informações, consulte Autenticação e autorização no gerenciamento de API.
- Use a autenticação mútua TLS conforme descrito em Como proteger serviços back-end usando a autenticação de certificado de cliente no Gerenciamento de API do Azure.
- Use a filtragem de IP em seu serviço de back-end. Em todas as camadas do Gerenciamento de API, exceto a camada Consumo, o endereço IP do gateway permanece constante. Para obter mais informações, consulte Endereços IP do Gerenciamento de API do Azure.
- Conecte sua instância de Gerenciamento de API a uma rede virtual do Azure.
- Configure a autorização do OAuth 2.0. Para obter mais informações, consulte Autenticação e autorização no gerenciamento de API.
Como copio a minha instância de serviço de Gestão de API para uma nova instância?
Tem várias opções, entre as quais:
- Utilizar a funcionalidade de cópia de segurança e restauro da Gestão de API.
- Criar a sua própria funcionalidade de cópia de segurança e restauro com a API REST da Gestão de API para guardar e restaurar as entidades a partir da instância de serviço que pretende.
- Transferir a configuração do serviço através do Git e, depois, carregá-la para uma instância nova.
Posso mover uma instância de Gerenciamento de API de uma assinatura para outra?
Sim. Para saber como o fazer, veja Mover recursos para um novo grupo de recursos ou subscrição.
Posso gerir a minha instância da Gestão de API programaticamente?
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
- Azure Resource Manager e modelos Bicep. Veja exemplos de modelos de início rápido.
- Terraform
Como posso adicionar um utilizador ao grupo de Administradores?
O grupo Administradores é um grupo de sistema imutável que inclui administradores de subscrição do Azure. Não é possível adicionar um utilizador a este 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 eu quero adicionar não está disponível no editor de políticas?
Se a política que pretende adicionar aparecer a cinzento ou sombreada no editor de políticas, certifique-se de que está no âmbito correto da política. Cada declaração de política é projetada para uso em escopos e seções de política específicos. Para rever as secções e os âmbitos da política de uma política, consulte a secção Utilização da política na referência da política.
Como configuro 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. Pode:
- Hospede APIs diferentes na mesma instância de Gerenciamento de API.
- Hospede as mesmas APIs em instâncias diferentes.
O Gerenciamento de API suporta apenas back-ends de API REST?
O Gerenciamento de API suporta APIs REST, bem como passagem para APIs SOAP, WebSocket e GraphQL. O Gerenciamento de API também suporta 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 na importação da minha API?
Consulte Restrições de importação de API e problemas conhecidos para os formatos OpenAPI (Swagger), WSDL e WADL.
Posso usar CI/CD para desenvolvimento de API?
Sim. Para obter mais informações, consulte Usar DevOps e CI/CD para publicar APIs.
Para obter orientação de arquitetura, consulte Acelerador de zona de aterrissagem do Gerenciamento de API do Azure.
Qual método de roteamento o Gerenciamento de API usa em implantações em vários locais geográficos?
O Gerenciamento de API usa o método de roteamento de tráfego de desempenho (menor latência) em implantações para vários locais geográficos. Para obter mais informações, consulte 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 firewall de aplicativo Web (WAF)?
Embora o Gerenciamento de API não inclua um componente WAF, recomenda-se implantar um WAF upstream (na frente) da instância de Gerenciamento de API. Por exemplo, use o Azure Application Gateway ou o Azure Front Door.
Quais são as diferenças entre o gateway gerenciado e o gateway auto-hospedado?
Para obter informações, consulte Gateway de API em Gerenciamento de API e Visão geral do gateway auto-hospedado.
Como o Gerenciamento de API lida com barras à direita ao chamar serviços de back-end?
Historicamente e por convenção, um URL terminado com uma barra à direita é tratado como um diretório, por exemplo https://contoso.com/sample/ , enquanto o mesmo URL sem a barra https://contoso.com/sample à direita indicaria um arquivo. Isso não é obrigatório; alguns sistemas consideram esses dois URLs únicos, outros os consideram iguais. O Gerenciamento de API não faz uma distinção, portanto, uma única operação resource aceitará ou resourceresource/. No entanto, a distinção pode ser importante para o host de back-end. Alguns servidores Web redirecionam automaticamente um URL que não termina com uma barra à direita, para o mesmo URL que termina numa barra à direita. Como o Gerenciamento de API é o cliente para o back-end (servidor), um redirecionamento automático nem sempre é desejável. Se necessário, crie uma política de Reescrever 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, não é possível alterar o nome (ou ID) de uma API no Gerenciamento de API do Azure depois de criá-la. No entanto, você pode alterar o nome para exibição.
Quando você clona uma API, a nova instância é criada com um valor gerado pelo sistema para o nome, que não pode ser alterado. Para especificar um nome para a API, crie manualmente uma nova API e importe a definição da API. Para obter mais informações, consulte Importar uma API.