

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Garanta a idempotência nas solicitações de API StartSnapshot
<a name="ebs-direct-api-idempotency"></a>

A idempotência garante que uma solicitação de API seja concluída apenas uma vez. Com uma solicitação idempotente, se a solicitação original for concluída com êxito, as novas tentativas subsequentes retornam o resultado da solicitação original bem-sucedida e não terão efeito adicional.

*A [ StartSnapshot](https://docs.aws.amazon.com/ebs/latest/APIReference/API_StartSnapshot.html)API oferece suporte à idempotência usando um token de cliente.* Um token de cliente é uma string exclusiva que você especifica ao fazer uma solicitação de API. Se você tentar refazer uma solicitação de API com o mesmo token de cliente e os mesmos parâmetros de solicitação depois de ela ter sido concluída com êxito, o resultado da solicitação original será retornado. Se você tentar refazer uma solicitação com o mesmo token de cliente, mas alterar um ou mais parâmetros de solicitação, o erro `ConflictException` será retornado.

Se você não especificar seu próprio token de cliente, ele AWS SDKs gerará automaticamente um token de cliente para a solicitação para garantir que ela seja idempotente.

Um token de cliente pode ser qualquer cadeia de caracteres contendo até 64 caracteres ASCII. Não reutilize os mesmos tokens de cliente para solicitações diferentes.

**Para fazer uma StartSnapshot solicitação idempotente com seu próprio token de cliente usando a API**  
Especifique o parâmetro de solicitação `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
}
```

**Para fazer uma StartSnapshot solicitação idempotente com seu próprio token de cliente usando o AWS CLI**  
Especifique o parâmetro de solicitação `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
```