Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Garantir l'idempuissance des demandes StartSnapshot API

L'idempotencie garantit qu'une API demande ne se termine 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.

StartSnapshotAPISupporte l'idempotencie à l'aide d'un jeton client. Un jeton client est une chaîne unique que vous spécifiez lorsque vous faites une API demande. Si vous réessayez une API demande avec le même jeton client et les mêmes paramètres de demande une fois qu'elle est terminée avec succès, le résultat de la demande initiale 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, un jeton client est AWS SDKs automatiquement généré pour la demande afin de s'assurer qu'elle est idempotente.

Un jeton client peut être n'importe quelle chaîne comportant jusqu'à 64 ASCII caractères. 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 du 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