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

Safe HaskellNone




Attaches an Amazon EBS volume to a running or stopped instance and exposes it to the instance with the specified device name.

Encrypted Amazon EBS volumes may only be attached to instances that support Amazon EBS encryption. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

For a list of supported device names, see Attaching an Amazon EBS Volume toan Instance. Any device names that aren't reserved for instance store volumes can be used for Amazon EBS volumes. For more information, see Amazon EC2Instance Store in the Amazon Elastic Compute Cloud User Guide.

If a volume has an AWS Marketplace product code:

The volume can only be attached as the root device of a stopped instance. You must be subscribed to the AWS Marketplace code that is on the volume. The configuration (instance type, operating system) of the instance must support that specific AWS Marketplace code. For example, you cannot take a volume from a Windows instance and attach it to a Linux instance. AWS Marketplace product codes are copied from the volume to the instance. For an overview of the AWS Marketplace, see For more information about how to use the AWS Marketplace, see AWSMarketplace.

For more information about Amazon EBS volumes, see Attaching Amazon EBSVolumes in the Amazon Elastic Compute Cloud User Guide.



Request constructor

attachVolume Source

AttachVolume constructor.

The fields accessible through corresponding lenses are:

Request lenses

avDevice :: Lens' AttachVolume Text Source

The device name to expose to the instance (for example, '/dev/sdh' or xvdh).

avInstanceId :: Lens' AttachVolume Text Source

The ID of the instance.

avVolumeId :: Lens' AttachVolume Text Source

The ID of the Amazon EBS volume. The volume and instance must be within the same Availability Zone.


Response constructor

Response lenses

avrAttachTime :: Lens' AttachVolumeResponse (Maybe UTCTime) Source

The time stamp when the attachment initiated.

avrDeleteOnTermination :: Lens' AttachVolumeResponse (Maybe Bool) Source

Indicates whether the Amazon EBS volume is deleted on instance termination.

avrState :: Lens' AttachVolumeResponse (Maybe VolumeAttachmentState) Source

The attachment state of the volume.