Quote e note importanti Amazon API Gateway
Nella sezione seguente vengono fornite informazioni sulle quote per Gateway Amazon API. Salvo diversamente specificato, è possibile richiedere di aumentare le quote. Per richiedere un aumento delle quote, è possibile utilizzare Service Quotas o contattare il Centro assistenza AWS
Se l'autorizzazione è abilitata per un metodo, la lunghezza massima dell'ARN del metodo (ad esempio arn:aws:execute-api:{region-id}:{account-id}:{api-id}/{stage-id}/{method}/{resource}/{path}) è di 1600 byte. A causa dei valori dei parametri del percorso (la cui dimensione viene determinata al runtime), l'ARN può superare il limite di lunghezza impostato. In questo caso, il client API riceve una risposta 414 Request URI too long.
Nota
Ciò limita la lunghezza dell'URI quando vengono utilizzate le policy delle risorse. Nel caso di API private dove è necessaria una policy delle risorse, ciò limita la lunghezza dell'URI di tutte le API private.
Argomenti
- Quote a livello di account API Gateway per ogni regione
- Quote API HTTP
- Quote di API Gateway per la configurazione e l'esecuzione di un'API WebSocket
- Quote di API Gateway per la configurazione e l'esecuzione di un'API REST
- Quote di API Gateway per la creazione, la distribuzione e la gestione di un'API
- Note importanti Amazon API Gateway
Quote a livello di account API Gateway per ogni regione
Di seguito sono elencate le quote per account per ogni regione in Amazon API Gateway.
| Operazione o risorsa | Quota predefinita | Può essere aumentata |
|---|---|---|
| Quota di throttling per account, per regione tra API HTTP, API REST, API WebSocket API e API di callback WebSocket | 10.000 richieste al secondo (RPS) con un'ulteriore capacità di ottimizzazione fornita dall'algoritmo del bucket tokenNotaLa quota di incremento delle prestazioni dipende dal team di servizio API Gateway in base alla quota RPS complessiva per l'account nella regione. Non è una quota che un cliente può controllare o per la quale può richiedere modifiche. |
Sì |
| API regionali | 600 | No |
| API ottimizzate per edge | 120 | No |
* Nelle Regioni seguenti, la quota di limitazione (della larghezza di banda della rete) predefinita è di 2500 RPS e la quota di espansione predefinita è di 1250 RPS: Africa (Città del Capo), Europa (Milano), Asia Pacifico (Giacarta), Medio Oriente (Emirati Arabi Uniti), Asia Pacifico (Hyderabad), Asia Pacifico (Melbourne), Europa (Spagna), Europa (Zurigo), Israele (Tel Aviv), Canada occidentale (Calgary) e Asia Pacifico (Malesia).
Quote API HTTP
Le quote seguenti si applicano alla configurazione e all'esecuzione di un'API HTTP in API Gateway.
| Operazione o risorsa | Quota predefinita | Può essere aumentata |
|---|---|---|
| Instradamenti per API | 300 | Sì |
| Integrazioni per API | 300 | No |
| Timeout massimo dell'integrazione | 30 secondi | No |
| Fasi per API | 10 | Sì |
| Mappature API multilivello per dominio | 200 | No |
| Tag per fase | 50 | No |
| Dimensione totale combinata dei valori della riga di richiesta e dell'intestazione | 10240 byte | No |
| Dimensione payload | 10 MB | No |
| Domini personalizzati per account per regione | 120 | Sì |
| Dimensione del modello di log di accesso | 3 KB | No |
| Voce di log Amazon CloudWatch Logs | 1 MB | No |
| Autorizzatori per API | 10 | Sì |
| Destinatari per autorizzatore | 50 | No |
| Ambiti per percorso | 10 | No |
| Timeout per l'endpoint del set di chiavi Web JSON | 1500 ms | No |
| Dimensione della risposta dall'endpoint del set di chiavi Web JSON | 150000 byte | No |
| Timeout per l'endpoint di individuazione OpenID Connect | 1500 ms | No |
| Timeout per la risposta della funzione Lambda di autorizzazione | 10000 ms | No |
| Link VPC per account in ogni regione | 10 | Sì |
| Sottoreti per collegamento VPC | 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 |
Quote di API Gateway per la configurazione e l'esecuzione di un'API WebSocket
Le quote indicate di seguito si applicano alla configurazione e all'esecuzione di un'API WebSocket in Amazon API Gateway.
| Operazione o risorsa | Quota predefinita | Può essere aumentata |
|---|---|---|
| Nuove connessioni al secondo per account (in tutte le API WebSocket) per regione | 500 | Sì |
| Connessioni simultanee | Non applicabile * | Non applicabile. |
| AWS Lambda Autorizzatori per API | 10 | Sì |
| AWS Lambda Dimensione del risultato dell'autorizzazione | 8 KB | No |
| Instradamenti per API | 300 | Sì |
| Integrazioni per API | 300 | Sì |
| Timeout integrazione | 50 millisecondi - 29 secondi per tutti i tipi di integrazione, inclusi Lambda, proxy Lambda, HTTP, proxy HTTP e integrazioni AWS. | No |
| Fasi per API | 10 | Sì |
| Dimensioni frame WebSocket | 32 KB | No |
| Dimensioni payload del messaggio | 128 KB ** | No |
| Dimensione massima del modello di mappatura | 300 KB | No |
| Durata della connessione per l'API WebSocket | 2 ore | No |
| Timeout per connessione inattiva | 10 minuti | No |
| Lunghezza, in caratteri, dell'URL per un'API WebSocket | 4096 | No |
* Il servizio API Gateway non applica una quota sulle connessioni simultanee. Il numero massimo di connessioni simultanee è determinato dalla velocità delle nuove connessioni al secondo e dalla durata massima della connessione di due ore. Ad esempio, con la quota predefinita di 500 nuove connessioni al secondo, se i client si connettono alla velocità massima per più due ore, API Gateway può servire fino a 3.600.000 connessioni simultanee.
** A causa della quota di 32 KB per le dimensioni dei frame WebSocket, un messaggio di dimensioni superiori a 32 KB deve essere suddiviso in più frame, ciascuno di 32 KB o più piccolo. Si applica ai comandi @connections. Se si riceve un messaggio di dimensioni maggiori (o con dimensioni di frame maggiori), la connessione viene chiusa con il codice 1009.
Quote di API Gateway per la configurazione e l'esecuzione di un'API REST
Le quote seguenti si applicano alla configurazione e all'esecuzione di un'API REST in Amazon API Gateway. Per restapi:import o restapi:put, la dimensione massima del file di definizione dell'API è 6 MB.
È possibile aumentare le quote relative a ogni API solo su API specifiche.
| 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ì |
| Associazioni di accesso di nomi di dominio per account | 100 | Sì |
| Mappature API multilivello per dominio | 200 | No |
| 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 |
| API private per account per regione | 600 | 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ì |
| Parti documentazione per API | 2000 | Sì |
| 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 integrazione | 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 |
| Lunghezza dell'ARN di un metodo con autorizzazione | 1600 byte | No |
| Impostazioni di limitazione a livello di metodo per una fase in un piano di utilizzo | 20 | Sì |
| 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 |
* Non è possibile impostare il timeout di integrazione su meno di 50 millisecondi. È possibile aumentare il timeout di integrazione a più di 29 secondi per le API regionali e le API private, ma è possibile che venga richiesta una riduzione del limite di quota della limitazione (della larghezza di banda della rete) a livello regionale per l'account.
Quote di API Gateway per la creazione, la distribuzione e la gestione di un'API
Di seguito sono indicate le quote fisse che si applicano alla creazione, all'implementazione e alla gestione di un'API in API Gateway, utilizzando la AWS CLI, la console API Gateway o l'API REST API Gateway e i relativi SDK. Queste quote non possono essere aumentate.
| Operazione | Quota predefinita | Può essere aumentata |
|---|---|---|
| CreateApiKey | 5 richieste al secondo per account | No |
| CreateDeployment | 1 richiesta ogni 5 secondi per account | No |
| CreateDocumentationVersion | 1 richiesta ogni 20 secondi per account | No |
| CreateDomainName | 1 richiesta ogni 30 secondi per account | No |
| CreateResource | 5 richieste al secondo per account | No |
| CreateRestApi | API regionale o privata
API ottimizzata per gli edge
|
No |
| CreateVpcLink (V2) | 1 richiesta ogni 15 secondi per account | No |
| DeleteApiKey | 5 richieste al secondo per account | No |
| DeleteDomainName | 1 richiesta ogni 30 secondi per account | No |
| DeleteResource | 5 richieste al secondo per account | No |
| DeleteRestApi | 1 richiesta ogni 30 secondi per account | No |
| GetResources | 5 richieste ogni 2 secondi per account | No |
| DeleteVpcLink (V2) | 1 richiesta ogni 30 secondi per account | No |
| ImportDocumentationParts | 1 richiesta ogni 30 secondi per account | No |
| ImportRestApi | API regionale o privata
API ottimizzata per gli edge
|
No |
| PutRestApi | 1 richiesta al secondo per account | No |
| UpdateAccount | 1 richiesta ogni 20 secondi per account | No |
| UpdateDomainName | 1 richiesta ogni 30 secondi per account | No |
| UpdateUsagePlan | 1 richiesta ogni 20 secondi per account | No |
| Altre operazioni | Nessuna quota fino alla quota totale dell'account. | No |
| Operazioni totali | 10 richieste al secondo con una quota di ottimizzazione di 40 richieste al secondo. | No |
