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