Camadas do Gerenciamento de API do Azure v2
APLICA-SE A: Básico v2 | Standard v2 | Premium v2
As SKUs (camadas de Gerenciamento de API v2) são criadas em uma plataforma nova, mais confiável e escalonável e foram projetadas para tornar o Gerenciamento de API acessível a um conjunto mais amplo de clientes e oferecer opções flexíveis para uma variedade maior de cenários. As camadas v2 são além das camadas clássicas existentes (Desenvolvedor, Basic, Standard e Premium) e da camada Consumo. Consulte a comparação detalhada das camadasde Gerenciamento de API.
As seguintes camadas v2 geralmente estão disponíveis:
Básico v2 – A camada básica v2 foi projetada para cenários de desenvolvimento e teste e tem suporte com um SLA.
Standard v2 – Standard v2 é uma camada pronta para produção com suporte para back-ends isolados de rede.
A seguinte camada v2 está em versão prévia:
Premium v2 – Premium v2 oferece recursos corporativos, incluindo isolamento de rede virtual completo e dimensionamento para cargas de trabalho de alto volume.
Observação
A camada Premium v2 está atualmente em versão prévia limitada. Para se inscrever, preencha este formulário.
Principais recursos
Implantação, configuração e dimensionamento mais rápidos – implante uma instância de Gerenciamento de API pronta para produção em minutos. Aplique rapidamente configurações como atualizações de certificado e nome do host. Dimensione rapidamente uma instância básica v2 ou Standard v2 para até 10 unidades para atender às necessidades de suas cargas de trabalho de gerenciamento de API. Dimensione uma instância Premium v2 para até 30 unidades.
Rede simplificada – as camadas Standard v2 e Premium v2 fornecem opções de rede para isolar o tráfego de entrada e saída do Gerenciamento de API.
Mais opções para cargas de trabalho de produção – todas as camadas v2 têm suporte com um SLA.
Opções do portal do desenvolvedor – habilite o portal do desenvolvedor quando estiver pronto para permitir que os consumidores de API descubram suas APIs.
Recursos
Versão da API
Os recursos mais recentes das camadas v2 têm suporte na API de Gerenciamento de API versão 2024-05-01 ou posterior.
Opções de rede
Standard v2 e Premium v2 dão suporte à integração de rede virtual para permitir que sua instância de Gerenciamento de API alcance back-ends de API isolados em uma única rede virtual conectada. O gateway de Gerenciamento de API, o plano de gerenciamento e o portal do desenvolvedor permanecem publicamente acessíveis pela Internet. A rede virtual deve estar na mesma região e assinatura da instância de Gerenciamento de API. Saiba mais.
Na versão prévia, o Standard v2 também dá suporte a conexões de ponto de extremidade privado de entrada ao gateway de Gerenciamento de API.
Premium v2 também dá suporte à injeção de rede virtual simplificada para isolamento completo do tráfego de gateway de entrada e saída sem a necessidade de regras de grupo de segurança de rede, tabelas de rotas ou pontos de extremidade de serviço. A rede virtual deve estar na mesma região e assinatura da instância de Gerenciamento de API. Saiba mais.
Regiões com suporte
Para obter uma lista atual de regiões em que as camadas v2 estão disponíveis, consulte Disponibilidade de camadas v2 e gateways de workspace.
Disponibilidade de recursos clássicos
Há suporte para a maioria dos recursos das camadas clássicas de Gerenciamento de API nas camadas v2. Mas, os seguintes recursos não são compatíveis nos níveis v2:
- Configuração do serviço do API Management usando o Git
- Backup e restauração da instância do API Management
- Habilitar a Proteção contra DDoS do Azure
- Acesso à API de Gerenciamento Direto
Limitações
Os seguintes recursos de Gerenciamento de API estão atualmente indisponíveis nas camadas v2.
Infraestrutura e rede
- Implantação em várias regiões
- Suporte à zona de disponibilidade
- Vários nomes de domínio personalizado
- Métrica de capacidade – substituída pela Porcentagem de CPU de Gateway e Porcentagem de Memória das métricas do Gateway
- Análise interna – substituída pelo painel baseado no Azure Monitor
- Dimensionamento automático
- Atualizar para camadas v2 de camadas clássicas
- Certificados de Autoridade de Certificação
- Enviando eventos para a Grade de Eventos
Portal do desenvolvedor
- Relatórios
- Widget de código HTML personalizado e widget personalizado
- Portal do desenvolvedor auto-hospedado
Gateway
- Gateway auto-hospedado
- Cota por política de chave
- Configuração de criptografia
- Renegociação de certificado do cliente
- Certificado TLS gratuito gerenciado
- Solicitações para o gateway por localhost
Limites de recursos
Os limites de recursos a seguir se aplicam às camadas v2.
Para solicitar um aumento de limite, crie uma solicitação de suporte no portal do Azure. Para obter mais informações, consulte Planos de suporte do Azure.
| Recurso | Basic v2 | Standard v2 | Premium v2 |
|---|---|---|---|
| Número máximo de unidades de escala | 10 | 10 | 30 |
| Tamanho máximo de cache por instância de serviço | 250 MB | 1 GB | 5 GB |
| Número máximo de APIs por instância de serviço | 150 | 500 | 2\.500 |
| Número máximo de operações de API por instância de serviço | 3.000 | 10,000 | 20,000 |
| Número máximo de assinaturas por instância de serviço | 500 | 2\.000 | 4.000 |
| Número máximo de produtos por instância de serviço | 50 | 200 | 400 |
| Número máximo de usuários por instância de serviço | 300 | 2\.000 | 4.000 |
| Número máximo de grupos por instância de serviço | 20 | 100 | 200 |
| Número máximo de servidores de autorização por instância de serviço | 10 | 500 | 500 |
| Número máximo de fragmentos de política por instância de serviço | 50 | 50 | 100 |
| Número máximo de provedores do OpenID Connect por instância de serviço | 10 | 10 | 20 |
| Número máximo de certificados por instância de serviço | 100 | 100 | 100 |
| Número máximo de back-ends por instância de serviço | 100 | 100 | 100 |
| Número máximo de caches por instância de serviço | 100 | 100 | 100 |
| Número máximo de valores nomeados por instância de serviço | 100 | 100 | 100 |
| Número máximo de agentes por instância de serviço | 100 | 100 | 100 |
| Número máximo de esquemas por instância de serviço | 100 | 100 | 100 |
| Número máximo de esquemas por API | 100 | 100 | 100 |
| Número máximo de marcas por instância de serviço | 100 | 100 | 100 |
| Número máximo de marcas por API | 100 | 100 | 100 |
| Número máximo de conjuntos de versão por instância de serviço | 100 | 100 | 100 |
| Número máximo de versões por API | 100 | 100 | 100 |
| Número máximo de operações por API | 100 | 100 | 100 |
| Número máximo de resolvedores do GraphQL por instância de serviço | 100 | 100 | 100 |
| Número máximo de resolvedores do GraphQL por API | 100 | 100 | 100 |
| Número máximo de APIs por produto | 100 | 100 | 100 |
| Número máximo de APIs por assinatura | 100 | 100 | 100 |
| Número máximo de produtos por assinatura | 100 | 100 | 100 |
| Número máximo de grupos por produto | 100 | 100 | 100 |
| Número máximo de marcas por produto | 100 | 100 | 100 |
| Conexões de back-end simultâneas1 por autoridade HTTP | 2\.048 | 2\.048 | 2\.048 |
| Tamanho máximo de resposta em cache | 2 MiB | 2 MiB | 2 MiB |
| Tamanho máximo do documento da política | 256 KiB | 256 KiB | 256 KiB |
| Tamanho máximo da solicitação de payload | 1 GiB | 1 GiB | 1 GiB |
| Tamanho máximo de carga em buffer | 2 MiB | 2 MiB | 2 MiB |
| Tamanho máximo do conteúdo de solicitação/resposta nos logs de diagnóstico | 8.192 bytes | 8.192 bytes | 8.192 bytes |
| Tamanho máximo da URL da solicitação2 | 16.384 bytes | 16.384 bytes | 16.384 bytes |
| Comprimento máximo do segmento de caminho de URL | 1\.024 caracteres | 1\.024 caracteres | 1\.024 caracteres |
| Comprimento máximo do caractere de valor nomeado | 4.096 caracteres | 4.096 caracteres | 4.096 caracteres |
| Tamanho máximo do corpo da solicitação ou da resposta na política de validação de conteúdo | 100 KiB | 100 KiB | 100 KiB |
| Tamanho máximo do esquema de API usado pela política de validação | 4 MB | 4 MB | 4 MB |
| Número máximo de conexões WebSocket ativas por unidade3 | 5\.000 | 5\.000 | 5\.000 |
1 As conexões são agrupadas e reutilizados, a menos que sejam explicitamente fechadas pelo back-end.
2 Inclui uma cadeia de consulta longa de até 2048 bytes.
3 Até um máximo de 60 mil conexões por instância de serviço.
Limites do portal do Desenvolvedor
Os limites a seguir se aplicam ao portal do desenvolvedor nas camadas v2.
| Item | Basic v2 | Standard v2 | Premium v2 |
|---|---|---|---|
| Número máximo de arquivos de mídia a serem carregados | 15 | 15 | 15 |
| Tamanho máximo de um arquivo de mídia | 500 KB | 500 KB | 500 KB |
| Número máximo de páginas | 30 | 50 | 50 |
| Número máximo de widgets1 | 30 | 50 | 50 |
| Tamanho máximo de metadados por página | 350 KB | 350 KB | 350 KB |
| Tamanho máximo de metadados por widget1 | 350 KB | 350 KB | 350 KB |
| Número máximo de solicitações de cliente por minuto | 200 | 200 | 200 |
1 Limite para widgets internos, como texto, imagens ou lista de APIs. Atualmente, widgets personalizados e widgets de código HTML personalizados não têm suporte nas camadas v2.
Implantação
Implante uma instância de camada v2 usando o portal do Azure ou usando ferramentas como a API REST do Azure, o Azure Resource Manager, o modelo Bicep ou o Terraform.
Perguntas frequentes
P: Posso migrar da minha instância de Gerenciamento de API existente para uma nova instância da camada v2?
R: Não. Atualmente, você não pode migrar uma instância de Gerenciamento de API existente (na camada Consumo, Desenvolvedor, Básico, Standard ou Premium) para uma nova instância da camada v2. Atualmente, as camadas v2 estão disponíveis apenas para instâncias de serviço recém-criadas.
P: Qual é a relação entre a plataforma de computação stv2 e as camadas v2?
R: Eles não são relacionados. o stv2 é uma versão da plataforma de computação das instâncias de serviço da camada Desenvolvedor, Básico, Standard e Premium. stv2 é um sucessor da plataforma de computação stv1 que se aposentou em 2024.
P: Ainda vou poder provisionar serviços de camada Desenvolvedor, Básico, Standard ou Premium?
R: Sim, não há alterações nas camadas Clássicas de Desenvolvedor, Básico, Standard ou Premium.
P: Qual é a diferença entre a integração de rede virtual na camada Standard v2 e a injeção de rede virtual nas camadas Premium e Premium v2?
R: Uma instância de serviço Standard v2 pode ser integrada a uma rede virtual para fornecer acesso seguro aos back-ends que residem lá. Uma instância de serviço Standard v2 integrada a uma rede virtual tem um endereço IP público para acesso de entrada.
A camada Premium e a camada Premium v2 dão suporte ao isolamento de rede completo por implantação (injeção) em uma rede virtual sem expor um endereço IP público. Saiba mais sobre as opções de rede no Gerenciamento de API.
P: Posso implantar uma instância da camada Básico v2 ou Standard v2 inteiramente na minha rede virtual?
R: Não, essa implantação só tem suporte nas camadas Premium e Premium v2.
Conteúdo relacionado
- Compare as camadas de Gerenciamento de API.
- Saiba mais sobre os gateways de Gerenciamento de API
- Saiba mais sobre os preços do Gerenciamento de API.