Network.AWS.StorageGateway.CreateCachediSCSIVolume

Creates a cached volume on a specified cached volume gateway. This operation is only supported in the cached volume gateway type.

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, the gateway creates the volume and returns information about it. This information includes the volume Amazon Resource Name (ARN), its size, and the iSCSI target ARN that initiators can use to connect to the volume target.

Optionally, you can provide the ARN for an existing volume as the SourceVolumeARN for this cached volume, which creates an exact copy of the existing volume’s latest recovery point. The VolumeSizeInBytes value must be equal to or larger than the size of the copied volume, in bytes.

Creating a Request

createCachediSCSIVolume

Arguments

:: Text

ccscsivGatewayARN

-> Integer

ccscsivVolumeSizeInBytes

-> Text

ccscsivTargetName

-> Text

ccscsivNetworkInterfaceId

-> Text

ccscsivClientToken

-> CreateCachediSCSIVolume

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

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

• ccscsivSourceVolumeARN - The ARN for an existing volume. Specifying this ARN makes the new volume into an exact copy of the specified existing volume's latest recovery point. The VolumeSizeInBytes value for this new volume must be equal to or larger than the size of the existing volume, in bytes.
• ccscsivSnapshotId - Undocumented member.
• ccscsivGatewayARN - Undocumented member.
• ccscsivVolumeSizeInBytes - Undocumented member.
• ccscsivTargetName - Undocumented member.
• ccscsivNetworkInterfaceId - Undocumented member.
• ccscsivClientToken - Undocumented member.

data CreateCachediSCSIVolume

See: createCachediSCSIVolume smart constructor.

Instances

Eq CreateCachediSCSIVolume

Methods

(==) :: CreateCachediSCSIVolume -> CreateCachediSCSIVolume -> Bool

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

Data CreateCachediSCSIVolume

Methods

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

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

toConstr :: CreateCachediSCSIVolume -> Constr

dataTypeOf :: CreateCachediSCSIVolume -> DataType

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

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

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

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

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

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

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

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

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

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

Read CreateCachediSCSIVolume

Methods

readsPrec :: Int -> ReadS CreateCachediSCSIVolume

readList :: ReadS [CreateCachediSCSIVolume]

readPrec :: ReadPrec CreateCachediSCSIVolume

readListPrec :: ReadPrec [CreateCachediSCSIVolume]

Show CreateCachediSCSIVolume

Methods

showsPrec :: Int -> CreateCachediSCSIVolume -> ShowS

show :: CreateCachediSCSIVolume -> String

showList :: [CreateCachediSCSIVolume] -> ShowS

Generic CreateCachediSCSIVolume

Associated Types

type Rep CreateCachediSCSIVolume :: * -> *

Methods

from :: CreateCachediSCSIVolume -> Rep CreateCachediSCSIVolume x

to :: Rep CreateCachediSCSIVolume x -> CreateCachediSCSIVolume

Hashable CreateCachediSCSIVolume

Methods

hashWithSalt :: Int -> CreateCachediSCSIVolume -> Int

hash :: CreateCachediSCSIVolume -> Int

ToJSON CreateCachediSCSIVolume

Methods

toJSON :: CreateCachediSCSIVolume -> Value

toEncoding :: CreateCachediSCSIVolume -> Encoding

toJSONList :: [CreateCachediSCSIVolume] -> Value

toEncodingList :: [CreateCachediSCSIVolume] -> Encoding

NFData CreateCachediSCSIVolume

Methods

rnf :: CreateCachediSCSIVolume -> ()

AWSRequest CreateCachediSCSIVolume

Associated Types

type Rs CreateCachediSCSIVolume :: *

Methods

request :: CreateCachediSCSIVolume -> Request CreateCachediSCSIVolume

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

ToHeaders CreateCachediSCSIVolume

Methods

toHeaders :: CreateCachediSCSIVolume -> [Header]

ToPath CreateCachediSCSIVolume

Methods

toPath :: CreateCachediSCSIVolume -> ByteString

ToQuery CreateCachediSCSIVolume

Methods

toQuery :: CreateCachediSCSIVolume -> QueryString

type Rep CreateCachediSCSIVolume

