Retrieves an archived virtual tape from the virtual tape shelf (VTS) to a gateway-VTL. Virtual tapes archived in the VTS are not associated with any gateway. However after a tape is retrieved, it is associated with a gateway, even though it is also listed in the VTS.
Once a tape is successfully retrieved to a gateway, it cannot be retrieved again to another gateway. You must archive the tape again before you can retrieve it to another gateway.
Declaration Syntax| C# |
public RetrieveTapeArchiveResponse RetrieveTapeArchive( RetrieveTapeArchiveRequest retrieveTapeArchiveRequest )
Parameters- retrieveTapeArchiveRequest (RetrieveTapeArchiveRequest)
- Container for the necessary parameters to execute the RetrieveTapeArchive service method on AmazonStorageGateway.
Return ValueThe response from the RetrieveTapeArchive service method, as returned by AmazonStorageGateway.
Exceptions| Exception | Condition |
|---|---|
| InternalServerErrorException | |
| InvalidGatewayRequestException |