AWS AWSEC2 documentation change
Summary
Clarified OS command behavior for instance shutdown and restructured CLI instructions
Security assessment
Operational guidance about proper shutdown methods without evidence of addressing a specific security vulnerability. Warning about 'halt' command prevents operational errors rather than security flaws.
Diff
diff --git a/AWSEC2/latest/UserGuide/Stop_Start.md b/AWSEC2/latest/UserGuide/Stop_Start.md index aef32c186..68d482d24 100644 --- a//AWSEC2/latest/UserGuide/Stop_Start.md +++ b//AWSEC2/latest/UserGuide/Stop_Start.md @@ -43,0 +44,4 @@ When you stop an instance, the data on any instance store volumes is erased. Bef +[Linux instances] Using the OS **halt** command from an instance does not initiate a shutdown. If you use the **halt** command, the instance does not terminate; instead, it places the CPU into `HLT`, which suspends CPU operation. The instance remains running. + +You can initiate a shutdown using the OS **shutdown** or **poweroff** commands. When you use an OS command, the instance stops by default. You can change this behavior. For more information, see [Change the instance initiated shutdown behavior](./Using_ChangingInstanceInitiatedShutdownBehavior.html). + @@ -68,4 +72 @@ Console -Command line - - -###### Prerequisites +AWS CLI @@ -73 +73,0 @@ Command line -Verify that the root device of the instance is an EBS volume. For example, run the [describe-instances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-instances.html) AWS CLI command and verify that `RootDeviceType` is `ebs`, not `instance-store`. @@ -75,5 +75 @@ Verify that the root device of the instance is an EBS volume. For example, run t -###### To stop and start an Amazon EBS-backed instance - -Use one of the following commands: - - * **AWS CLI** —[stop-instances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/stop-instances.html) and [start-instances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/start-instances.html). +###### To stop and start an instance @@ -81 +77 @@ Use one of the following commands: - * **AWS Tools for PowerShell** —[Stop-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/Stop-EC2Instance.html) and [Start-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/Start-EC2Instance.html). +Use the [stop-instances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/stop-instances.html) and [start-instances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/start-instances.html) commands. @@ -83 +79 @@ Use one of the following commands: - * **OS commands** —You can initiate a shutdown using the **shutdown** or **poweroff** commands. When you use an OS command, the instance stops by default. You can change this behavior so that it terminates instead. For more information, see [Change the instance initiated shutdown behavior](./Using_ChangingInstanceInitiatedShutdownBehavior.html). +PowerShell @@ -85,0 +82 @@ Use one of the following commands: +###### To stop and start an instance @@ -87,2 +84 @@ Use one of the following commands: - -[Linux instances] Using the OS **halt** command from an instance does not initiate a shutdown. If you use the **halt** command, the instance does not terminate; instead, it places the CPU into `HLT`, which suspends CPU operation. The instance remains running. +Use the [Stop-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/Stop-EC2Instance.html) and [Start-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/Start-EC2Instance.html) cmdlets.