Network.AWS.StorageGateway.RetrieveTapeArchive

Retrieves an archived virtual tape from the virtual tape shelf (VTS) to a tape gateway. 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, that is, archive. This operation is only supported in the tape gateway type.

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. This operation is only supported in the tape gateway type.

Creating a Request

retrieveTapeArchive

Arguments

:: Text

rtaTapeARN

-> Text

rtaGatewayARN

-> RetrieveTapeArchive

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:

• rtaTapeARN - The Amazon Resource Name (ARN) of the virtual tape you want to retrieve from the virtual tape shelf (VTS).
• rtaGatewayARN - 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 tape gateway.

data RetrieveTapeArchive

RetrieveTapeArchiveInput

See: retrieveTapeArchive smart constructor.

Instances

Eq RetrieveTapeArchive

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Methods

(==) :: RetrieveTapeArchive -> RetrieveTapeArchive -> Bool

(/=) :: RetrieveTapeArchive -> RetrieveTapeArchive -> Bool

Data RetrieveTapeArchive

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> RetrieveTapeArchive -> c RetrieveTapeArchive

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c RetrieveTapeArchive

toConstr :: RetrieveTapeArchive -> Constr

dataTypeOf :: RetrieveTapeArchive -> DataType

dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c RetrieveTapeArchive)

dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c RetrieveTapeArchive)

gmapT :: (forall b. Data b => b -> b) -> RetrieveTapeArchive -> RetrieveTapeArchive

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> RetrieveTapeArchive -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> RetrieveTapeArchive -> r

gmapQ :: (forall d. Data d => d -> u) -> RetrieveTapeArchive -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> RetrieveTapeArchive -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> RetrieveTapeArchive -> m RetrieveTapeArchive

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> RetrieveTapeArchive -> m RetrieveTapeArchive

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> RetrieveTapeArchive -> m RetrieveTapeArchive

Read RetrieveTapeArchive

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Methods

readsPrec :: Int -> ReadS RetrieveTapeArchive

readList :: ReadS [RetrieveTapeArchive]

readPrec :: ReadPrec RetrieveTapeArchive

readListPrec :: ReadPrec [RetrieveTapeArchive]

Show RetrieveTapeArchive

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Methods

showsPrec :: Int -> RetrieveTapeArchive -> ShowS

show :: RetrieveTapeArchive -> String

showList :: [RetrieveTapeArchive] -> ShowS

Generic RetrieveTapeArchive

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Associated Types

type Rep RetrieveTapeArchive :: Type -> Type

Methods

from :: RetrieveTapeArchive -> Rep RetrieveTapeArchive x

to :: Rep RetrieveTapeArchive x -> RetrieveTapeArchive

Hashable RetrieveTapeArchive

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Methods

hashWithSalt :: Int -> RetrieveTapeArchive -> Int

hash :: RetrieveTapeArchive -> Int

ToJSON RetrieveTapeArchive

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Methods

toJSON :: RetrieveTapeArchive -> Value

toEncoding :: RetrieveTapeArchive -> Encoding

toJSONList :: [RetrieveTapeArchive] -> Value

toEncodingList :: [RetrieveTapeArchive] -> Encoding

AWSRequest RetrieveTapeArchive

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Associated Types

type Rs RetrieveTapeArchive :: Type

Methods

request :: RetrieveTapeArchive -> Request RetrieveTapeArchive

response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy RetrieveTapeArchive -> ClientResponse -> m (Response RetrieveTapeArchive)

ToHeaders RetrieveTapeArchive

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Methods

toHeaders :: RetrieveTapeArchive -> [Header]

ToPath RetrieveTapeArchive

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Methods

toPath :: RetrieveTapeArchive -> ByteString

ToQuery RetrieveTapeArchive

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Methods

toQuery :: RetrieveTapeArchive -> QueryString

NFData RetrieveTapeArchive

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Methods

rnf :: RetrieveTapeArchive -> ()

type Rep RetrieveTapeArchive

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

