Safe Haskell | None |
---|---|
Language | Haskell2010 |
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
- data CreateVolume
- createVolume :: Text -> CreateVolume
- cv1AvailabilityZone :: Lens' CreateVolume Text
- cv1DryRun :: Lens' CreateVolume (Maybe Bool)
- cv1Encrypted :: Lens' CreateVolume (Maybe Bool)
- cv1Iops :: Lens' CreateVolume (Maybe Int)
- cv1KmsKeyId :: Lens' CreateVolume (Maybe Text)
- cv1Size :: Lens' CreateVolume (Maybe Int)
- cv1SnapshotId :: Lens' CreateVolume (Maybe Text)
- cv1VolumeType :: Lens' CreateVolume (Maybe VolumeType)
- data CreateVolumeResponse
- createVolumeResponse :: Text -> Int -> Text -> Text -> VolumeState -> UTCTime -> VolumeType -> Bool -> CreateVolumeResponse
- cvrAttachments :: Lens' CreateVolumeResponse [VolumeAttachment]
- cvrAvailabilityZone :: Lens' CreateVolumeResponse Text
- cvrCreateTime :: Lens' CreateVolumeResponse UTCTime
- cvrEncrypted :: Lens' CreateVolumeResponse Bool
- cvrIops :: Lens' CreateVolumeResponse (Maybe Int)
- cvrKmsKeyId :: Lens' CreateVolumeResponse (Maybe Text)
- cvrSize :: Lens' CreateVolumeResponse Int
- cvrSnapshotId :: Lens' CreateVolumeResponse Text
- cvrState :: Lens' CreateVolumeResponse VolumeState
- cvrTags :: Lens' CreateVolumeResponse [Tag]
- cvrVolumeId :: Lens' CreateVolumeResponse Text
- cvrVolumeType :: Lens' CreateVolumeResponse VolumeType
Request
data CreateVolume Source
Request constructor
CreateVolume
constructor.
The fields accessible through corresponding lenses are:
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
:: Text | |
-> Int | |
-> Text | |
-> Text | |
-> VolumeState | |
-> UTCTime | |
-> VolumeType | |
-> Bool | |
-> CreateVolumeResponse |
CreateVolumeResponse
constructor.
The fields accessible through corresponding lenses are:
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.
cvrState :: Lens' CreateVolumeResponse VolumeState Source
The volume state.
cvrTags :: Lens' CreateVolumeResponse [Tag] Source
Any tags assigned to the volume.
cvrVolumeId :: Lens' CreateVolumeResponse Text Source
The ID of 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.