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.
In anteprima, Standard v2 supporta anche le connessioni endpoint private in ingresso al gateway Gestione API.
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
- Supporto della zona di disponibilità
- 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
- Eseguire l'aggiornamento ai livelli v2 dai livelli classici
- Certificati CA
- Invio di eventi a Griglia di eventi
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.