Network.AWS.EC2.CreateVolume

Creates an Amazon EBS volume that can be attached to an instance in the same Availability Zone. The volume is created in the specified region. 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 Amazon Elastic Compute Cloud User Guide. For more information, see Creating or Restoring an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

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

Request

data CreateVolume

Instances

Eq CreateVolume

Ord CreateVolume

Show CreateVolume

AWSRequest CreateVolume

ToQuery CreateVolume

ToHeaders CreateVolume

ToPath CreateVolume

type Rs CreateVolume = CreateVolumeResponse

type Sv CreateVolume = EC2

Request constructor

createVolume

Arguments

:: Text

cv1AvailabilityZone

-> CreateVolume

CreateVolume constructor.

The fields accessible through corresponding lenses are:

• cv1AvailabilityZone :: Text
• cv1DryRun :: Maybe Bool
• cv1Encrypted :: Maybe Bool
• cv1Iops :: Maybe Int
• cv1Size :: Maybe Int
• cv1SnapshotId :: Maybe Text
• cv1VolumeType :: Maybe Text

Request lenses

cv1AvailabilityZone :: Lens' CreateVolume Text

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

cv1DryRun :: Lens' CreateVolume (Maybe Bool)

cv1Encrypted :: Lens' CreateVolume (Maybe Bool)

Specifies whether the volume should be encrypted.

cv1Iops :: Lens' CreateVolume (Maybe Int)

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

cv1Size :: Lens' CreateVolume (Maybe Int)

The size of the volume, in GiBs. Constraints: If the volume type is io1, the minimum size of the volume is 10 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)

The snapshot from which to create the volume.

cv1VolumeType :: Lens' CreateVolume (Maybe Text)

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

data CreateVolumeResponse

Instances

Eq CreateVolumeResponse

Show CreateVolumeResponse

FromXML CreateVolumeResponse

Response constructor

createVolumeResponse :: CreateVolumeResponse

CreateVolumeResponse constructor.

The fields accessible through corresponding lenses are:

• cvrAttachments :: [VolumeAttachment]
• cvrAvailabilityZone :: Maybe Text
• cvrCreateTime :: Maybe UTCTime
• cvrEncrypted :: Maybe Bool
• cvrIops :: Maybe Int
• cvrSize :: Maybe Int
• cvrSnapshotId :: Maybe Text
• cvrState :: Maybe Text
• cvrTags :: [Tag]
• cvrVolumeId :: Maybe Text
• cvrVolumeType :: Maybe Text

Response lenses

cvrAttachments :: Lens' CreateVolumeResponse [VolumeAttachment]

cvrAvailabilityZone :: Lens' CreateVolumeResponse (Maybe Text)

The Availability Zone for the volume.

cvrCreateTime :: Lens' CreateVolumeResponse (Maybe UTCTime)

The time stamp when volume creation was initiated.

cvrEncrypted :: Lens' CreateVolumeResponse (Maybe Bool)

Indicates whether the volume is encrypted.

cvrIops :: Lens' CreateVolumeResponse (Maybe Int)

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, I/O credits, and bursting, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide. 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.

cvrSize :: Lens' CreateVolumeResponse (Maybe Int)

The size of the volume, in GiBs.

cvrSnapshotId :: Lens' CreateVolumeResponse (Maybe Text)

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

cvrState :: Lens' CreateVolumeResponse (Maybe Text)

The volume state.

cvrTags :: Lens' CreateVolumeResponse [Tag]

Any tags assigned to the volume.

cvrVolumeId :: Lens' CreateVolumeResponse (Maybe Text)

The ID of the volume.

cvrVolumeType :: Lens' CreateVolumeResponse (Maybe Text)

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