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à.
# Limitazione delle richieste per l'API Amazon EC2
Amazon EC2 limita le richieste EC2 API per ogni AWS account in base alla regione. Lo facciamo per migliorare le prestazioni del servizio e garantire un utilizzo equo per tutti i EC2 clienti Amazon. La limitazione garantisce che le richieste all' EC2 API Amazon non superino i limiti massimi consentiti per le richieste API. Le richieste API sono soggette ai limiti di richiesta indipendentemente dal fatto che provengano da:
+ Un'applicazione di terze parti
+ Uno strumento da riga di comando
+ La EC2 console Amazon
Se superi un limite di limitazione delle API, ricevi il codice di `RequestLimitExceeded` errore.
**Topics**
+ [Come viene applicata la limitazione](#throttling-how)
+ [Richiedi limiti per i token](#throttling-limits-rate-based)
+ [Limiti dei token di risorsa](#throttling-limits-cost-based)
+ [Monitora la limitazione delle API](#throttling-monitor)
+ [Tentativi e backoff esponenziale](#api-backoff)
+ [Richiedere un aumento del limite della](#throttling-increase)
## Come viene applicata la limitazione
Amazon EC2 utilizza l'[algoritmo token bucket](https://en.wikipedia.org/wiki/Token_bucket) per implementare il throttling delle API. *Con questo algoritmo, il tuo account dispone di un *bucket* che contiene un numero specifico di token.* Il numero di token nel bucket rappresenta il limite di throttling in un dato secondo.
Amazon EC2 implementa due tipi di limitazione delle API:
**Topics**
+ [Limitazione del tasso di richiesta](#throttling-rate-based)
+ [Limitazione della frequenza delle risorse](#throttling-cost-based)
### Limitazione del tasso di richiesta
Con la limitazione della frequenza delle richieste, ogni API viene valutata singolarmente e il numero di richieste effettuate per ogni API è limitato. Ogni richiesta effettuata rimuove un token dal bucket dell'API. Ad esempio, la dimensione del bucket di token per `DescribeHosts` un'azione API *non mutante* è di 100 token. Puoi effettuare fino a 100 `DescribeHosts` richieste in un secondo. Se superi le 100 richieste in un secondo, vieni limitato da quell'API e le richieste rimanenti entro quel secondo falliscono, tuttavia, le richieste per altre API non ne risentono.
I bucket si ricaricano automaticamente a una velocità prestabilita. Se il bucket è al di sotto della sua capacità massima, gli viene aggiunto un determinato numero di token ogni secondo fino a raggiungere la capacità massima. Se il secchio è pieno quando arrivano i gettoni di ricarica, questi vengono scartati. Il bucket non può contenere più del numero massimo di token. Ad esempio, la dimensione del bucket per `DescribeHosts` un'azione API *non mutante* è di 100 token e la frequenza di ricarica è di 20 token al secondo. Se si effettuano 100 `DescribeHosts` richieste in un secondo, il bucket viene ridotto a zero (0) token. Il bucket viene quindi ricaricato di 20 token ogni secondo, fino a raggiungere la capacità massima di 100 token. Ciò significa che un bucket vuoto raggiunge la sua capacità massima dopo 5 secondi se non vengono effettuate richieste durante tale periodo.
Non è necessario attendere che il bucket sia completamente pieno prima di poter effettuare richieste API. Puoi utilizzare i token di ricarica man mano che vengono aggiunti al bucket. Se si utilizzano immediatamente i gettoni di ricarica, il secchio non raggiunge la sua capacità massima. Ad esempio, la dimensione del bucket per `DescribeHosts` un'azione API *non mutante* è di 100 token e la frequenza di ricarica è di 20 token al secondo. Se esaurisci il bucket effettuando 100 richieste API in un secondo, puoi continuare a fare 20 richieste API al secondo utilizzando i token di ricarica man mano che vengono aggiunti al bucket. Il bucket può essere ricaricato fino alla capacità massima solo se effettui meno di 20 richieste API al secondo.
Per ulteriori informazioni, consulta [Richiedi le dimensioni dei bucket di token e le tariffe di ricarica](#throttling-limits-rate-based).
### Limitazione della frequenza delle risorse
Alcune azioni API, come `RunInstances` e`TerminateInstances`, come descritto nella tabella che segue, utilizzano la limitazione della velocità delle risorse oltre alla limitazione della velocità delle richieste. Queste azioni API hanno un bucket di token di risorse separato che si esaurisce in base al numero di risorse interessate dalla richiesta. Analogamente ai bucket di token di richiesta, i bucket di token di risorse hanno un numero massimo di bucket che consente di eseguire il burst e una frequenza di ricarica che consente di mantenere una frequenza costante di richieste per tutto il tempo necessario. Se superi un limite di bucket specifico per un'API, incluso quando un bucket non è stato ancora riempito per supportare la successiva richiesta API, l'azione dell'API è limitata anche se non hai raggiunto il limite totale di limitazione dell'API.
Ad esempio, la dimensione del bucket di token di risorse `RunInstances` è di 1000 token e la frequenza di ricarica è di due token al secondo. Pertanto, è possibile avviare immediatamente 1000 istanze, utilizzando un numero qualsiasi di richieste API, ad esempio una richiesta per 1000 istanze o quattro richieste per 250 istanze. Dopo che il bucket di token di risorse è vuoto, puoi avviare fino a due istanze al secondo, utilizzando una richiesta per due istanze o due richieste per un'istanza.
Per ulteriori informazioni, consulta [Dimensioni dei Resource Token Bucket e tassi di ricarica](#throttling-limits-cost-based).
## Richiedi le dimensioni dei bucket di token e le tariffe di ricarica
Ai fini della limitazione della frequenza delle richieste, le azioni API sono raggruppate nelle seguenti categorie:
+ Azioni **non mutanti: azioni** API che recuperano dati sulle risorse. Questa categoria include generalmente tutte le azioni `Describe*``List*`,`Search*`, e `Get*` API, come`DescribeRouteTables`, `SearchTransitGatewayRoutes` e. `GetIpamPoolCidrs` Queste azioni API in genere hanno i limiti di limitazione delle API più elevati.
+ [https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) Si consiglia di utilizzare l'impaginazione e il filtraggio in modo che i token vengano detratti dal bucket di token standard (più grande).
+ Azioni **mutanti: azioni** API che creano, modificano o eliminano risorse. Questa categoria include in genere tutte le azioni API che non sono classificate come *azioni non mutanti*, ad esempio, e. `AllocateHosts` `ModifyHosts` `CreateCapacityReservation` Queste azioni hanno un limite di limitazione inferiore rispetto alle azioni API non mutanti.
+ Azioni che **richiedono molte risorse: azioni** API mutanti che richiedono più tempo e più risorse per essere completate. *Queste azioni hanno un limite di limitazione ancora più basso rispetto alle azioni di mutazione.* *Vengono limitate separatamente dalle altre azioni mutanti.*
+ Azioni **non mutanti della console: azioni** API non mutanti richieste dalla console Amazon. EC2 Queste azioni API vengono limitate separatamente dalle altre azioni API non mutanti.
+ **Azioni non categorizzate**: si tratta di azioni API che ricevono le proprie dimensioni di token e frequenze di ricarica, anche se per definizione rientrano in una delle altre categorie.
| Categoria di azioni API | Azioni | Capacità massima bucket | Frequenza di ricarica del secchio |
| --- | --- | --- | --- |
| Azioni non mutanti | Le azioni `Describe*``List*`,`Search*`, e `Get*` API che non sono incluse in un'altra categoria. | 100 | 20 |
| Azioni non mutanti non filtrate e non impaginate | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/ec2/latest/devguide/ec2-api-throttling.html) | 50 | 10 |
| Azioni mutanti | *Tutte le azioni API mutanti che non sono azioni che richiedono un uso intensivo di *risorse o azioni non categorizzate*.* | 50 | 5 |
| Azioni che richiedono molte risorse | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/ec2/latest/devguide/ec2-api-throttling.html) | 50 | 5 |
| Azioni non mutanti della console | Le azioni `Describe*``List*`,`Search*`, e `Get*` API richiamate dalla EC2 console Amazon, ma non incluse in un'altra categoria. | 100 | 10 |
| Azioni non categorizzate | Capacità massima bucket | Frequenza di ricarica del secchio |
| --- | --- | --- |
| AcceptVpcEndpointConnections | 10 | 1 |
| AdvertiseByoipCidr | 1 | 0.1 |
| AssignIpv6Addresses | 100 | 5 |
| AssignPrivateIpAddresses | 100 | 5 |
| AssignPrivateNatGatewayAddress | 10 | 1 |
| AssociateCapacityReservationBillingOwner | 1 | 0,5 |
| AssociateEnclaveCertificateIamRole | 10 | 1 |
| AssociateIamInstanceProfile | 100 | 5 |
| AssociateNatGatewayAddress | 10 | 1 |
| AttachVerifiedAccessTrustProvider | 10 | 2 |
| AuthorizeClientVpnIngress | 5 | 2 |
| CancelDeclarativePoliciesReport | 1 | 1 |
| CopyImage | 100 | 1 |
| CreateClientVpnRoute | 5 | 2 |
| CreateCoipCidr | 5 | 1 |
| CreateCoipPool | 5 | 1 |
| CreateDefaultSubnet | 1 | 1 |
| CreateDefaultVpc | 1 | 1 |
| CreateLaunchTemplateVersion | 100 | 5 |
| CreateNatGateway | 10 | 1 |
| CreateNetworkInterface | 100 | 5 |
| CreateRestoreImageTask | 50 | 0.1 |
| CreateSnapshot | 100 | 5 |
| CreateSnapshots | 100 | 5 |
| CreateSpotDatafeedSubscription | 50 | 3 |
| CreateStoreImageTask | 50 | 0.1 |
| CreateSubnetCidrReservation | 5 | 1 |
| CreateTags | 100 | 10 |
| CreateVerifiedAccessEndpoint | 20 | 4 |
| CreateVerifiedAccessGroup | 10 | 2 |
| CreateVerifiedAccessInstance | 10 | 2 |
| CreateVerifiedAccessTrustProvider | 10 | 2 |
| CreateVolume | 100 | 5 |
| CreateVpcEndpoint | 4 | 0.3 |
| CreateVpcEndpointServiceConfiguration | 10 | 1 |
| DeleteClientVpnRoute | 5 | 2 |
| DeleteCoipCidr | 5 | 1 |
| DeleteCoipPool | 5 | 1 |
| DeleteCoipPoolPermission | 5 | 1 |
| DeleteNatGateway | 10 | 1 |
| DeleteNetworkInterface | 100 | 5 |
| DeleteSnapshot | 100 | 5 |
| DeleteSpotDatafeedSubscription | 50 | 3 |
| DeleteSubnetCidrReservation | 5 | 1 |
| DeleteQueuedReservedInstances | 5 | 5 |
| DeleteTags | 100 | 10 |
| DeleteVerifiedAccessEndpoint | 20 | 4 |
| DeleteVerifiedAccessGroup | 10 | 2 |
| DeleteVerifiedAccessInstance | 10 | 2 |
| DeleteVerifiedAccessTrustProvider | 10 | 2 |
| DeleteVolume | 100 | 5 |
| DeleteVpcEndpoints | 4 | 0.3 |
| DeleteVpcEndpointServiceConfigurations | 10 | 1 |
| DeprovisionByoipCidr | 1 | 0.1 |
| DeregisterImage | 100 | 5 |
| DescribeAggregateIdFormat | 10 | 10 |
| DescribeByoipCidrs | 1 | 0,5 |
| DescribeCapacityBlockExtensionOfferings | 10 | 0,15 |
| DescribeCapacityBlockOfferings | 10 | 0,15 |
| DescribeDeclarativePoliciesReports | 5 | 5 |
| DescribeHostReservations | 5 | 2 |
| DescribeHostReservationOfferings | 5 | 2 |
| DescribeIdentityIdFormat | 10 | 10 |
| DescribeIdFormat | 10 | 10 |
| DescribeInstanceTopology | 1 | 1 |
| DescribeMovingAddresses | 1 | 1 |
| DescribePrincipalIdFormat | 10 | 10 |
| DescribeReservedInstancesOfferings | 10 | 10 |
| DescribeSecurityGroupReferences | 20 | 5 |
| DescribeSpotDatafeedSubscription | 100 | 13 |
| DescribeSpotFleetInstances | 100 | 5 |
| DescribeSpotFleetRequestHistory | 100 | 5 |
| DescribeSpotFleetRequests | 50 | 3 |
| DescribeStaleSecurityGroups | 20 | 5 |
| DescribeStoreImageTasks | 50 | 0,5 |
| DescribeVerifiedAccessInstanceLoggingConfigurations | 10 | 2 |
| DetachVerifiedAccessTrustProvider | 10 | 2 |
| DisableFastLaunch | 5 | 2 |
| DisableImageBlockPublicAccess | 1 | 0.1 |
| DisableSnapshotBlockPublicAccess | 1 | 0.1 |
| DisassociateCapacityReservationBillingOwner | 1 | 0,5 |
| DisassociateEnclaveCertificateIamRole | 10 | 1 |
| DisassociateIamInstanceProfile | 100 | 5 |
| DisassociateNatGatewayAddress | 10 | 1 |
| EnableFastLaunch | 5 | 2 |
| EnableImageBlockPublicAccess | 1 | 0.1 |
| EnableSnapshotBlockPublicAccess | 1 | 0.1 |
| GetAssociatedEnclaveCertificateIamRoles | 10 | 1 |
| GetDeclarativePoliciesReportSummary | 5 | 5 |
| GetHostReservationPurchasePreview | 5 | 2 |
| ModifyImageAttribute | 100 | 5 |
| ModifyInstanceMetadataDefaults | 2 | 2 |
| ModifyInstanceMetadataOptions | 100 | 5 |
| ModifyLaunchTemplate | 100 | 5 |
| ModifyNetworkInterfaceAttribute | 100 | 5 |
| ModifySnapshotAttribute | 100 | 5 |
| ModifyVerifiedAccessEndpoint | 20 | 4 |
| ModifyVerifiedAccessEndpointPolicy | 20 | 4 |
| ModifyVerifiedAccessGroup | 10 | 2 |
| ModifyVerifiedAccessGroupPolicy | 20 | 4 |
| ModifyVerifiedAccessInstance | 10 | 2 |
| ModifyVerifiedAccessInstanceLoggingConfiguration | 10 | 2 |
| ModifyVerifiedAccessTrustProvider | 10 | 2 |
| ModifyVpcEndpoint | 4 | 0.3 |
| ModifyVpcEndpointServiceConfiguration | 10 | 1 |
| MoveAddressToVpc | 1 | 1 |
| ProvisionByoipCidr | 1 | 0.1 |
| PurchaseCapacityBlock | 10 | 0,15 |
| PurchaseCapacityBlockExtension | 10 | 0,15 |
| PurchaseHostReservation | 5 | 2 |
| PurchaseReservedInstancesOffering | 5 | 5 |
| RejectVpcEndpointConnections | 10 | 1 |
| RestoreAddressToClassic | 1 | 1 |
| RevokeClientVpnIngress | 5 | 2 |
| RunInstances | 5 | 2 |
| StartDeclarativePoliciesReport | 1 | 1 |
| StartInstances | 5 | 2 |
| TerminateInstances | 100 | 5 |
| UnassignPrivateIpAddresses | 100 | 5 |
| UnassignPrivateNatGatewayAddress | 10 | 1 |
| WithdrawByoipCidr | 1 | 0.1 |
## Dimensioni dei Resource Token Bucket e tassi di ricarica
La tabella seguente elenca le dimensioni dei bucket di risorse e le frequenze di ricarica per le azioni API che utilizzano la limitazione della velocità delle risorse.
| Azione API | Capacità massima bucket | Frequenza di ricarica del secchio |
| --- | --- | --- |
| RunInstances | 1000 | 2 |
| TerminateInstances | 1000 | 20 |
| StartInstances | 1000 | 2 |
| StopInstances | 1000 | 20 |
## Monitora la limitazione delle API
Puoi utilizzare Amazon CloudWatch per monitorare le tue richieste EC2 API Amazon e raccogliere e tracciare i parametri relativi alla limitazione delle API. Puoi anche creare un allarme per avvisarti quando stai per raggiungere i limiti di limitazione delle API. Per ulteriori informazioni, consulta [Monitora le richieste EC2 API Amazon utilizzando Amazon CloudWatchMonitora le richieste API utilizzando CloudWatch](monitor.md).
## Tentativi e backoff esponenziale
L'applicazione potrebbe dover ripetere una richiesta API. Esempio:
+ Per verificare la presenza di un aggiornamento dello stato di una risorsa
+ Per enumerare un gran numero di risorse (ad esempio, tutti i volumi)
+ Riprovare una richiesta dopo che ha avuto esito negativo con un errore del server (5xx) o un errore di limitazione
Tuttavia, per un errore del client (4xx), è necessario modificare la richiesta per correggere il problema prima di riprovare la richiesta.
**Modifiche allo stato delle risorse**
Prima di iniziare i sondaggi per verificare la presenza di aggiornamenti sullo stato, attendi il tempo necessario per completare la richiesta. Ad esempio, attendi qualche minuto prima di verificare se l'istanza è attiva. Quando inizi il polling, utilizza un intervallo di sospensione appropriato tra le richieste successive per ridurre la frequenza delle richieste API. Per ottimizzare i risultati, utilizzare un intervallo di attesa incrementale o variabile.
In alternativa, puoi utilizzare Amazon EventBridge per informarti sullo stato di alcune risorse. Ad esempio, puoi utilizzare l'evento **EC2 Instance State-change Notification** per notificarti una modifica dello stato di un'istanza. Per ulteriori informazioni, consulta [Automatizza l' EC2 utilizzo EventBridge di Amazon](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/automating_with_eventbridge.html).
**Tentativi**
Quando devi eseguire il polling o riprovare una richiesta API, ti consigliamo di utilizzare un algoritmo di backoff esponenziale per calcolare l'intervallo di sospensione tra le richieste API. L'idea che sottende al backoff esponenziale è di utilizzare attese progressivamente più lunghe tra i tentativi per le risposte di errore consecutive. È consigliabile implementare un intervallo di ritardo massimo, nonché un numero massimo di tentativi. Puoi anche usare il jitter (ritardo casuale) per prevenire collisioni successive. Per maggiori informazioni, consulta [Timeout, nuovi tentativi e backoff con jitter](https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/).
Ogni AWS SDK implementa la logica di ripetizione automatica. Per ulteriori informazioni, consulta [Retry behavior nella *AWS SDKs and* Tools Reference](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html) Guide.
## Richiedere un aumento del limite della
Puoi richiedere un aumento dei limiti di limitazione delle API per il tuo. Account AWS
**Raccomandazioni**
+ Richiedi un massimo di tre volte il limite esistente in un'unica richiesta.
+ Dai priorità all'aumento della velocità di ricarica delle benne prima di aumentarne la capacità massima.
+ Se la velocità di ricarica della benna richiesta supera la capacità massima della benna, aumenta contemporaneamente la capacità massima della benna.
+ Fornisci tutte le azioni API che richiedono un aumento. I limiti vengono applicati alle singole azioni API, non alle categorie di azioni API.
+ Esistono limiti sia alla frequenza delle richieste che alla frequenza delle risorse per le seguenti azioni API: `RunInstances``StartInstances`,`StopInstances`, e`TerminateInstances`. Assicurati di indicare quale limite deve essere aumentato
**Per richiedere l'accesso a questa funzionalità**
1. Open [Supporto AWS Center](https://console.aws.amazon.com/support/home#/).
1. Scegli **Crea caso**.
1. Scegli **Account e fatturazione**.
1. Per **Assistenza**, scegli **Informazioni generali e Guida introduttiva**.
1. Per **Categoria**, scegli **Uso AWS e servizi**.
1. Scegli **Fase successiva: informazioni aggiuntive**.
1. Per **Subject (Oggetto)**, immettere **Request an increase in my Amazon EC2 API throttling limits**.
1. Per **Descrizione**, copia il seguente modello e fornisci le informazioni richieste.
```
Please increase the API throttling limits for my account.
Related page: https://docs.aws.amazon.com/ec2/latest/devguide/ec2-api-throttling.html
Description: Brief notes about your use case. If available, include the IDs
of a few Amazon EC2 requests that were throttled.
Time window: One-hour window when peak throttling or usage occurred.
region_1 request rate increases:
action: new_bucket_maximum_capacity
action: new_bucket_refill_rate
action: new_bucket_maximum_capacity|new_bucket_refill_rate
region_1 resource rate increases:
action: new_bucket_maximum_capacity
action: new_bucket_refill_rate
action: new_bucket_maximum_capacity|new_bucket_refill_rate
region_2 request rate increases:
action: new_bucket_maximum_capacity
action: new_bucket_refill_rate
action: new_bucket_maximum_capacity|new_bucket_refill_rate
region_2 resource rate increases:
action: new_bucket_maximum_capacity
action: new_bucket_refill_rate
action: new_bucket_maximum_capacity|new_bucket_refill_rate
```
1. Scegli **Passaggio successivo: risolvi ora o contattaci**.
1. Nella scheda **Contattaci**, scegli la lingua e il metodo di contatto preferiti.
1. Seleziona **Invia**.