type Rep CreateCachediSCSIVolume = D1 * (MetaData "CreateCachediSCSIVolume" "Network.AWS.StorageGateway.CreateCachediSCSIVolume" "amazonka-storagegateway-1.6.0-4O2jykLIBNRAOy2n0S31Gg" False) (C1 * (MetaCons "CreateCachediSCSIVolume'" PrefixI True) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_ccscsivSourceVolumeARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) ((:*:) * (S1 * (MetaSel (Just Symbol "_ccscsivSnapshotId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_ccscsivGatewayARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)))) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_ccscsivVolumeSizeInBytes") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Integer)) (S1 * (MetaSel (Just Symbol "_ccscsivTargetName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text))) ((:*:) * (S1 * (MetaSel (Just Symbol "_ccscsivNetworkInterfaceId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)) (S1 * (MetaSel (Just Symbol "_ccscsivClientToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text))))))

type Rs CreateCachediSCSIVolume

type Rs CreateCachediSCSIVolume = CreateCachediSCSIVolumeResponse

Request Lenses

ccscsivSourceVolumeARN :: Lens' CreateCachediSCSIVolume (Maybe Text)

The ARN for an existing volume. Specifying this ARN makes the new volume into an exact copy of the specified existing volume's latest recovery point. The VolumeSizeInBytes value for this new volume must be equal to or larger than the size of the existing volume, in bytes.

ccscsivSnapshotId :: Lens' CreateCachediSCSIVolume (Maybe Text)

Undocumented member.

ccscsivGatewayARN :: Lens' CreateCachediSCSIVolume Text

Undocumented member.

ccscsivVolumeSizeInBytes :: Lens' CreateCachediSCSIVolume Integer

Undocumented member.

ccscsivTargetName :: Lens' CreateCachediSCSIVolume Text

Undocumented member.

ccscsivNetworkInterfaceId :: Lens' CreateCachediSCSIVolume Text

Undocumented member.

ccscsivClientToken :: Lens' CreateCachediSCSIVolume Text

Undocumented member.

Destructuring the Response

createCachediSCSIVolumeResponse

Arguments

:: Int

ccscsivrsResponseStatus

-> CreateCachediSCSIVolumeResponse

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

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

• ccscsivrsTargetARN - Undocumented member.
• ccscsivrsVolumeARN - Undocumented member.
• ccscsivrsResponseStatus - -- | The response status code.

data CreateCachediSCSIVolumeResponse

See: createCachediSCSIVolumeResponse smart constructor.

Instances

Eq CreateCachediSCSIVolumeResponse

Methods

(==) :: CreateCachediSCSIVolumeResponse -> CreateCachediSCSIVolumeResponse -> Bool

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

Data CreateCachediSCSIVolumeResponse

Methods

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

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

toConstr :: CreateCachediSCSIVolumeResponse -> Constr

dataTypeOf :: CreateCachediSCSIVolumeResponse -> DataType

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

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

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

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

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

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

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

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

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

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

Read CreateCachediSCSIVolumeResponse

Methods

readsPrec :: Int -> ReadS CreateCachediSCSIVolumeResponse

readList :: ReadS [CreateCachediSCSIVolumeResponse]

readPrec :: ReadPrec CreateCachediSCSIVolumeResponse

readListPrec :: ReadPrec [CreateCachediSCSIVolumeResponse]

Show CreateCachediSCSIVolumeResponse

Methods

showsPrec :: Int -> CreateCachediSCSIVolumeResponse -> ShowS

show :: CreateCachediSCSIVolumeResponse -> String

showList :: [CreateCachediSCSIVolumeResponse] -> ShowS

Generic CreateCachediSCSIVolumeResponse

Associated Types

type Rep CreateCachediSCSIVolumeResponse :: * -> *

Methods

from :: CreateCachediSCSIVolumeResponse -> Rep CreateCachediSCSIVolumeResponse x

to :: Rep CreateCachediSCSIVolumeResponse x -> CreateCachediSCSIVolumeResponse

NFData CreateCachediSCSIVolumeResponse

Methods

rnf :: CreateCachediSCSIVolumeResponse -> ()

type Rep CreateCachediSCSIVolumeResponse

type Rep CreateCachediSCSIVolumeResponse = D1 * (MetaData "CreateCachediSCSIVolumeResponse" "Network.AWS.StorageGateway.CreateCachediSCSIVolume" "amazonka-storagegateway-1.6.0-4O2jykLIBNRAOy2n0S31Gg" False) (C1 * (MetaCons "CreateCachediSCSIVolumeResponse'" PrefixI True) ((:*:) * (S1 * (MetaSel (Just Symbol "_ccscsivrsTargetARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) ((:*:) * (S1 * (MetaSel (Just Symbol "_ccscsivrsVolumeARN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_ccscsivrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Int)))))

Response Lenses

ccscsivrsTargetARN :: Lens' CreateCachediSCSIVolumeResponse (Maybe Text)

Undocumented member.

ccscsivrsVolumeARN :: Lens' CreateCachediSCSIVolumeResponse (Maybe Text)

Undocumented member.

ccscsivrsResponseStatus :: Lens' CreateCachediSCSIVolumeResponse Int

• - | The response status code.