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á.

Garantir idempotência em solicitações da 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 API StartSnapshot oferece suporte para idempotência usando um token do 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 SDKs da AWS gerarão automaticamente um token de cliente para a solicitação a fim de garantir idempotência.

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.

Como fazer uma solicitação StartSnapshot 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
}

Como fazer uma solicitação StartSnapshot idempotente com seu próprio token de cliente usando a 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