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 feedback sobre como o recurso está funcionando para você. Um recurso na visualização está funcionalmente completo, 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 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:
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 em conjunto 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 de 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 no 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 faço para copiar minha instância de serviço de Gerenciamento 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.
Posso mover uma instância de Gerenciamento de API de uma assinatura para outra?
Sim. Para saber como o fazer, consulte Mover recursos para um novo grupo de recursos ou subscrição.
Posso gerenciar minha instância de Gerenciamento 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 arquivos Bicep. Veja exemplos de modelos de início rápido.
- Terraforme.
Como faço para adicionar um usuário ao grupo Administradores?
O grupo Administradores é um grupo de sistema imutável que inclui administradores de assinatura 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 você deseja adicionar aparecer acinzentada ou esmaecida no editor de políticas, verifique se você está no escopo 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. É 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 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 aos serviços de computação do Azure comumente usados para criar e hospedar APIs no Azure, incluindo Azure Functions, Aplicativos Lógicos do Azure, Aplicativos de Contêiner do Azure e Aplicativos Web do Azure.
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 a implantação de 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, por exemplo https://contoso.com/sample/, é tratado como um diretório, enquanto o mesmo URL sem a barra à direita (https://contoso.com/sample) indica um arquivo. Esta convenção não é obrigatória. Alguns sistemas consideram esses dois URLs únicos, mas outros os consideram iguais. O Gerenciamento de API não faz uma distinção, portanto, uma única operação resource aceitará um resource ou resource/. 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 precisar, crie uma política de Reescrever URL para garantir que uma barra de fim 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 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.
Posso integrar o Gerenciamento de API diretamente com as soluções de banco de dados do Azure?
Sim, você pode integrar o Gerenciamento de API diretamente com 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.