AWS ebs documentation change
Summary
Restructured documentation for deleting EBS volumes with clearer console steps, added CLI/PowerShell examples for checking volume state, and reorganized deletion instructions
Security assessment
Changes focus on improving procedural clarity and adding command examples rather than addressing security vulnerabilities. While emphasizing verification of volume state before deletion helps prevent accidental data loss, this is operational guidance rather than mitigation of a security flaw.
Diff
diff --git a/ebs/latest/userguide/ebs-deleting-volume.md b/ebs/latest/userguide/ebs-deleting-volume.md index 7889f9b1b..901022ef7 100644 --- a//ebs/latest/userguide/ebs-deleting-volume.md +++ b//ebs/latest/userguide/ebs-deleting-volume.md @@ -9,2 +8,0 @@ You can delete an Amazon EBS volume that you no longer need. After deletion, its -###### Note - @@ -13 +11 @@ You can't delete a volume if it's attached to an instance. To delete a volume, y -You can check if a volume is attached to an instance. In the console, on the **Volumes** page, you can view the state of your volumes. +Console @@ -15 +12,0 @@ You can check if a volume is attached to an instance. In the console, on the **V - * If a volume is attached to an instance, it’s in the `in-use` state. @@ -17 +14 @@ You can check if a volume is attached to an instance. In the console, on the **V - * If a volume is detached from an instance, it’s in the `available` state. You can delete this volume. +###### To delete an EBS volume @@ -18,0 +16 @@ You can check if a volume is attached to an instance. In the console, on the **V + 1. Open the Amazon EC2 console at [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). @@ -19,0 +18 @@ You can check if a volume is attached to an instance. In the console, on the **V + 2. In the navigation pane, choose **Volumes**. @@ -20,0 +20 @@ You can check if a volume is attached to an instance. In the console, on the **V + 3. Select the volume. Verify that the volume is in the **Available** state. @@ -22 +22 @@ You can check if a volume is attached to an instance. In the console, on the **V -You can delete an EBS volume using one of the following methods. + 4. Choose **Actions** , **Delete volume**. @@ -24 +24 @@ You can delete an EBS volume using one of the following methods. -Console +If this option is disabled, the volume is attached to an instance and can't be deleted. @@ -25,0 +26 @@ Console + 5. When prompted for confirmation, enter `delete`, and then choose **Delete**. @@ -27 +27,0 @@ Console -###### To delete an EBS volume using the console @@ -29,3 +28,0 @@ Console - 1. Open the Amazon EC2 console at [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). - - 2. In the navigation pane, choose **Volumes**. @@ -33 +29,0 @@ Console - 3. Select the volume to delete and choose **Actions** , **Delete volume**. @@ -35 +31 @@ Console -###### Note +AWS CLI @@ -37 +32,0 @@ Console -If **Delete volume** is greyed out, the volume is attached to an instance. You must detach the volume from the instance before it can be deleted. @@ -39 +34 @@ If **Delete volume** is greyed out, the volume is attached to an instance. You m - 4. In the confirmation dialog box, choose **Delete**. +###### To check whether an EBS volume is in use @@ -40,0 +36 @@ If **Delete volume** is greyed out, the volume is attached to an instance. You m +Use the [describe-volumes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-volumes.html) command. If the volume is in use, the state is `in-use`. Otherwise, it is `available`. @@ -42,0 +39,4 @@ If **Delete volume** is greyed out, the volume is attached to an instance. You m + aws ec2 describe-volumes \ + --volume-id vol-01234567890abcdef \ + --query Volumes[*].State \ + --output text @@ -44 +44 @@ If **Delete volume** is greyed out, the volume is attached to an instance. You m -AWS CLI +###### To delete an EBS volume @@ -45,0 +46 @@ AWS CLI +Use the [delete-volume](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-volume.html) command. @@ -47 +47,0 @@ AWS CLI -###### To delete an EBS volume using the AWS CLI @@ -49 +49 @@ AWS CLI -Use the [delete-volume](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/delete-volume.html) command. + aws ec2 delete-volume --volume-id vol-01234567890abcdef @@ -54 +54,12 @@ PowerShell -###### To delete an EBS volume using the Tools for Windows PowerShell +###### To check whether an EBS volume is in use + +Use the [Get-EC2Volume](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2Volume.html) cmdlet. If the volume is in use, the state is `in-use`. Otherwise, it is `available`. + + + (Get-EC2Volume ` + -VolumeId vol-01234567890abcdef).State.Value + +###### To delete an EBS volume + +Use the [Remove-EC2Volume](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2Volume.html) cmdlet. + @@ -56 +67 @@ PowerShell -Use the [Remove-EC2Volume](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2Volume.html) command. + Remove-EC2Volume -VolumeId vol-01234567890abcdef