type Rep RetrieveTapeArchive = D1 (MetaData "RetrieveTapeArchive" "Network.AWS.StorageGateway.RetrieveTapeArchive" "amazonka-storagegateway-1.6.1-8r5RVaLfJcl46lpEVK6Ktc" False) (C1 (MetaCons "RetrieveTapeArchive'" PrefixI True) (S1 (MetaSel (Just "_rtaTapeARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text) :*: S1 (MetaSel (Just "_rtaGatewayARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))

type Rs RetrieveTapeArchive

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

type Rs RetrieveTapeArchive = RetrieveTapeArchiveResponse

Request Lenses

rtaTapeARN :: Lens' RetrieveTapeArchive Text

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

rtaGatewayARN :: Lens' RetrieveTapeArchive Text

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 tape gateway.

Destructuring the Response

retrieveTapeArchiveResponse

Arguments

:: Int

rtarsResponseStatus

-> RetrieveTapeArchiveResponse

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:

• rtarsTapeARN - The Amazon Resource Name (ARN) of the retrieved virtual tape.
• rtarsResponseStatus - -- | The response status code.

data RetrieveTapeArchiveResponse

RetrieveTapeArchiveOutput

See: retrieveTapeArchiveResponse smart constructor.

Instances

Eq RetrieveTapeArchiveResponse

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Methods

(==) :: RetrieveTapeArchiveResponse -> RetrieveTapeArchiveResponse -> Bool

(/=) :: RetrieveTapeArchiveResponse -> RetrieveTapeArchiveResponse -> Bool

Data RetrieveTapeArchiveResponse

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> RetrieveTapeArchiveResponse -> c RetrieveTapeArchiveResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c RetrieveTapeArchiveResponse

toConstr :: RetrieveTapeArchiveResponse -> Constr

dataTypeOf :: RetrieveTapeArchiveResponse -> DataType

dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c RetrieveTapeArchiveResponse)

dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c RetrieveTapeArchiveResponse)

gmapT :: (forall b. Data b => b -> b) -> RetrieveTapeArchiveResponse -> RetrieveTapeArchiveResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> RetrieveTapeArchiveResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> RetrieveTapeArchiveResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> RetrieveTapeArchiveResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> RetrieveTapeArchiveResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> RetrieveTapeArchiveResponse -> m RetrieveTapeArchiveResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> RetrieveTapeArchiveResponse -> m RetrieveTapeArchiveResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> RetrieveTapeArchiveResponse -> m RetrieveTapeArchiveResponse

Read RetrieveTapeArchiveResponse

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Methods

readsPrec :: Int -> ReadS RetrieveTapeArchiveResponse

readList :: ReadS [RetrieveTapeArchiveResponse]

readPrec :: ReadPrec RetrieveTapeArchiveResponse

readListPrec :: ReadPrec [RetrieveTapeArchiveResponse]

Show RetrieveTapeArchiveResponse

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Methods

showsPrec :: Int -> RetrieveTapeArchiveResponse -> ShowS

show :: RetrieveTapeArchiveResponse -> String

showList :: [RetrieveTapeArchiveResponse] -> ShowS

Generic RetrieveTapeArchiveResponse

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Associated Types

type Rep RetrieveTapeArchiveResponse :: Type -> Type

Methods

from :: RetrieveTapeArchiveResponse -> Rep RetrieveTapeArchiveResponse x

to :: Rep RetrieveTapeArchiveResponse x -> RetrieveTapeArchiveResponse

NFData RetrieveTapeArchiveResponse

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

Methods

rnf :: RetrieveTapeArchiveResponse -> ()

type Rep RetrieveTapeArchiveResponse

Defined in Network.AWS.StorageGateway.RetrieveTapeArchive

type Rep RetrieveTapeArchiveResponse = D1 (MetaData "RetrieveTapeArchiveResponse" "Network.AWS.StorageGateway.RetrieveTapeArchive" "amazonka-storagegateway-1.6.1-8r5RVaLfJcl46lpEVK6Ktc" False) (C1 (MetaCons "RetrieveTapeArchiveResponse'" PrefixI True) (S1 (MetaSel (Just "_rtarsTapeARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_rtarsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))

Response Lenses

rtarsTapeARN :: Lens' RetrieveTapeArchiveResponse (Maybe Text)

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

rtarsResponseStatus :: Lens' RetrieveTapeArchiveResponse Int

• - | The response status code.