Idempotência para API StartSnapshot

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 StartSnapshotAPI 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, os AWS SDKs gerarão automaticamente um token de cliente para a solicitação, a fim de 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