Idempotencia para la API StartSnapshot

La idempotencia garantiza que una solicitud de API se complete solo una vez. Con una solicitud idempotente, los reintentos posteriores devuelven el resultado de la solicitud original correcta y no tienen ningún efecto adicional.

La StartSnapshotAPI admite la idempotencia mediante un token de cliente. Un token de cliente es una cadena única que se especifica cuando se realiza una solicitud de API. Si vuelve a intentar una solicitud de API con el mismo token de cliente y los mismos parámetros de solicitud después de que se haya completado correctamente, se devuelve el resultado de la solicitud original. Si vuelve a intentar una solicitud con el mismo token de cliente, pero cambia uno o más de los parámetros de solicitud, se devuelve el error ConflictException.

Si no especificas tu propio token de cliente, los AWS SDK generan automáticamente un token de cliente para la solicitud, a fin de garantizar que sea idempotente.

Un token de cliente puede ser cualquier cadena que incluya hasta 64 caracteres ASCII. No debe reutilizar los mismos tokens de cliente para diferentes solicitudes.

Para realizar una StartSnapshot solicitud idempotente con tu propio token de cliente mediante la API

Especifique el parámetro de solicitud 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 realizar una StartSnapshot solicitud idempotente con tu propio token de cliente, utiliza la AWS CLI

Especifique el parámetro de solicitud 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