Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1490380385.5 KB

Cancels retrieval of a virtual tape from the virtual tape shelf (VTS) to a gateway after the retrieval process is initiated. The virtual tape is returned to the VTS. This operation is only supported in the tape gateway type.

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

Headers

X-Amz-Target'StorageGateway_20130630.CancelRetrieval' required

Request body

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.

TapeARNstring required

The Amazon Resource Name (ARN) of the virtual tape you want to cancel retrieval for.

Response

Success

TapeARNstring

The Amazon Resource Name (ARN) of the virtual tape for which retrieval was canceled.

Example response

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