

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 Stellen Sie die Idempotenz bei API-Anfragen sicher
<a name="ebs-direct-api-idempotency"></a>

Idempotenz stellt sicher, dass eine API-Anforderung nur einmal durchgeführt 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 [ StartSnapshot](https://docs.aws.amazon.com/ebs/latest/APIReference/API_StartSnapshot.html)API unterstützt Idempotenz mithilfe eines Client-Tokens.* Ein Client-Token ist eine eindeutige Zeichenfolge, die Sie beim Senden einer API-Anforderung angeben. Wenn Sie eine API-Anforderung mit demselben Client-Token und denselben Anforderungsparametern wiederholen, nachdem sie erfolgreich abgeschlossen wurde, wird das Ergebnis der ursprünglichen Anforderung 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 mithilfe der API eine idempotente StartSnapshot Anfrage mit Ihrem eigenen Client-Token zu stellen**  
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 den 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
```