v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1490380385.5 KB

Deletes the specified virtual tape. This operation is only supported in the tape gateway type.

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

Headers

X-Amz-Target'StorageGateway_20130630.DeleteTape' required

Request body

GatewayARNstring required

The unique Amazon Resource Name (ARN) of the gateway that the virtual tape to delete is associated with. 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 to delete.

BypassGovernanceRetentionboolean

Set to <code>TRUE</code> to delete an archived tape that belongs to a custom pool with tape retention lock. Only archived tapes with tape retention lock set to <code>governance</code> can be deleted. Archived tapes with tape retention lock set to <code>compliance</code> can't be deleted.

Response

Success

TapeARNstring

The Amazon Resource Name (ARN) of the deleted virtual tape.

Example response

{
  "TapeARN": "arn:aws:storagegateway:us-east-1:204469490176:tape/TEST05A2A0"
}