Livelli di Gestione API di Azure v2
SI APPLICA A: Basic v2 | Standard v2 | Premium v2
I livelli Gestione API v2 (SKU) sono basati su una piattaforma nuova, più affidabile e scalabile e sono progettate per rendere Gestione API accessibile a un set più ampio di clienti e offrire opzioni flessibili per un'ampia gamma di scenari. I livelli v2 si aggiungono ai livelli classici esistenti (Developer, Basic, Standard e Premium) e al livello A consumo. Vedere il confronto dettagliato dei livelli Gestione API.
I livelli v2 seguenti sono disponibili a livello generale:
Basic v2: il livello Basic v2 è progettato per scenari di sviluppo e test ed è supportato con un contratto di servizio.
standard v2: Standard v2 è un livello pronto per la produzione con supporto per i back-end con isolamento della rete.
Il livello v2 seguente è disponibile in anteprima:
Premium v2 - Premium v2 offre funzionalità aziendali, tra cui l'isolamento completo della rete virtuale e la scalabilità per carichi di lavoro con volumi elevati.
Nota
Il livello Premium v2 è attualmente in anteprima limitata. Per iscriversi, compilare il modulo.
Funzionalità chiave
Distribuzione, configurazione e scalabilità più veloci: distribuire un'istanza di Gestione API pronta per la produzione in pochi minuti. Applicare rapidamente configurazioni, ad esempio gli aggiornamenti del certificato e del nome host. Ridimensionare rapidamente un'istanza Basic v2 o Standard v2 fino a 10 unità per soddisfare le esigenze dei carichi di lavoro di Gestione API. Ridimensionare un'istanza Premium v2 fino a 30 unità.
Rete semplificata: i livelli Standard v2 e Premium v2 offrono opzioni di rete per isolare il traffico in ingresso e in uscita di Gestione API.
Altre opzioni per i carichi di lavoro di produzione: i livelli v2 sono tutti supportati con un contratto di servizio.
Opzioni del portale per sviluppatori: abilitare il portale per sviluppatori quando si è pronti per consentire agli utenti delle API di individuare le API.
Funzionalità
Versione dell'API
Le funzionalità più recenti dei livelli v2 sono supportate in Gestione API API versione 2024-05-01 o successiva.
Opzioni di rete
Standard v2 e Premium v2 supportano l'integrazione della rete virtuale per consentire all'istanza di Gestione API di raggiungere i back-end API isolati in una singola rete virtuale connessa. Il gateway di Gestione API, il piano di gestione e il portale per sviluppatori rimangono accessibili pubblicamente da Internet. La rete virtuale deve trovarsi nella stessa area e nella stessa sottoscrizione dell'istanza di Gestione API. Altre informazioni.
Premium v2 supporta anche l'inserimento semplificato della rete virtuale per l'isolamento completo del traffico gateway in ingresso e in uscita senza richiedere regole del gruppo di sicurezza di rete, tabelle di route o endpoint di servizio. La rete virtuale deve trovarsi nella stessa area e nella stessa sottoscrizione dell'istanza di Gestione API. Altre informazioni.
Aree geografiche supportate
Per un elenco corrente delle aree in cui sono disponibili i livelli v2, vedere Disponibilità dei livelli v2 e dei gateway dell'area di lavoro.
Disponibilità delle funzionalità classiche
La maggior parte delle funzionalità dei livelli classici di Gestione API è supportata nei livelli v2. Tuttavia, le funzionalità seguenti non sono supportate nei livelli v2:
- Configurazione del servizio API Management con Git
- Backup e ripristino dell'istanza di API Management
- Abilitazione della protezione DDoS di Azure
- Accesso all'API Direct Management
Limiti
Le funzionalità di Gestione API seguenti non sono attualmente disponibili nei livelli v2.
Infrastruttura e rete
- Distribuzione in più aree
- Più nomi di dominio personalizzati
- Metrica della capacità: sostituita dalla percentuale cpu del gateway e dalla percentuale di memoria delle metriche del gateway
- Analisi predefinita: sostituita dal dashboard basato su Monitoraggio di Azure
- Scalabilità automatica
- Connessione in ingresso tramite un endpoint privato
- Eseguire l'aggiornamento ai livelli v2 dai livelli classici
- Certificati CA
Portale per sviluppatori
- Report
- Widget di codice HTML personalizzato e widget personalizzato
- Portale per sviluppatori self-hosted
Gateway
- Gateway self-hosted
- Criterio quota per chiave
- Configurazione della crittografia
- Rinegoziazione del certificato client
- Certificato TLS gratuito e gestito
- Richieste al gateway tramite localhost
Limiti delle risorse
Ai livelli v2 si applicano i limiti delle risorse seguenti.
Per richiedere un aumento del limite, creare una richiesta di supporto dal portale di Azure. Per altre informazioni, vedere Piani di supporto per Azure.
| Conto risorse | Basic v2 | Standard v2 | Premium v2 |
|---|---|---|---|
| Numero massimo di unità di scala | 10 | 10 | 30 |
| Dimensioni massime della cache per istanza del servizio | 250 MB | 1 GB | 5 GB |
| Numero massimo di API per istanza del servizio | 150 | 500 | 2500 |
| Numero massimo di operazioni API per istanza del servizio | 3,000 | 10,000 | 20.000 |
| Numero massimo di sottoscrizioni per istanza del servizio | 500 | 2.000 | 4.000 |
| Numero massimo di prodotti per istanza del servizio | 50 | 200 | 400 |
| Numero massimo di API per istanza del servizio | 300 | 2.000 | 4.000 |
| Numero massimo di gruppi per istanza del servizio | 20 | 100 | 200 |
| Numero massimo di server di autorizzazione per istanza del servizio | 10 | 500 | 500 |
| Numero massimo di frammenti di criteri per istanza del servizio | 50 | 50 | 100 |
| Numero massimo di provider OpenID Connect per istanza del servizio | 10 | 10 | 20 |
| Numero massimo di certificati CA per istanza del servizio | 100 | 100 | 100 |
| Numero massimo di back-end per istanza del servizio | 100 | 100 | 100 |
| Numero massimo di cache per istanza del servizio | 100 | 100 | 100 |
| Numero massimo di valori denominati per istanza del servizio | 100 | 100 | 100 |
| Numero massimo di logger per istanza del servizio | 100 | 100 | 100 |
| Numero massimo di schemi per istanza del servizio | 100 | 100 | 100 |
| Numero massimo di schemi per API | 100 | 100 | 100 |
| Numero massimo di tag per istanza del servizio | 100 | 100 | 100 |
| Numero massimo di tag per API | 100 | 100 | 100 |
| Numero massimo di set di versioni per istanza del servizio | 100 | 100 | 100 |
| Numero massimo di versioni per API | 100 | 100 | 100 |
| Numero massimo di operazioni per API | 100 | 100 | 100 |
| Numero massimo di resolver GraphQL per istanza del servizio | 100 | 100 | 100 |
| Numero massimo di resolver GraphQL per API | 100 | 100 | 100 |
| Numero massimo di API per prodotto | 100 | 100 | 100 |
| Numero massimo di API per sottoscrizione | 100 | 100 | 100 |
| Numero massimo di prodotti per sottoscrizione | 100 | 100 | 100 |
| Numero massimo di gruppi per prodotto | 100 | 100 | 100 |
| Numero massimo di tag per prodotto | 100 | 100 | 100 |
| Connessioni back-end simultanee1 per autorità HTTP | 2.048 | 2.048 | 2.048 |
| Dimensione massima della risposta memorizzata nella cache | 2 MiB | 2 MiB | 2 MiB |
| Dimensioni massime del documento dei criteri | 256 KiB | 256 KiB | 256 KiB |
| Dimensioni massime del payload della richiesta | 1 GiB | 1 GiB | 1 GiB |
| Dimensioni massime del payload memorizzato nel buffer | 2 MiB | 2 MiB | 2 MiB |
| Dimensioni massime del payload di richiesta/risposta nei log di diagnostica | 8.192 byte | 8.192 byte | 8.192 byte |
| Dimensioni massime dell'URL delle richieste2 | 16.384 byte | 16.384 byte | 16.384 byte |
| Lunghezza massima del segmento di percorso URL | 1.024 caratteri | 1.024 caratteri | 1.024 caratteri |
| Lunghezza in caratteri massima del valore denominato | 4.096 caratteri | 4.096 caratteri | 4.096 caratteri |
| Dimensioni massime del corpo della richiesta o della risposta nei criteri validate-content | 100 KiB | 100 KiB | 100 KiB |
| Dimensioni massime dello schema API usato dai criteri di convalida | 4 MB | 4 MB | 4 MB |
| Numero massimo di connessioni WebSocket attive per unità3 | 5,000 | 5,000 | 5,000 |
1Le connessioni vengono raggruppate in pool e riutilizzate, a meno che non vengano chiuse esplicitamente dal back-end.
2 Include fino a 2048 byte di lunghezza per la stringa di query.
3 Fino a un massimo di 60.000 connessioni per ogni istanza del servizio.
Limiti del portale per sviluppatori
Al portale per sviluppatori si applicano i limiti seguenti nei livelli v2.
| Articolo | Basic v2 | Standard v2 | Premium v2 |
|---|---|---|---|
| Numero massimo di file multimediali da caricare | 15 | 15 | 15 |
| Dimensioni massime di un file multimediale | 500 KB | 500 KB | 500 KB |
| Numero massimo di pagine | 30 | 50 | 50 |
| Numero massimo di widget1 | 30 | 50 | 50 |
| Dimensioni massime dei metadati per pagina | 350 KB | 350 KB | 350 KB |
| Dimensioni massime dei metadati per widget1 | 350 KB | 350 KB | 350 KB |
| Numero massimo di richieste client al minuto | 200 | 200 | 200 |
1 Limite per i widget predefiniti, ad esempio testo, immagini o elenco di API. Attualmente, i widget personalizzati e i widget di codice HTML personalizzati non sono supportati nei livelli v2.
Distribuzione
Distribuire un'istanza di livello v2 usando il portale di Azure o usando strumenti come l'API REST di Azure, Azure Resource Manager, il modello Bicep o Terraform.
Domande frequenti
D: È possibile eseguire la migrazione dall'istanza di Gestione API esistente a una nuova istanza del livello v2?
R: No. Attualmente non è possibile eseguire la migrazione di un'istanza di Gestione API esistente (nel livello Consumption, Developer, Basic, Standard o Premium) a una nuova istanza del livello v2. Attualmente i livelli v2 sono disponibili solo per le istanze del servizio appena create.
D: Qual è la relazione tra la piattaforma di calcolo stv2 e i livelli v2?
R: Non sono correlati. stv2 è una versione della piattaforma di calcolo delle istanze del servizio di livello Developer, Basic, Standard e Premium. stv2 è un successore della piattaforma di calcolo stv1 ritirata nel 2024.
D: Sarà comunque possibile effettuare il provisioning dei servizi di livello Developer, Basic, Standard o Premium?
R: Sì, non sono state apportate modifiche ai livelli classico Developer, Basic, Standard o Premium.
D: Qual è la differenza tra l'integrazione della rete virtuale nel livello Standard v2 e l'inserimento della rete virtuale nei livelli Premium e Premium v2?
R: Un'istanza del servizio Standard v2 può essere integrata con una rete virtuale per fornire l'accesso sicuro ai back-end presenti. Un'istanza del servizio Standard v2 integrata con una rete virtuale ha un indirizzo IP pubblico per l'accesso in ingresso.
Il livello Premium e Il livello Premium v2 supportano l'isolamento completo della rete tramite distribuzione (inserimento) in una rete virtuale senza esporre un indirizzo IP pubblico. Altre informazioni sulle opzioni di rete in Gestione API.
D: È possibile distribuire un'istanza del livello Basic v2 o Standard v2 interamente nella rete virtuale?
R: No, tale distribuzione è supportata solo nei livelli Premium e Premium v2.
Contenuto correlato
- Confrontare i livelli di Gestione API.
- Altre informazioni sui Gateway di Gestione API
- Informazioni sui Prezzi di Gestione API.