Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1490380385.5 KB

Retrieves the recovery point for the specified virtual tape. This operation is only supported in the tape gateway type.

A recovery point is a point in time view of a virtual tape at which all the data on the tape is consistent. If your gateway crashes, virtual tapes that have recovery points can be recovered to a new gateway.

The virtual tape can be retrieved to only one gateway. The retrieved tape is read-only. The virtual tape can be retrieved to only a tape gateway. There is no charge for retrieving recovery points.

post/#X-Amz-Target=StorageGateway_20130630.RetrieveTapeRecoveryPoint

Headers

X-Amz-Target'StorageGateway_20130630.RetrieveTapeRecoveryPoint' required

Request body

TapeARNstring required

The Amazon Resource Name (ARN) of the virtual tape for which you want to retrieve the recovery point.

GatewayARNstring required

The Amazon Resource Name (ARN) of the gateway. Use the <a>ListGateways</a> operation to return a list of gateways for your account and Amazon Web Services Region.

Response

Success

TapeARNstring

The Amazon Resource Name (ARN) of the virtual tape for which the recovery point was retrieved.

Example response

{
  "TapeARN": "arn:aws:storagegateway:us-east-1:999999999999:tape/TEST0AA2AF"
}