Idempotencia para la API StartSnapshot - Amazon Elastic Compute Cloud

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 API StartSnapshot admite idempotencia usando 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 especifica su propio token de cliente, los SDK de AWS generan automáticamente un token de cliente para la solicitud para asegurarse de que es 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 hacer una solicitud StartSnapshot idempotente con su propio token de cliente usando 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 solicitud StartSnapshot idempotente con su propio token de cliente usando la AWS CLI

Especifique el parámetro de solicitud client-token.

$ aws ebs start-snapshot --region us-east-2 --volume-size 8 --parent-snapshot snap-123EXAMPLE1234567 --timeout 60 --client-token 550e8400-e29b-41d4-a716-446655440000