storagegateway_create_cachedi_scsi_volume: Creates a cached volume on a specified cached volume gateway
In paws.storage: 'Amazon Web Services' Storage Services

View source: R/storagegateway_operations.R

storagegateway_create_cachedi_scsi_volume

R Documentation

Creates a cached volume on a specified cached volume gateway

Description

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

See https://www.paws-r-sdk.com/docs/storagegateway_create_cachedi_scsi_volume/ for full documentation.

Usage

storagegateway_create_cachedi_scsi_volume(
  GatewayARN,
  VolumeSizeInBytes,
  SnapshotId = NULL,
  TargetName,
  SourceVolumeARN = NULL,
  NetworkInterfaceId,
  ClientToken,
  KMSEncrypted = NULL,
  KMSKey = NULL,
  Tags = NULL
)

Arguments

`GatewayARN`	[required]
`VolumeSizeInBytes`	[required] The size of the volume in bytes.
`SnapshotId`	The snapshot ID (e.g. "snap-1122aabb") of the snapshot to restore as the new cached volume. Specify this field if you want to create the iSCSI storage volume from a snapshot; otherwise, do not include this field. To list snapshots for your account use DescribeSnapshots in the Amazon Elastic Compute Cloud API Reference.
`TargetName`	[required] The name of the iSCSI target used by an initiator to connect to a volume and used as a suffix for the target ARN. For example, specifying `TargetName` as myvolume results in the target ARN of `⁠arn:aws:storagegateway:us-east-2:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume⁠`. The target name must be unique across all volumes on a gateway. If you don't specify a value, Storage Gateway uses the value that was previously used for this volume as the new target name.
`SourceVolumeARN`	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.
`NetworkInterfaceId`	[required] The network interface of the gateway on which to expose the iSCSI target. Only IPv4 addresses are accepted. Use `describe_gateway_information` to get a list of the network interfaces available on a gateway. Valid Values: A valid IP address.
`ClientToken`	[required] A unique identifier that you use to retry a request. If you retry a request, use the same `ClientToken` you specified in the initial request.
`KMSEncrypted`	Set to `true` to use Amazon S3 server-side encryption with your own KMS key, or `false` to use a key managed by Amazon S3. Optional. Valid Values: `true` \| `false`
`KMSKey`	The Amazon Resource Name (ARN) of a symmetric customer master key (CMK) used for Amazon S3 server-side encryption. Storage Gateway does not support asymmetric CMKs. This value can only be set when `KMSEncrypted` is `true`. Optional.
`Tags`	A list of up to 50 tags that you can assign to a cached volume. Each tag is a key-value pair. Valid characters for key and value are letters, spaces, and numbers that you can represent in UTF-8 format, and the following special characters: + - = . _ : / @. The maximum length of a tag's key is 128 characters, and the maximum length for a tag's value is 256 characters.