Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Quote per la configurazione e l’esecuzione di una REST API in Gateway API
Le quote seguenti si applicano alla configurazione e all'esecuzione di un'API REST in Amazon API Gateway. Se la quota è relativa a un’API specifica, può essere aumentata solo per determinate API e non per tutte le API di un account.
Per informazioni sulle quote a livello di account, consultare Quote Gateway Amazon API.
| Operazione o risorsa | Quota predefinita | Può essere aumentata |
|---|---|---|
| Nomi di dominio personalizzati pubblici per account per Regione | 120 | Sì |
| Nomi di dominio personalizzati privati per account per Regione | 50 | Sì |
| API regionali per Regione | 600 | No |
| API ottimizzate per l’edge per Regione | 120 | No |
| API private per account per regione | 600 | No |
| Associazioni di accesso di nomi di dominio per account | 100 | Sì |
| Mappature API multilivello per dominio | 200 | No |
| Regole di routing per dominio | 50 | Sì |
| Lunghezza, in caratteri, dell'URL per un'API ottimizzata per gli edge | 8192 | No |
| Lunghezza, in caratteri, dell'URL per un'API regionale | 10240 | No |
| Lunghezza massima, in caratteri, di una policy delle risorse API Gateway | 8192 | Sì |
| Chiavi API per account in ogni regione | 10000 | No |
| Certificati client per account in ogni regione | 60 | Sì |
| Autorizzatori per API (AWS Lambda e Amazon Cognito) | 10 |
Sì Per aumentare questa quota, contattare il Centro Supporto AWS |
| Parti documentazione per API | 2000 |
Sì Per aumentare questa quota, contattare il Centro Supporto AWS |
| Risorse per API | 300 | Sì |
| Fasi per API | 10 | Sì |
| Variabili di fase per ogni fase | 100 | No |
| Lunghezza, in caratteri, della chiave in una variabile di fase | 64 | No |
| Lunghezza, in caratteri, del valore in una variabile di fase | 512 | No |
| Piani di utilizzo per account in ogni regione | 300 | Sì |
| Piani di utilizzo per chiave API | 10 | Sì |
| Link VPC per account in ogni regione | 20 | Sì |
| TTL caching API | 300 secondi per impostazione predefinita e configurabile tra 0 e 3600 da un proprietario di API. | Non per il limite superiore (3600) |
| Dimensione della risposta memorizzata nella cache | 1048576 byte. la crittografia dei dati della cache può aumentare le dimensioni della voce quando viene memorizzata nella cache. | No |
| Timeout di integrazione per API regionali | 50 millisecondi - 29 secondi per tutti i tipi di integrazione, inclusi Lambda, proxy Lambda, HTTP, proxy HTTP e integrazioni AWS. | Sì * |
| Timeout di integrazione per API ottimizzate per l’edge | 50 millisecondi - 29 secondi per tutti i tipi di integrazione, inclusi Lambda, proxy Lambda, HTTP, proxy HTTP e integrazioni AWS. | No |
| Timeout di integrazione per API private | 50 millisecondi - 29 secondi per tutti i tipi di integrazione, inclusi Lambda, proxy Lambda, HTTP, proxy HTTP e integrazioni AWS. | Sì * |
| Dimensione totale combinata di tutti i valori di intestazione, inclusi nomi di intestazione, valori, eventuali terminatori di riga e spazi bianchi | 10240 byte | No |
| Totale dimensioni combinate di tutti i valori dell'intestazione per un’API privaa | 8000 byte | No |
| Dimensione payload | 10 MB | No |
| Tag per fase | 50 | No |
Numero di iterazioni in un loop #foreach ... #end nei modelli di mappatura |
1000 | No |
| Dimensione massima del modello di mappatura | 300 KB | No |
| Dimensione del modello di log di accesso | 3 KB | No |
| Lunghezza dell’ARN del metodo | 1600 byte. Se il metodo contiene un parametro di percorso e un client utilizza un valore che supera la lunghezza dell’ARN, l’API restituirà una risposta 414 Request URI too long. |
No |
| Impostazioni di limitazione a livello di metodo per una fase in un piano di utilizzo | 20 |
Sì Per aumentare questa quota, contattare il Centro Supporto AWS |
| Dimensione dei modelli per API | 400 KB | No |
| Numero di certificati per truststore | 1.000 certificati con dimensioni totali dell'oggetto fino a 1 MB. | No |
| Timeout per connessione inattiva | 310 secondi | No |
| Dimensione massima del file di definizione dell’API quando si utilizza restapi:import o restapi:put | 6 MB | No |
* Non è possibile impostare il timeout di integrazione su meno di 50 millisecondi. È possibile aumentare il timeout di integrazione a più di 29 secondi, ma potrebbe essere richiesta una riduzione della quota della limitazione (della larghezza di banda della rete) a livello regionale per l’account.
Best practice per ridurre le quote
Le seguenti best practice consentono di ridurre il numero attuale di risorse per evitare di aumentare la quota. È necessario assicurarsi che questi suggerimenti funzionino per l’architettura delle API in uso.
- API per regione
-
Per ridurre il numero di API per Regione, esportare le API inutilizzate e quindi eliminarle da Gateway API. Per ulteriori informazioni, consulta Esportazione di un'API REST da API Gateway.
- Fasi per API
-
Per ridurre il numero di fasi per API, suddividere l’API in più API.
- Risorse per API
-
Utilizza i percorsi
{proxy+}per ridurre il numero di risorse. Per ulteriori informazioni, consulta Configurazione di un'integrazione proxy mediante una risorsa proxy. - Mappature API
-
Per ridurre il numero di mappature API per un nome di dominio personalizzato, utilizzare mappature API con livelli singoli, ad esempio
/prod. Le mappature API con un singolo livello non vengono conteggiate ai fini della quota delle mappature API. - Autorizzatori per API
Per ridurre il numero di sistemi di autorizzazione per ogni API, riutilizzare i sistemi di autorizzazione nei metodi API.
- Parti documentazione per API
-
Per ridurre il numero di parti della documentazione per API, utilizzare
ignore=documentationquando si importa l’API. Per ulteriori informazioni, consulta Importare la documentazione dell'API.È anche possibile utilizzare l’ereditarietà dei contenuti per consentire ad alcune parti della documentazione di ereditare i contenuti da un’entità API con specifiche più generali. Per ulteriori informazioni, consulta Rappresentazione della documentazione dell'API in API Gateway.
- Lunghezza massima, in caratteri, di una policy delle risorse API Gateway
-
Per ridurre la lunghezza di una policy di risorsa, utilizzare AWS WAFV2 per proteggere l’API. Per ulteriori informazioni, consulta Utilizzo di AWS WAF per proteggere le REST API in Gateway API.
Se la policy contiene indirizzi IP, è anche possibile utilizzare intervalli anziché valori specifici per definire gli indirizzi IP.
- Piani di utilizzo per chiave API
-
Per ridurre il numero di piani di utilizzo per chiave API, utilizzare una chiave API per piano di utilizzo e associare il piano di utilizzo a più API. Non è consigliabile condividere una chiave API tra più piani di utilizzo.