Compartilhar via


Camadas do Gerenciamento de API do Azure v2

APLICA-SE A: Básico v2 | Standard v2

Estamos introduzindo um novo conjunto de SKUs (tipos de preço) para o Gerenciamento de API do Azure: as camadas v2. As novas camadas 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. Saiba mais.

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.

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.

  • Rede simplificada – a camada Standard v2 dá suporte a conexões de saída para back-ends isolados de rede.

  • Mais opções para cargas de trabalho de produção – todas as camadas v2 têm suporte com um SLA. Atualize do Basic v2 para o Standard v2 para adicionar mais opções de produção.

  • Opções do portal do desenvolvedor – habilite o portal do desenvolvedor quando estiver pronto para permitir que os consumidores de API descubram suas APIs.

Opções de rede

A camada Standard v2 dá suporte à integração VNet para permitir que sua instância de Gerenciamento de API alcance back-ends de API isolados em uma única VNet conectada. O gateway de Gerenciamento de API, o plano de gerenciamento e o portal do desenvolvedor permanecem publicamente acessíveis pela Internet. A VNet deve estar na mesma região que a instância de Gerenciamento de API. Saiba mais.

Recursos

Versão da API

As camadas v2 têm suporte na API de Gerenciamento de API versão 2023-05-01-preview ou posterior.

Regiões com suporte

As camadas v2 estão disponíveis nas seguintes regiões:

  • Leste dos EUA
  • Leste dos EUA 2
  • Centro-Sul dos Estados Unidos
  • Centro-Norte dos EUA
  • Oeste dos EUA
  • Oeste dos EUA 2
  • França Central
  • Centro-Oeste da Alemanha
  • Norte da Europa
  • Leste da Noruega
  • Europa Ocidental
  • Norte da Suíça
  • Sul do Reino Unido
  • Oeste do Reino Unido
  • Norte da África do Sul
  • Índia Central
  • Sul da Índia
  • Brazil South
  • Austrália Central
  • Leste da Austrália
  • Australia Southeast
  • Leste da Ásia
  • Leste do Japão
  • Sudeste Asiático
  • Coreia Central

Disponibilidade de recursos

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
  • Análise interna (substituída pelo painel baseado no Azure Monitor)

Limitações

Os seguintes recursos de Gerenciamento de API estão atualmente indisponíveis nas camadas v2.

Infraestrutura e rede

  • Redundância de zona
  • Implantação em várias regiões
  • Vários nomes de domínio personalizado
  • Métrica de capacidade – substituída pelo Percentual de CPU de Gateway e Percentual de Memória das métricas do Gateway
  • Dimensionamento automático
  • Conexão de entrada usando um ponto de extremidade privado
  • Injeção em uma VNet no modo externo ou no modo interno
  • Atualizar para camadas v2 de camadas v1
  • Workspaces
  • Certificados de Autoridade de Certificação

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
Número máximo de unidades de escala 10 10
Tamanho máximo de cache por instância de serviço 250 MB 1 GB
Número máximo de APIs por instância de serviço 150 500
Número máximo de operações de API por instância de serviço 3.000 10.000
Número máximo de assinaturas por instância de serviço 500 2.000
Número máximo de produtos por instância de serviço 50 200
Número máximo de usuários por instância de serviço 300 2.000
Número máximo de grupos por instância de serviço 20 100
Número máximo de servidores de autorização por instância de serviço 10 500
Número máximo de fragmentos de política por instância de serviço 50 50
Número máximo de provedores do OpenID Connect por instância de serviço 10 10
Número máximo de certificados por instância de serviço 100 100
Número máximo de back-ends por instância de serviço 100 100
Número máximo de caches por instância de serviço 100 100
Número máximo de valores nomeados por instância de serviço 100 100
Número máximo de agentes por instância de serviço 100 100
Número máximo de esquemas por instância de serviço 100 100
Número máximo de esquemas por API 100 100
Número máximo de marcas por instância de serviço 100 100
Número máximo de marcas por API 100 100
Número máximo de conjuntos de versão por instância de serviço 100 100
Número máximo de versões por API 100 100
Número máximo de operações por API 100 100
Número máximo de resolvedores do GraphQL por instância de serviço 100 100
Número máximo de resolvedores do GraphQL por API 100 100
Número máximo de APIs por produto 100 100
Número máximo de APIs por assinatura 100 100
Número máximo de produtos por assinatura 100 100
Número máximo de grupos por produto 100 100
Número máximo de marcas por produto 100 100
Conexões de back-end simultâneas1 por autoridade HTTP 2\.048 2\.048
Tamanho máximo de resposta em cache 2 MiB 2 MiB
Tamanho máximo do documento da política 256 KiB 256 KiB
Tamanho máximo da solicitação de payload 1 GiB 1 GiB
Tamanho máximo de carga em buffer 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
Tamanho máximo da URL da solicitação2 16.384 bytes 16.384 bytes
Comprimento máximo do segmento de caminho de URL 1\.024 caracteres 1\.024 caracteres
Comprimento máximo do caractere de valor nomeado 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
Tamanho máximo do esquema de API usado pela política de validação 4 MB 4 MB
Número máximo de conexões WebSocket ativas por unidade3 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
Número máximo de arquivos de mídia a serem carregados 15 15
Tamanho máximo de um arquivo de mídia 500 KB 500 KB
Número máximo de páginas 30 50
Número máximo de widgets1 30 50
Tamanho máximo de metadados por página 350 KB 350 KB
Tamanho máximo de metadados por widget1 350 KB 350 KB
Número máximo de solicitações de cliente por minuto 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 da camada Básica v2 ou Standard v2 usando o portal do Azure, a API REST do Azure ou o Azure Resource Manager ou o modelo Bicep.

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 stv1 programada para a aposentadoria em 2024.

P: Ainda será possível provisionar serviços de camada Básico ou Standard?

R: Sim, não há alterações nas camadas Básico ou Standard.

P: Qual é a diferença entre a integração de VNet na camada Standard v2 e o suporte à VNet na camada Premium?

R: Uma instância de serviço Standard v2 pode ser integrada a uma VNet para fornecer acesso seguro aos back-ends que residem lá. Uma instância de serviço Standard v2 integrada a uma VNet terá um endereço IP público. A camada Premium dá suporte a uma integração totalmente privada com uma VNet (geralmente conhecida como injeção na VNet) sem expor um endereço IP público.

P: Posso implantar uma instância da camada Básico V2 ou Standard v2 inteiramente na minha VNet?

R: Não, essa implantação só tem suporte na camada Premium.

P: Uma camada Premium v2 está nos planos?

R: Sim, uma versão prévia da Premium v2 está nos planos e será anunciada separadamente.