AWS AWSEC2 documentation change
Summary
Added documentation about graceful OS shutdown bypass capability, warning about data risks, and restructured stop/start methods with CLI/PowerShell examples
Security assessment
The change documents a 'skip OS shutdown' feature with explicit warnings about data loss/corruption risks. While this relates to data integrity (a security-adjacent concern), there's no evidence of addressing a specific vulnerability or security incident. The documentation adds security-relevant warnings but doesn't describe a security fix.
Diff
diff --git a/AWSEC2/latest/UserGuide/Stop_Start.md b/AWSEC2/latest/UserGuide/Stop_Start.md index 9695b6df1..56bc27249 100644 --- a//AWSEC2/latest/UserGuide/Stop_Start.md +++ b//AWSEC2/latest/UserGuide/Stop_Start.md @@ -22,0 +23,2 @@ When you stop an instance, it is not deleted. If you decide that you no longer n + * [Methods for stopping an instance](./instance-stop-methods.html) + @@ -39,0 +42,2 @@ You can stop and start your Amazon EBS-backed instances (instances with EBS root +When using the default method to stop an instance, a graceful operating system (OS) shutdown is attempted. You can bypass the graceful OS shutdown; however, this might risk data integrity. + @@ -47,0 +52,19 @@ You can initiate a shutdown using the OS **shutdown** or **poweroff** commands. +###### Note + +If you stopped an Amazon EBS-backed instance and it appears "stuck" in the `stopping` state, you can forcibly stop it. For more information, see [Troubleshoot Amazon EC2 instance stop issues](./TroubleshootingInstancesStopping.html). + +###### Stop and start methods + + * Stop an instance with a graceful OS shutdown + + * Stop an instance and bypass the graceful OS shutdown + + * Start an instance + + + + +### Stop an instance with a graceful OS shutdown + +You can stop an instance using the default stop method, which includes an attempt at a graceful OS shutdown. For more information, see [Default stop](./instance-stop-methods.html#ec2-instance-default-stop). + @@ -51 +74 @@ Console -###### To stop and start an Amazon EBS-backed instance +###### To stop an instance using the default stop method @@ -61,4 +83,0 @@ Console - 5. To start a stopped instance, select the instance, and choose **Instance state** , **Start instance**. - - 6. It can take a few minutes for the instance to enter the `running` state. - @@ -71 +90 @@ AWS CLI -###### To stop an instance +###### To stop an instance using the default stop method @@ -78 +97 @@ Use the [stop-instances](https://awscli.amazonaws.com/v2/documentation/api/lates -###### To start an instance +PowerShell @@ -80 +99,30 @@ Use the [stop-instances](https://awscli.amazonaws.com/v2/documentation/api/lates -Use the [start-instances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/start-instances.html) command. + +###### To stop an instance using the default stop method + +Use the [Stop-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/Stop-EC2Instance.html) cmdlet + + + Stop-EC2Instance -InstanceId i-1234567890abcdef0 + +### Stop an instance and bypass the graceful OS shutdown + +You can bypass the graceful OS shutdown when stopping an instance. For more information, see [Stop with skip OS shutdown](./instance-stop-methods.html#ec2-instance-stop-with-skip-os-shutdown). + +###### Warning + +Bypassing the graceful OS shutdown might result in data loss or corruption (for example, memory contents not flushed to disk or loss of in-flight IOs) or skipped shutdown scripts. + +Console + + +###### To stop an instance and bypass the graceful OS shutdown + + 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 **Instances** and select the instance. + + 3. Choose **Instance state** , **Stop instance**. + + 4. Under **Skip OS shutdown** , select the **Skip OS shutdown** checkbox. If you don't see this option in the console, it's not yet available in the console in the current Region. You can, however, access this feature using the AWS CLI or SDK, or try another Region in the console. + + 5. Choose **Stop**. @@ -83 +131,13 @@ Use the [start-instances](https://awscli.amazonaws.com/v2/documentation/api/late - aws ec2 start-instances --instance-ids i-1234567890abcdef0 + + +AWS CLI + + +###### To stop an instance and bypass the graceful OS shutdown + +Use the [stop-instances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/stop-instances.html) command with `--skip-os-shutdown`. + + + aws ec2 stop-instances \ + --instance-ids i-1234567890abcdef0 \ + --skip-os-shutdown @@ -88 +148 @@ PowerShell -###### To stop an instance +###### To stop an instance and bypass the graceful OS shutdown @@ -90 +150 @@ PowerShell -Use the [Stop-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/Stop-EC2Instance.html) cmdlet. +Use the [Stop-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/Stop-EC2Instance.html) cmdlet with `-SkipOsShutdown $true`. @@ -93 +153,36 @@ Use the [Stop-EC2Instance](https://docs.aws.amazon.com/powershell/latest/referen - Stop-EC2Instance -InstanceId i-1234567890abcdef0 + Stop-EC2Instance ` + -InstanceId i-1234567890abcdef0 ` + -SkipOsShutdown $true + +### Start an instance + +You can start a stopped instance. + +Console + + +###### To start an instance + + 1. Open the Amazon EC2 console at [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). + + 2. In the left navigation pane, choose **Instances**. + + 3. Select the instance, and choose **Instance state** , **Start instance**. + +It can take a few minutes for the instance to enter the `running` state. + + + + +AWS CLI + + +###### To start an instance + +Use the [start-instances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/start-instances.html) command. + + + aws ec2 start-instances --instance-ids i-1234567890abcdef0 + +PowerShell + @@ -102,2 +196,0 @@ Use the [Start-EC2Instance](https://docs.aws.amazon.com/powershell/latest/refere -If you stopped an Amazon EBS-backed instance and it appears "stuck" in the `stopping` state, you can forcibly stop it. For more information, see [Troubleshoot Amazon EC2 instance stop issues](./TroubleshootingInstancesStopping.html). -