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 e note importanti Amazon API Gateway
Argomenti
- Quote a livello di account API Gateway per ogni regione
- Quote API HTTP
- Quote 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
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.
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 |
|---|---|---|
| Limita la quota per account, per regione tra API HTTP, API REST, API e API di WebSocket 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 |
* Per le seguenti regioni, la quota di accelerazione predefinita è 2500 RPS e la quota burst predefinita è 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) e Canada occidentale (Calgary).
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 |
| Inserimento nel CloudWatch log di Amazon 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 API Gateway per la configurazione e l'esecuzione di un'API WebSocket
Le seguenti quote si applicano alla configurazione e all'esecuzione di un' WebSocket API in Amazon API Gateway.
| Operazione o risorsa | Quota predefinita | Può essere aumentata |
|---|---|---|
| Nuove connessioni al secondo per account (su tutte le WebSocket API) per regione | 500 | Sì |
| Connessioni simultanee | Non applicabile * | Non applicabile |
| AWS Lambda autorizzatori per API | 10 | Sì |
| AWS Lambda dimensione del risultato dell'autorizzatore | 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ì |
| WebSocket dimensione della cornice | 32 KB | No |
| Dimensioni payload del messaggio | 128 KB ** | No |
| Durata della connessione per l' WebSocket API | 2 ore | No |
| Timeout per connessione inattiva | 10 minuti | No |
| Lunghezza, in caratteri, dell'URL di un' WebSocket API | 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 WebSocket dimensione del frame di 32 KB, 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 |
|---|---|---|
| I nomi di dominio personalizzati per account per regione | 120 | 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ì* |
| Totale dimensioni combinate di tutti i valori dell'intestazione | 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 |
| 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 in un truststore | 1.000 certificati con una dimensione totale dell'oggetto fino a 1 MB. | No |
* Non è possibile impostare il timeout di integrazione su meno di 50 millisecondi. Puoi aumentare il timeout di integrazione a più di 29 secondi per le API regionali e le API private, ma ciò potrebbe richiedere una riduzione del limite di limitazione a livello di account.
Quote di API Gateway per la creazione, la distribuzione e la gestione di un'API
Le seguenti quote fisse si applicano alla creazione, alla distribuzione e alla gestione di un'API in API Gateway, utilizzando la AWS CLI console API Gateway o l'API REST di 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 |
