Network.AWS.StorageGateway.RetrieveTapeArchive

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.

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
• rtaGatewayARN

data RetrieveTapeArchive

RetrieveTapeArchiveInput

See: retrieveTapeArchive smart constructor.

Instances

Eq RetrieveTapeArchive

Methods

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

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

Data 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

Methods

readsPrec :: Int -> ReadS RetrieveTapeArchive

readList :: ReadS [RetrieveTapeArchive]

readPrec :: ReadPrec RetrieveTapeArchive

readListPrec :: ReadPrec [RetrieveTapeArchive]

Show RetrieveTapeArchive

Methods

showsPrec :: Int -> RetrieveTapeArchive -> ShowS

show :: RetrieveTapeArchive -> String

showList :: [RetrieveTapeArchive] -> ShowS

Generic RetrieveTapeArchive

Associated Types

type Rep RetrieveTapeArchive :: * -> *

Methods

from :: RetrieveTapeArchive -> Rep RetrieveTapeArchive x

to :: Rep RetrieveTapeArchive x -> RetrieveTapeArchive

Hashable RetrieveTapeArchive

Methods

hashWithSalt :: Int -> RetrieveTapeArchive -> Int

hash :: RetrieveTapeArchive -> Int

NFData RetrieveTapeArchive

Methods

rnf :: RetrieveTapeArchive -> ()

AWSRequest RetrieveTapeArchive

Associated Types

type Rs RetrieveTapeArchive :: *

Methods

request :: RetrieveTapeArchive -> Request RetrieveTapeArchive

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

ToPath RetrieveTapeArchive

Methods

toPath :: RetrieveTapeArchive -> ByteString

ToHeaders RetrieveTapeArchive

Methods

toHeaders :: RetrieveTapeArchive -> [Header]

ToQuery RetrieveTapeArchive

Methods

toQuery :: RetrieveTapeArchive -> QueryString

ToJSON RetrieveTapeArchive

Methods

toJSON :: RetrieveTapeArchive -> Value

toEncoding :: RetrieveTapeArchive -> Encoding

type Rep RetrieveTapeArchive

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

type Rs 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 gateway-VTL.

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
• rtarsResponseStatus

data RetrieveTapeArchiveResponse

RetrieveTapeArchiveOutput

See: retrieveTapeArchiveResponse smart constructor.

Instances

Eq RetrieveTapeArchiveResponse

Methods

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

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

Data RetrieveTapeArchiveResponse

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

Methods

readsPrec :: Int -> ReadS RetrieveTapeArchiveResponse

readList :: ReadS [RetrieveTapeArchiveResponse]

readPrec :: ReadPrec RetrieveTapeArchiveResponse

readListPrec :: ReadPrec [RetrieveTapeArchiveResponse]

Show RetrieveTapeArchiveResponse

Methods

showsPrec :: Int -> RetrieveTapeArchiveResponse -> ShowS

show :: RetrieveTapeArchiveResponse -> String

showList :: [RetrieveTapeArchiveResponse] -> ShowS

Generic RetrieveTapeArchiveResponse

Associated Types

type Rep RetrieveTapeArchiveResponse :: * -> *

Methods

from :: RetrieveTapeArchiveResponse -> Rep RetrieveTapeArchiveResponse x

to :: Rep RetrieveTapeArchiveResponse x -> RetrieveTapeArchiveResponse

NFData RetrieveTapeArchiveResponse

Methods

rnf :: RetrieveTapeArchiveResponse -> ()

type Rep RetrieveTapeArchiveResponse

type Rep RetrieveTapeArchiveResponse = D1 (MetaData "RetrieveTapeArchiveResponse" "Network.AWS.StorageGateway.RetrieveTapeArchive" "amazonka-storagegateway-1.4.4-HOInns2Rr9V9xD6G5ZVbNW" False) (C1 (MetaCons "RetrieveTapeArchiveResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_rtarsTapeARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_rtarsResponseStatus") NoSourceUnpackedness SourceStrict DecidedUnpack) (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.