Garantire l'idempotenza nelle richieste Amazon EC2 API

Quando effettui una richiesta mutante, in genere la API richiesta restituisce un risultato prima del completamento dei flussi di lavoro asincroni dell'operazione. Le operazioni potrebbero inoltre scadere o riscontrare altri problemi relativi al server prima del completamento, anche se la richiesta ha già restituito un risultato. Ciò potrebbe rendere difficile determinare l'esito della richiesta e potrebbe comportare più tentativi per garantire che l'operazione venga completata correttamente. Tuttavia, se la richiesta originale e i tentativi successivi hanno esito positivo, l'operazione viene completata più volte, Ciò significa che potresti creare più risorse del previsto.

L'idempotenza garantisce che una API richiesta venga completata non più di una volta. Quando si utilizza una richiesta idempotente, se la richiesta originale viene completata correttamente, tutti i tentativi successivi vengono completati correttamente senza alcuna azione aggiuntiva. Tuttavia, il risultato potrebbe contenere informazioni aggiornate, come lo stato di creazione corrente.

Idempotenza in Amazon EC2

Le seguenti API azioni sono idempotenti per impostazione predefinita e non richiedono una configurazione aggiuntiva. Per impostazione predefinita, AWS CLI i comandi corrispondenti supportano anche l'idempotenza.

Le seguenti API azioni supportano facoltativamente l'idempotenza utilizzando un token client. I AWS CLI comandi corrispondenti supportano anche l'idempotenza utilizzando un token client. Un token client è una stringa unica con distinzione tra maiuscole e minuscole, composta da un massimo di 64 caratteri. ASCII Per effettuare una API richiesta idempotente utilizzando una di queste azioni, specifica un token client nella richiesta. Non dovresti riutilizzare lo stesso token client per altre richieste. API Se riprovi una richiesta completata correttamente utilizzando lo stesso token client e gli stessi parametri, il nuovo tentativo ha esito positivo senza eseguire ulteriori azioni. Se si riprova una richiesta riuscita utilizzando lo stesso token client, ma uno o più parametri sono diversi, diversi dalla regione o dalla zona di disponibilità, il nuovo tentativo fallisce e viene restituito un errore. IdempotentParameterMismatch

RunInstances idempotenza

L'RunInstancesAPIazione utilizza l'idempotenza sia regionale che zonale.

Il tipo di idempotenza utilizzato dipende da come si specifica la zona di disponibilità nella richiesta. RunInstances API La richiesta utilizza l'idempotenza zonale nei seguenti casi:

Se non si specifica esplicitamente o implicitamente una zona di disponibilità, la richiesta utilizza l'idempotenza regionale.

Idempotenza zonale

L'idempotenza zonale garantisce che una RunInstances API richiesta sia idempotente in ogni zona di disponibilità di una regione. Ciò garantisce che una richiesta con lo stesso token client possa essere completata una sola volta all'interno di ciascuna zona di disponibilità di una regione. Tuttavia, lo stesso token client può essere utilizzato per avviare istanze in altre zone di disponibilità della regione.

Ad esempio, se invii una richiesta idempotente per avviare un'istanza nella zona di us-east-1a disponibilità e quindi utilizzi lo stesso token client in una richiesta nella zona di us-east-1b disponibilità, lanciamo istanze in ciascuna di quelle zone di disponibilità. Se uno o più parametri sono diversi, i tentativi successivi con lo stesso token client in quelle zone di disponibilità vengono restituiti correttamente senza eseguire ulteriori azioni o falliscono con un errore. IdempotentParameterMismatch

Idempotenza regionale

L'idempotenza regionale garantisce che una RunInstances API richiesta sia idempotente in una regione. Ciò garantisce che una richiesta con lo stesso token client possa essere completata solo una volta all'interno di una regione. Tuttavia, la stessa identica richiesta, con lo stesso token client, può essere utilizzata per avviare istanze in una regione diversa.

Ad esempio, se invii una richiesta idempotente per avviare un'istanza nella us-east-1 regione e poi utilizzi lo stesso token client in una richiesta nella eu-west-1 regione, lanciamo istanze in ognuna di quelle regioni. Se uno o più parametri sono diversi, i tentativi successivi con lo stesso token client in quelle regioni vengono restituiti correttamente senza eseguire ulteriori azioni o falliscono con un errore. IdempotentParameterMismatch

Esempi

AWS CLI esempi di comandi

Per rendere un AWS CLI comando idempotente, aggiungete l'opzione. --client-token

Esempio 1: idempotenza

Il seguente comando allocate-hosts utilizza l'idempotenza in quanto include un token client.

aws ec2 allocate-hosts  --instance-type m5.large  --availability-zone eu-west-1a  --auto-placement on  --quantity 1 --client-token 550e8400-e29b-41d4-a716-446655440000

Esempio 2: idempotenza regionale di run-instances

Il seguente comando run-instances utilizza l'idempotenza regionale in quanto include un token client ma non specifica in modo esplicito o implicito una zona di disponibilità.

aws ec2 run-instances --image-id ami-b232d0db --count 1 --key-name my-key-pair --client-token 550e8400-e29b-41d4-a716-446655440000

Esempio 3: idempotenza zonale di run-instances

Il seguente comando run-instances utilizza l'idempotenza zonale in quanto include un token client e una zona di disponibilità specificata in modo esplicito.

aws ec2 run-instances  --placement "AvailabilityZone=us-east-1a" --image-id ami-b232d0db --count 1 --key-name my-key-pair --client-token 550e8400-e29b-41d4-a716-446655440000

APIrichiedi esempi

Per rendere una API richiesta idempotente, aggiungi il parametro. ClientToken

Esempio 1: idempotenza

La AllocateHostsAPIrichiesta seguente utilizza l'idempotenza in quanto include un token client.

https://ec2.amazonaws.com/?Action=AllocateHosts
&AvailabilityZone=us-east-1b
&InstanceType=m5.large
&Quantity=1
&AutoPlacement=off
&ClientToken=550e8400-e29b-41d4-a716-446655440000
&AUTHPARAMS

Esempio 2: idempotenza regionale RunInstances

La RunInstancesAPIrichiesta seguente utilizza l'idempotenza regionale in quanto include un token client ma non specifica in modo esplicito o implicito una zona di disponibilità.

https://ec2.amazonaws.com/?Action=RunInstances
&ImageId=ami-3ac33653
&MaxCount=1
&MinCount=1
&KeyName=my-key-pair
&ClientToken=550e8400-e29b-41d4-a716-446655440000
&AUTHPARAMS

Esempio 3: idempotenza zonale RunInstances

La RunInstancesAPIrichiesta seguente utilizza l'idempotenza zonale in quanto include un token client e una zona di disponibilità specificata in modo esplicito.

https://ec2.amazonaws.com/?Action=RunInstances
&Placement.AvailabilityZone=us-east-1d
&ImageId=ami-3ac33653
&MaxCount=1
&MinCount=1
&KeyName=my-key-pair
&ClientToken=550e8400-e29b-41d4-a716-446655440000
&AUTHPARAMS

Riprova i consigli per le richieste idempotenti

La tabella seguente mostra alcune risposte comuni che potresti ricevere per richieste idempotenti e fornisce consigli API per riprovare.