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

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

ToJSON RetrieveTapeArchive

Methods

toJSON :: RetrieveTapeArchive -> Value

toEncoding :: RetrieveTapeArchive -> Encoding

toJSONList :: [RetrieveTapeArchive] -> Value

toEncodingList :: [RetrieveTapeArchive] -> Encoding

NFData RetrieveTapeArchive

Methods

rnf :: RetrieveTapeArchive -> ()

AWSRequest RetrieveTapeArchive

Associated Types

type Rs RetrieveTapeArchive :: *

Methods

request :: RetrieveTapeArchive -> Request RetrieveTapeArchive

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

ToHeaders RetrieveTapeArchive

Methods

toHeaders :: RetrieveTapeArchive -> [Header]

ToPath RetrieveTapeArchive

Methods

toPath :: RetrieveTapeArchive -> ByteString

ToQuery RetrieveTapeArchive

Methods

toQuery :: RetrieveTapeArchive -> QueryString

type Rep RetrieveTapeArchive

type Rep RetrieveTapeArchive = D1 * (MetaData "RetrieveTapeArchive" "Network.AWS.StorageGateway.RetrieveTapeArchive" "amazonka-storagegateway-1.6.0-4O2jykLIBNRAOy2n0S31Gg" 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 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

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.6.0-4O2jykLIBNRAOy2n0S31Gg" False) (C1 * (MetaCons "RetrieveTapeArchiveResponse'" PrefixI True) ((:*:) * (S1 * (MetaSel (Just Symbol "_rtarsTapeARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_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.