Azure API Management v2 camadas
APLICA-SE A: Basic v2 | Padrão v2 | Premium v2
As camadas de Gerenciamento de API v2 (SKUs) são construídas em uma plataforma nova, mais confiável e escalável e são projetadas para tornar o Gerenciamento de API acessível a um conjunto mais amplo de clientes e oferecer opções flexíveis para uma maior variedade de cenários. As camadas v2 são adicionais às camadas clássicas existentes (Developer, Basic, Standard e Premium) e à camada Consumo. Consulte a comparação detalhada das camadas de Gerenciamento de API.
As seguintes camadas v2 estão geralmente disponíveis:
Basic v2 - A camada Basic v2 foi projetada para cenários de desenvolvimento e teste e é suportada por um SLA.
Padrão v2 - O padrão v2 é uma camada pronta para produção com suporte para back-ends isolados de rede.
A seguinte camada v2 está em visualização:
Premium v2 - O Premium v2 oferece recursos corporativos, incluindo isolamento de rede virtual completo e dimensionamento para cargas de trabalho de alto volume.
Nota
O nível Premium v2 está atualmente em pré-visualização limitada. Para se inscrever, preencha este formulário.
Capacidades chave
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 de host. Dimensione uma instância Basic v2 ou Standard v2 rapidamente 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 - As camadas v2 são todas suportadas 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.
Funcionalidades
Versão da API
Os recursos mais recentes das camadas v2 são suportados na API de Gerenciamento de API versão 2024-05-01 ou posterior.
Opções de redes
O Standard v2 e o Premium v2 oferecem 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 acessíveis publicamente a partir da Internet. A rede virtual deve estar na mesma região e assinatura que a instância de Gerenciamento de API. Mais informações.
Na visualização, o Standard v2 também oferece suporte a conexões de ponto de extremidade privado de entrada para o gateway de Gerenciamento de API.
O Premium v2 também suporta injeção de rede virtual simplificada para isolamento completo do tráfego de gateway de entrada e saída sem exigir 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 que a instância de Gerenciamento de API. Mais informações.
Regiões suportadas
Para obter uma lista atual de regiões onde as camadas v2 estão disponíveis, consulte Disponibilidade de camadas v2 e gateways de espaço de trabalho.
Disponibilidade de recursos clássicos
A maioria dos recursos das camadas clássicas de Gerenciamento de API é suportada nas camadas v2. No entanto, as seguintes capacidades não são suportadas pelos escalões v2:
- Configuração do serviço API Management utilizando o Git
- Cópia de segurança e restauro de instâncias do API Management
- Ativar o Azure DDoS Protection
- Acesso direto à API de gerenciamento
Limitações
Os seguintes recursos de Gerenciamento de API não estão disponíveis atualmente nas camadas v2.
Infraestruturas e redes
- Implementação em várias regiões
- Suporte à zona de disponibilidade
- Vários nomes de domínio personalizados
- Métrica de capacidade - substituída por Porcentagem de CPU de Gateway e Porcentagem de memória de métricas de Gateway
- Análise interna - substituída pelo painel baseado no Azure Monitor
- Dimensionamento automático
- Atualize para as camadas v2 a partir das camadas clássicas
- Certificados de CA
- Enviar eventos para a Grelha de Eventos
Portal do programador
- Relatórios
- Widget de código HTML personalizado e widget personalizado
- Portal do desenvolvedor auto-hospedado
Gateway
- Gateway autoalojado
- Quota por política-chave
- Configuração de cifra
- Renegociação de certificados de cliente
- Certificado TLS gerenciado e gratuito
- Solicitações para o gateway através de localhost
Limites de recursos
Os seguintes limites de recursos aplicam-se às camadas v2.
Para solicitar um aumento de limite, crie uma solicitação de suporte no portal do Azure. Para obter mais informações, veja Planos de suporte do Azure.
| Recurso | Básico v2 | Padrão 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 | 2500 |
| 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 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 registradores 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 tags por instância de serviço | 100 | 100 | 100 |
| Número máximo de tags por API | 100 | 100 | 100 |
| Número máximo de conjuntos de versões 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 GraphQL por instância de serviço | 100 | 100 | 100 |
| Número máximo de resolvedores 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 subscrição | 100 | 100 | 100 |
| Número máximo de grupos por produto | 100 | 100 | 100 |
| Número máximo de etiquetas por produto | 100 | 100 | 100 |
| Conexõesback-end simultâneas 1 por autoridade HTTP | 2048 | 2048 | 2048 |
| Tamanho máximo da resposta em cache | 2 MiB | 2 MiB | 2 MiB |
| Tamanho máximo do documento de política | 256 KiB | 256 KiB | 256 KiB |
| Tamanho máximo da carga útil solicitada | 1 GiB | 1 GiB | 1 GiB |
| Tamanho máximo da carga útil em buffer | 2 MiB | 2 MiB | 2 MiB |
| Tamanho máximo da carga útil de solicitação/resposta em logs de diagnóstico | 8.192 bytes | 8.192 bytes | 8.192 bytes |
| Tamanho máximo do URLde solicitação 2 | 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 de caracteres do valor nomeado | 4.096 caracteres | 4.096 caracteres | 4.096 caracteres |
| Tamanho máximo do corpo da solicitação ou resposta na política de conteúdo validado | 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 reutilizadas, a menos que sejam explicitamente fechadas pelo back-end.
2 Inclui uma cadeia de caracteres de consulta de até 2048 bytes de comprimento.
3 Até um máximo de 60.000 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 | Básico v2 | Padrão v2 | Premium v2 |
|---|---|---|---|
| Número máximo de ficheiros multimédia a carregar | 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 dos metadados por página | 350 KB | 350 KB | 350 KB |
| Tamanho máximo dos metadados por widget1 | 350 KB | 350 KB | 350 KB |
| Número máximo de pedidos de clientes por minuto | 200 | 200 | 200 |
1 Limite para widgets integrados, como texto, imagens ou lista de APIs. Atualmente, widgets personalizados e widgets de código HTML personalizados não são suportados nas camadas v2.
Implementação
Implante uma instância de camada v2 usando o portal do Azure ou usando ferramentas como a API REST do Azure, o Gerenciador de Recursos do Azure, o modelo Bicep ou o Terraform.
Perguntas mais frequentes
P: Posso migrar da minha instância de Gerenciamento de API existente para uma nova instância de camada v2?
R: Não. Atualmente, não é possível migrar uma instância de Gerenciamento de API existente (na camada Consumo, Desenvolvedor, Básico, Standard ou Premium) para uma nova instância de 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 estão relacionados. stv2 é uma versão de plataforma de computação das instâncias de serviço de camada Developer, Basic, Standard e Premium. STV2 é um sucessor da plataforma de computação STV1 que se aposentou em 2024.
P: Ainda poderei provisionar serviços de nível Developer, Basic, Standard ou Premium?
R: Sim, não há alterações nas camadas clássicas Developer, Basic, 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 com uma rede virtual tem um endereço IP público para acesso de entrada.
A camada Premium e a camada Premium v2 suportam isolamento total de rede 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 Basic v2 ou Standard v2 inteiramente na minha rede virtual?
R: Não, essa implementação só é suportada nos níveis Premium e Premium v2.
Conteúdos relacionados
- 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.