Idempotencia pour l'API StartSnapshot

L’idempotence garantit qu’une requête API n’est exécutée qu’une seule fois. Avec une demande idempotente, si la demande d’origine se termine avec succès, les tentatives suivantes renvoient le résultat de la demande d’origine réussie et elles n’ont aucun effet supplémentaire.

L' StartSnapshotAPI prend en charge l'idempotencie à l'aide d'un jeton client. Un jeton client est une chaîne unique que vous spécifiez lorsque vous effectuez une demande d’API. Si vous réessayez une demande d’API avec le même jeton client et les mêmes paramètres de requête une fois qu’elle est terminée correctement, le résultat de la demande d’origine est renvoyé. Si vous réessayez une demande avec le même jeton client, mais que vous modifiez un ou plusieurs paramètres de requête, l’erreur ConflictException est renvoyée.

Si vous ne spécifiez pas votre propre jeton client, les AWS SDK génèrent automatiquement un jeton client pour la demande afin de s'assurer qu'elle est idempotente.

Un jeton client peut être n’importe quelle chaîne qui comprend jusqu’à 64 caractères ASCII. Vous ne devez pas réutiliser les mêmes jetons client pour différentes demandes.

Pour effectuer une StartSnapshot demande idempotente avec votre propre jeton client à l'aide de l'API

Spécifiez le paramètre de demande ClientToken.

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
}

Pour effectuer une StartSnapshot demande idempotente avec votre propre jeton client à l'aide du AWS CLI

Spécifiez le paramètre de demande client-token.

$ 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