class Aws::StorageGateway::Types::CreateCachediSCSIVolumeInput

@note When making an API call, you may pass CreateCachediSCSIVolumeInput

data as a hash:

    {
      gateway_arn: "GatewayARN", # required
      volume_size_in_bytes: 1, # required
      snapshot_id: "SnapshotId",
      target_name: "TargetName", # required
      source_volume_arn: "VolumeARN",
      network_interface_id: "NetworkInterfaceId", # required
      client_token: "ClientToken", # required
      kms_encrypted: false,
      kms_key: "KMSKey",
      tags: [
        {
          key: "TagKey", # required
          value: "TagValue", # required
        },
      ],
    }

@!attribute [rw] gateway_arn

The Amazon Resource Name (ARN) of the gateway. Use the ListGateways
operation to return a list of gateways for your account and Region.
@return [String]

@!attribute [rw] volume_size_in_bytes

The size of the volume in bytes.
@return [Integer]

@!attribute [rw] snapshot_id

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][1] in the *Amazon Elastic Compute Cloud API
Reference*.

[1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-DescribeSnapshots.html
@return [String]

@!attribute [rw] target_name

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.
@return [String]

@!attribute [rw] source_volume_arn

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.
@return [String]

@!attribute [rw] network_interface_id

The network interface of the gateway on which to expose the iSCSI
target. Only IPv4 addresses are accepted. Use
DescribeGatewayInformation to get a list of the network interfaces
available on a gateway.

Valid Values: A valid IP address.
@return [String]

@!attribute [rw] client_token

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.
@return [String]

@!attribute [rw] kms_encrypted

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`
@return [Boolean]

@!attribute [rw] kms_key

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.
@return [String]

@!attribute [rw] tags

A list of up to 50 tags that you can assign to a cached volume. Each
tag is a key-value pair.

<note markdown="1"> 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.

 </note>
@return [Array<Types::Tag>]

@see docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateCachediSCSIVolumeInput AWS API Documentation

Constants

SENSITIVE