Network.AWS.EC2.DetachVolume

Detaches an EBS volume from an instance. Make sure to unmount any file systems on the device within your operating system before detaching the volume. Failure to do so can result in the volume becoming stuck in the busy state while detaching. If this happens, detachment can be delayed indefinitely until you unmount the volume, force detachment, reboot the instance, or all three. If an EBS volume is the root device of an instance, it can't be detached while the instance is running. To detach the root volume, stop the instance first.

When a volume with an AWS Marketplace product code is detached from an instance, the product code is no longer associated with the instance.

For more information, see Detaching an Amazon EBS Volume in the Amazon Elastic Compute Cloud User Guide.

Creating a Request

detachVolume

Arguments

:: Text

dvVolumeId

-> DetachVolume

Creates a value of DetachVolume with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• dvInstanceId
• dvForce
• dvDevice
• dvDryRun
• dvVolumeId

data DetachVolume

Contains the parameters for DetachVolume.

See: detachVolume smart constructor.

Instances

Eq DetachVolume

Methods

(==) :: DetachVolume -> DetachVolume -> Bool

(/=) :: DetachVolume -> DetachVolume -> Bool

Data DetachVolume

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> DetachVolume -> c DetachVolume

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c DetachVolume

toConstr :: DetachVolume -> Constr

dataTypeOf :: DetachVolume -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c DetachVolume)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c DetachVolume)

gmapT :: (forall b. Data b => b -> b) -> DetachVolume -> DetachVolume

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> DetachVolume -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> DetachVolume -> r

gmapQ :: (forall d. Data d => d -> u) -> DetachVolume -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> DetachVolume -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> DetachVolume -> m DetachVolume

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> DetachVolume -> m DetachVolume

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> DetachVolume -> m DetachVolume

Read DetachVolume

Methods

readsPrec :: Int -> ReadS DetachVolume

readList :: ReadS [DetachVolume]

readPrec :: ReadPrec DetachVolume

readListPrec :: ReadPrec [DetachVolume]

Show DetachVolume

Methods

showsPrec :: Int -> DetachVolume -> ShowS

show :: DetachVolume -> String

showList :: [DetachVolume] -> ShowS

Generic DetachVolume

Associated Types

type Rep DetachVolume :: * -> *

Methods

from :: DetachVolume -> Rep DetachVolume x

to :: Rep DetachVolume x -> DetachVolume

Hashable DetachVolume

Methods

hashWithSalt :: Int -> DetachVolume -> Int

hash :: DetachVolume -> Int

NFData DetachVolume

Methods

rnf :: DetachVolume -> ()

AWSRequest DetachVolume

Associated Types

type Rs DetachVolume :: *

Methods

request :: DetachVolume -> Request DetachVolume

response :: MonadResource m => Logger -> Service -> Proxy * DetachVolume -> ClientResponse -> m (Response DetachVolume)

ToPath DetachVolume

Methods

toPath :: DetachVolume -> ByteString

ToHeaders DetachVolume

Methods

toHeaders :: DetachVolume -> [Header]

ToQuery DetachVolume

Methods

toQuery :: DetachVolume -> QueryString

type Rep DetachVolume

type Rep DetachVolume = D1 (MetaData "DetachVolume" "Network.AWS.EC2.DetachVolume" "amazonka-ec2-1.4.4-4aYNmHv73MpJXVQjlVKYjQ" False) (C1 (MetaCons "DetachVolume'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_dvInstanceId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_dvForce") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool)))) ((:*:) (S1 (MetaSel (Just Symbol "_dvDevice") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_dvDryRun") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool))) (S1 (MetaSel (Just Symbol "_dvVolumeId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text))))))

type Rs DetachVolume

type Rs DetachVolume = VolumeAttachment

Request Lenses

dvInstanceId :: Lens' DetachVolume (Maybe Text)

The ID of the instance.

dvForce :: Lens' DetachVolume (Maybe Bool)

