amazonka-storagegateway-1.4.0: Amazon Storage Gateway SDK.

Copyright(c) 2013-2016 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.StorageGateway.RetrieveTapeArchive

Contents

Description

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.

Synopsis

Creating a Request

retrieveTapeArchive Source

Creates a value of RetrieveTapeArchive with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Request Lenses

rtaTapeARN :: Lens' RetrieveTapeArchive Text Source

The Amazon Resource Name (ARN) of the virtual tape you want to retrieve from the virtual tape shelf (VTS).

rtaGatewayARN :: Lens' RetrieveTapeArchive Text Source

The Amazon Resource Name (ARN) of the gateway you want to retrieve the virtual tape to. Use the ListGateways operation to return a list of gateways for your account and region.

You retrieve archived virtual tapes to only one gateway and the gateway must be a gateway-VTL.

Destructuring the Response

retrieveTapeArchiveResponse Source

Creates a value of RetrieveTapeArchiveResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Response Lenses

rtarsTapeARN :: Lens' RetrieveTapeArchiveResponse (Maybe Text) Source

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