amazonka-storagegateway-0.3.4: gen/Network/AWS/StorageGateway/CreateCachediSCSIVolume.hs
{-# LANGUAGE DataKinds #-}
{-# LANGUAGE DeriveGeneric #-}
{-# LANGUAGE FlexibleInstances #-}
{-# LANGUAGE GeneralizedNewtypeDeriving #-}
{-# LANGUAGE LambdaCase #-}
{-# LANGUAGE NoImplicitPrelude #-}
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE RecordWildCards #-}
{-# LANGUAGE TypeFamilies #-}
{-# OPTIONS_GHC -fno-warn-unused-imports #-}
-- Module : Network.AWS.StorageGateway.CreateCachediSCSIVolume
-- Copyright : (c) 2013-2014 Brendan Hay <brendan.g.hay@gmail.com>
-- License : This Source Code Form is subject to the terms of
-- the Mozilla Public License, v. 2.0.
-- A copy of the MPL can be found in the LICENSE file or
-- you can obtain it at http://mozilla.org/MPL/2.0/.
-- Maintainer : Brendan Hay <brendan.g.hay@gmail.com>
-- Stability : experimental
-- Portability : non-portable (GHC extensions)
--
-- Derived from AWS service descriptions, licensed under Apache 2.0.
-- | This operation creates a cached volume on a specified cached gateway. This
-- operation is supported only for the gateway-cached volume architecture.
--
-- Cache storage must be allocated to the gateway before you can create a
-- cached volume. Use the 'AddCache' operation to add cache storage to a gateway.
-- In the request, you must specify the gateway, size of the volume in bytes,
-- the iSCSI target name, an IP address on which to expose the target, and a
-- unique client token. In response, AWS Storage Gateway creates the volume and
-- returns information about it such as the volume Amazon Resource Name (ARN),
-- its size, and the iSCSI target ARN that initiators can use to connect to the
-- volume target.
--
-- <http://docs.aws.amazon.com/storagegateway/latest/APIReference/API_CreateCachediSCSIVolume.html>
module Network.AWS.StorageGateway.CreateCachediSCSIVolume
(
-- * Request
CreateCachediSCSIVolume
-- ** Request constructor
, createCachediSCSIVolume
-- ** Request lenses
, ccscsivClientToken
, ccscsivGatewayARN
, ccscsivNetworkInterfaceId
, ccscsivSnapshotId
, ccscsivTargetName
, ccscsivVolumeSizeInBytes
-- * Response
, CreateCachediSCSIVolumeResponse
-- ** Response constructor
, createCachediSCSIVolumeResponse
-- ** Response lenses
, ccscsivrTargetARN
, ccscsivrVolumeARN
) where
import Network.AWS.Data (Object)
import Network.AWS.Prelude
import Network.AWS.Request.JSON
import Network.AWS.StorageGateway.Types
import qualified GHC.Exts
data CreateCachediSCSIVolume = CreateCachediSCSIVolume
{ _ccscsivClientToken :: Text
, _ccscsivGatewayARN :: Text
, _ccscsivNetworkInterfaceId :: Text
, _ccscsivSnapshotId :: Maybe Text
, _ccscsivTargetName :: Text
, _ccscsivVolumeSizeInBytes :: Integer
} deriving (Eq, Ord, Read, Show)
-- | 'CreateCachediSCSIVolume' constructor.
--
-- The fields accessible through corresponding lenses are:
--
-- * 'ccscsivClientToken' @::@ 'Text'
--
-- * 'ccscsivGatewayARN' @::@ 'Text'
--
-- * 'ccscsivNetworkInterfaceId' @::@ 'Text'
--
-- * 'ccscsivSnapshotId' @::@ 'Maybe' 'Text'
--
-- * 'ccscsivTargetName' @::@ 'Text'
--
-- * 'ccscsivVolumeSizeInBytes' @::@ 'Integer'
--
createCachediSCSIVolume :: Text -- ^ 'ccscsivGatewayARN'
-> Integer -- ^ 'ccscsivVolumeSizeInBytes'
-> Text -- ^ 'ccscsivTargetName'
-> Text -- ^ 'ccscsivNetworkInterfaceId'
-> Text -- ^ 'ccscsivClientToken'
-> CreateCachediSCSIVolume
createCachediSCSIVolume p1 p2 p3 p4 p5 = CreateCachediSCSIVolume
{ _ccscsivGatewayARN = p1
, _ccscsivVolumeSizeInBytes = p2
, _ccscsivTargetName = p3
, _ccscsivNetworkInterfaceId = p4
, _ccscsivClientToken = p5
, _ccscsivSnapshotId = Nothing
}
ccscsivClientToken :: Lens' CreateCachediSCSIVolume Text
ccscsivClientToken =
lens _ccscsivClientToken (\s a -> s { _ccscsivClientToken = a })
ccscsivGatewayARN :: Lens' CreateCachediSCSIVolume Text
ccscsivGatewayARN =
lens _ccscsivGatewayARN (\s a -> s { _ccscsivGatewayARN = a })
ccscsivNetworkInterfaceId :: Lens' CreateCachediSCSIVolume Text
ccscsivNetworkInterfaceId =
lens _ccscsivNetworkInterfaceId
(\s a -> s { _ccscsivNetworkInterfaceId = a })
ccscsivSnapshotId :: Lens' CreateCachediSCSIVolume (Maybe Text)
ccscsivSnapshotId =
lens _ccscsivSnapshotId (\s a -> s { _ccscsivSnapshotId = a })
ccscsivTargetName :: Lens' CreateCachediSCSIVolume Text
ccscsivTargetName =
lens _ccscsivTargetName (\s a -> s { _ccscsivTargetName = a })
ccscsivVolumeSizeInBytes :: Lens' CreateCachediSCSIVolume Integer
ccscsivVolumeSizeInBytes =
lens _ccscsivVolumeSizeInBytes
(\s a -> s { _ccscsivVolumeSizeInBytes = a })
data CreateCachediSCSIVolumeResponse = CreateCachediSCSIVolumeResponse
{ _ccscsivrTargetARN :: Maybe Text
, _ccscsivrVolumeARN :: Maybe Text
} deriving (Eq, Ord, Read, Show)
-- | 'CreateCachediSCSIVolumeResponse' constructor.
--
-- The fields accessible through corresponding lenses are:
--
-- * 'ccscsivrTargetARN' @::@ 'Maybe' 'Text'
--
-- * 'ccscsivrVolumeARN' @::@ 'Maybe' 'Text'
--
createCachediSCSIVolumeResponse :: CreateCachediSCSIVolumeResponse
createCachediSCSIVolumeResponse = CreateCachediSCSIVolumeResponse
{ _ccscsivrVolumeARN = Nothing
, _ccscsivrTargetARN = Nothing
}
ccscsivrTargetARN :: Lens' CreateCachediSCSIVolumeResponse (Maybe Text)
ccscsivrTargetARN =
lens _ccscsivrTargetARN (\s a -> s { _ccscsivrTargetARN = a })
ccscsivrVolumeARN :: Lens' CreateCachediSCSIVolumeResponse (Maybe Text)
ccscsivrVolumeARN =
lens _ccscsivrVolumeARN (\s a -> s { _ccscsivrVolumeARN = a })
instance ToPath CreateCachediSCSIVolume where
toPath = const "/"
instance ToQuery CreateCachediSCSIVolume where
toQuery = const mempty
instance ToHeaders CreateCachediSCSIVolume
instance ToJSON CreateCachediSCSIVolume where
toJSON CreateCachediSCSIVolume{..} = object
[ "GatewayARN" .= _ccscsivGatewayARN
, "VolumeSizeInBytes" .= _ccscsivVolumeSizeInBytes
, "SnapshotId" .= _ccscsivSnapshotId
, "TargetName" .= _ccscsivTargetName
, "NetworkInterfaceId" .= _ccscsivNetworkInterfaceId
, "ClientToken" .= _ccscsivClientToken
]
instance AWSRequest CreateCachediSCSIVolume where
type Sv CreateCachediSCSIVolume = StorageGateway
type Rs CreateCachediSCSIVolume = CreateCachediSCSIVolumeResponse
request = post "CreateCachediSCSIVolume"
response = jsonResponse
instance FromJSON CreateCachediSCSIVolumeResponse where
parseJSON = withObject "CreateCachediSCSIVolumeResponse" $ \o -> CreateCachediSCSIVolumeResponse
<$> o .:? "TargetARN"
<*> o .:? "VolumeARN"