Forces detachment if the previous detachment attempt did not occur cleanly (for example, logging into an instance, unmounting the volume, and detaching normally). This option can lead to data loss or a corrupted file system. Use this option only as a last resort to detach a volume from a failed instance. The instance won't have an opportunity to flush file system caches or file system metadata. If you use this option, you must perform file system check and repair procedures.

dvDevice :: Lens' DetachVolume (Maybe Text)

The device name.

dvDryRun :: Lens' DetachVolume (Maybe Bool)

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

dvVolumeId :: Lens' DetachVolume Text

The ID of the volume.

Destructuring the Response

volumeAttachment :: VolumeAttachment

Creates a value of VolumeAttachment with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• volInstanceId
• volDeleteOnTermination
• volState
• volDevice
• volVolumeId
• volAttachTime

data VolumeAttachment

Describes volume attachment details.

See: volumeAttachment smart constructor.

Instances

Eq VolumeAttachment

Methods

(==) :: VolumeAttachment -> VolumeAttachment -> Bool

(/=) :: VolumeAttachment -> VolumeAttachment -> Bool

Data VolumeAttachment

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> VolumeAttachment -> c VolumeAttachment

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c VolumeAttachment

toConstr :: VolumeAttachment -> Constr

dataTypeOf :: VolumeAttachment -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c VolumeAttachment)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c VolumeAttachment)

gmapT :: (forall b. Data b => b -> b) -> VolumeAttachment -> VolumeAttachment

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> VolumeAttachment -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> VolumeAttachment -> r

gmapQ :: (forall d. Data d => d -> u) -> VolumeAttachment -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> VolumeAttachment -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> VolumeAttachment -> m VolumeAttachment

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> VolumeAttachment -> m VolumeAttachment

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> VolumeAttachment -> m VolumeAttachment

Read VolumeAttachment

Methods

readsPrec :: Int -> ReadS VolumeAttachment

readList :: ReadS [VolumeAttachment]

readPrec :: ReadPrec VolumeAttachment

readListPrec :: ReadPrec [VolumeAttachment]

Show VolumeAttachment

Methods

showsPrec :: Int -> VolumeAttachment -> ShowS

show :: VolumeAttachment -> String

showList :: [VolumeAttachment] -> ShowS

Generic VolumeAttachment

Associated Types

type Rep VolumeAttachment :: * -> *

Methods

from :: VolumeAttachment -> Rep VolumeAttachment x

to :: Rep VolumeAttachment x -> VolumeAttachment

Hashable VolumeAttachment

Methods

hashWithSalt :: Int -> VolumeAttachment -> Int

hash :: VolumeAttachment -> Int

NFData VolumeAttachment

Methods

rnf :: VolumeAttachment -> ()

FromXML VolumeAttachment

Methods

parseXML :: [Node] -> Either String VolumeAttachment

type Rep VolumeAttachment

type Rep VolumeAttachment = D1 (MetaData "VolumeAttachment" "Network.AWS.EC2.Types.Product" "amazonka-ec2-1.4.4-4aYNmHv73MpJXVQjlVKYjQ" False) (C1 (MetaCons "VolumeAttachment'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_volInstanceId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_volDeleteOnTermination") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool))) (S1 (MetaSel (Just Symbol "_volState") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe VolumeAttachmentState))))) ((:*:) (S1 (MetaSel (Just Symbol "_volDevice") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_volVolumeId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_volAttachTime") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe ISO8601)))))))

Response Lenses

volInstanceId :: Lens' VolumeAttachment (Maybe Text)

The ID of the instance.

volDeleteOnTermination :: Lens' VolumeAttachment (Maybe Bool)

Indicates whether the EBS volume is deleted on instance termination.

volState :: Lens' VolumeAttachment (Maybe VolumeAttachmentState)

The attachment state of the volume.

volDevice :: Lens' VolumeAttachment (Maybe Text)

The device name.

volVolumeId :: Lens' VolumeAttachment (Maybe Text)

The ID of the volume.

volAttachTime :: Lens' VolumeAttachment (Maybe UTCTime)

The time stamp when the attachment initiated.