Idempotenza per StartSnapshot API

L'idempotenza garantisce che una richiesta venga completata una sola volta. API In presenza di una richiesta idempotente, se la richiesta originale viene completata correttamente, i tentativi successivi restituiscono il risultato della richiesta originale riuscita e non producono alcun effetto aggiuntivo.

StartSnapshotAPISupporta l'idempotenza utilizzando un token client. Un token client è una stringa unica che viene specificata quando si effettua una richiesta. API Se riprovi una API richiesta con lo stesso token client e gli stessi parametri di richiesta dopo che è stata completata correttamente, viene restituito il risultato della richiesta originale. Se tenti di nuovo di eseguire una richiesta con lo stesso token client, ma modifichi uno o più parametri della richiesta, viene restituito l'errore ConflictException.

Se non specificate il vostro token client, genera AWS SDKs automaticamente un token client per la richiesta per garantire che sia idempotente.

Un token client può essere qualsiasi stringa che include fino a 64 caratteri. ASCII Non è consigliabile riutilizzare gli stessi token client per richieste diverse.

Per effettuare una StartSnapshot richiesta idempotente con il proprio token client, utilizzare il API

Specifica il parametro ClientToken della richiesta.

POST /snapshots HTTP/1.1
Host: ebs.us-east-2.amazonaws.com
Accept-Encoding: identity
User-Agent: <User agent parameter>
X-Amz-Date: 20200618T040724Z
Authorization: <Authentication parameter>

{
    "VolumeSize": 8,
    "ParentSnapshot": snap-123EXAMPLE1234567,
    "ClientToken": "550e8400-e29b-41d4-a716-446655440000",
    "Timeout": 60
}

Per effettuare una StartSnapshot richiesta idempotente con il proprio token client, utilizzare il AWS CLI

Specifica il parametro client-token della richiesta.

$ C:\> aws ebs start-snapshot --region us-east-2 --volume-size 8 --parent-snapshot snap-123EXAMPLE1234567 --timeout 60 --client-token 550e8400-e29b-41d4-a716-446655440000