amazonka-ec2-0.2.1: Amazon Elastic Compute Cloud SDK.

Safe HaskellNone
LanguageHaskell2010

Network.AWS.EC2.CreateVolume

Contents

Description

Creates an Amazon EBS volume that can be attached to an instance in the same Availability Zone. The volume is created in the regional endpoint that you send the HTTP request to. For more information see Regions and Endpoints.

You can create a new empty volume or restore a volume from an Amazon EBS snapshot. Any AWS Marketplace product codes from the snapshot are propagated to the volume.

You can create encrypted volumes with the Encrypted parameter. Encrypted volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are also automatically encrypted. For more information, see Amazon EBS Encryption in the AmazonElastic Compute Cloud User Guide for Linux.

For more information, see Creating or Restoring an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide for Linux.

http://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-CreateVolume.html

Synopsis

Request

Request constructor

Request lenses

cv1AvailabilityZone :: Lens' CreateVolume Text Source

The Availability Zone in which to create the volume. Use DescribeAvailabilityZones to list the Availability Zones that are currently available to you.

cv1Encrypted :: Lens' CreateVolume (Maybe Bool) Source

Specifies whether the volume should be encrypted. Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are automatically encrypted. There is no way to create an encrypted volume from an unencrypted snapshot or vice versa. If your AMI uses encrypted volumes, you can only launch it on supported instance types. For more information, see Amazon EBSEncryption in the Amazon Elastic Compute Cloud User Guide for Linux.

cv1Iops :: Lens' CreateVolume (Maybe Int) Source

Only valid for Provisioned IOPS (SSD) volumes. The number of I/O operations per second (IOPS) to provision for the volume.

cv1KmsKeyId :: Lens' CreateVolume (Maybe Text) Source

The full ARN of the AWS Key Management Service (KMS) master key to use when creating the encrypted volume. This parameter is only required if you want to use a non-default master key; if this parameter is not specified, the default master key is used. The ARN contains the 'arn:aws:kms' namespace, followed by the region of the master key, the AWS account ID of the master key owner, the key namespace, and then the master key ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef.

cv1Size :: Lens' CreateVolume (Maybe Int) Source

The size of the volume, in GiBs.

Constraints: If the volume type is io1, the minimum size of the volume is 4 GiB.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

cv1SnapshotId :: Lens' CreateVolume (Maybe Text) Source

The snapshot from which to create the volume.

cv1VolumeType :: Lens' CreateVolume (Maybe VolumeType) Source

The volume type. This can be gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, or standard for Magnetic volumes.

Default: standard

Response

Response constructor

Response lenses

cvrAvailabilityZone :: Lens' CreateVolumeResponse Text Source

The Availability Zone for the volume.

cvrCreateTime :: Lens' CreateVolumeResponse UTCTime Source

The time stamp when volume creation was initiated.

cvrEncrypted :: Lens' CreateVolumeResponse Bool Source

Indicates whether the volume will be encrypted.

cvrIops :: Lens' CreateVolumeResponse (Maybe Int) Source

The number of I/O operations per second (IOPS) that the volume supports. For Provisioned IOPS (SSD) volumes, this represents the number of IOPS that are provisioned for the volume. For General Purpose (SSD) volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information on General Purpose (SSD) baseline performance, IO credits, and bursting, see <http:docs.aws.amazon.comAWSEC2latestUserGuideEBSVolumeTypes.html Amazon EBSVolume Types> in the Amazon Elastic Compute Cloud User Guide for Linux/.

Constraint: Range is 100 to 4000 for Provisioned IOPS (SSD) volumes and 3 to 3072 for General Purpose (SSD) volumes.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create standard or gp2 volumes.

cvrKmsKeyId :: Lens' CreateVolumeResponse (Maybe Text) Source

The full ARN of the AWS Key Management Service (KMS) master key that was used to protect the volume encryption key for the volume.

cvrSize :: Lens' CreateVolumeResponse Int Source

The size of the volume, in GiBs.

cvrSnapshotId :: Lens' CreateVolumeResponse Text Source

The snapshot from which the volume was created, if applicable.

cvrTags :: Lens' CreateVolumeResponse [Tag] Source

Any tags assigned to the volume.

cvrVolumeType :: Lens' CreateVolumeResponse VolumeType Source

The volume type. This can be gp2 for General Purpose (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, or standard for Magnetic volumes.