StartSnapshot APIStellen Sie die Idempotenz in Anfragen sicher - Amazon EBS

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

StartSnapshot APIStellen Sie die Idempotenz in Anfragen sicher

Idempotenz stellt sicher, dass eine API Anfrage nur einmal abgeschlossen wird. Wenn bei einer Idempotenz-Anfrage die ursprüngliche Anfrage erfolgreich abgeschlossen wird, geben die nachfolgenden Wiederholungen das Ergebnis der ursprünglichen erfolgreichen Anfrage zurück und haben keine zusätzliche Wirkung.

Die StartSnapshotAPIunterstützt Idempotenz mithilfe eines Client-Tokens. Ein Client-Token ist eine eindeutige Zeichenfolge, die Sie angeben, wenn Sie eine API Anfrage stellen. Wenn Sie eine API Anfrage mit demselben Client-Token und denselben Anforderungsparametern erneut versuchen, nachdem sie erfolgreich abgeschlossen wurde, wird das Ergebnis der ursprünglichen Anfrage zurückgegeben. Wenn Sie eine Anforderung mit demselben Client-Token wiederholen, einen oder mehrere der Anforderungsparameter jedoch ändern, wird der Fehler ConflictException zurückgegeben.

Wenn Sie kein eigenes Client-Token angeben, generiert das AWS SDKs automatisch ein Client-Token für die Anfrage, um sicherzustellen, dass sie idempotent ist.

Ein Client-Token kann eine beliebige Zeichenfolge sein, die bis zu 64 ASCII Zeichen enthält. Sie sollten dieselben Client-Token nicht für verschiedene Anforderungen wiederverwenden.

Um eine idempotente StartSnapshot Anfrage mit Ihrem eigenen Client-Token zu stellen, verwenden Sie API

Geben Sie den Anforderungsparameter ClientToken an.

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
}
Um eine idempotente StartSnapshot Anfrage mit Ihrem eigenen Client-Token zu stellen, verwenden Sie AWS CLI

Geben Sie den Anforderungsparameter client-token an.

$ 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