AWS cli medium security documentation change
Summary
Added --skip-os-shutdown parameter documentation with data integrity warnings, updated CLI version references
Security assessment
The change introduces a new --skip-os-shutdown parameter with explicit warnings about data loss/corruption risks. This directly relates to security implications of improper shutdown procedures affecting data integrity. The documentation explicitly states 'might risk data integrity' and warns about memory contents not being flushed.
Diff
diff --git a/cli/latest/reference/ec2/stop-instances.md b/cli/latest/reference/ec2/stop-instances.md index d4445a11e..a274d2432 100644 --- a//cli/latest/reference/ec2/stop-instances.md +++ b//cli/latest/reference/ec2/stop-instances.md @@ -15 +15 @@ - * [AWS CLI 2.27.56 Command Reference](../../index.html) » + * [AWS CLI 2.27.59 Command Reference](../../index.html) » @@ -62 +62 @@ Stops an Amazon EBS-backed instance. You can restart your instance at any time u -When you stop an instance, we shut it down. +When you stop or hibernate an instance, we shut it down. By default, this includes a graceful operating system (OS) shutdown. To bypass the graceful shutdown, use the `skipOsShutdown` parameter; however, this might risk data integrity. @@ -64 +64 @@ When you stop an instance, we shut it down. -You can use the Stop operation together with the Hibernate parameter to hibernate an instance if the instance is [enabled for hibernation](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/enabling-hibernation.html) and meets the [hibernation prerequisites](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hibernating-prerequisites.html) . Stopping an instance doesn’t preserve data stored in RAM, while hibernation does. If hibernation fails, a normal shutdown occurs. For more information, see [Hibernate your Amazon EC2 instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html) in the _Amazon EC2 User Guide_ . +You can use the StopInstances operation together with the `Hibernate` parameter to hibernate an instance if the instance is [enabled for hibernation](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/enabling-hibernation.html) and meets the [hibernation prerequisites](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hibernating-prerequisites.html) . Stopping an instance doesn’t preserve data stored in RAM, while hibernation does. If hibernation fails, a normal shutdown occurs. For more information, see [Hibernate your Amazon EC2 instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html) in the _Amazon EC2 User Guide_ . @@ -66 +66 @@ You can use the Stop operation together with the Hibernate parameter to hibernat -If your instance appears stuck in the `stopping` state, there might be an issue with the underlying host computer. You can use the Stop operation together with the Force parameter to force stop your instance. For more information, see [Troubleshoot Amazon EC2 instance stop issues](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/TroubleshootingInstancesStopping.html) in the _Amazon EC2 User Guide_ . +If your instance appears stuck in the `stopping` state, there might be an issue with the underlying host computer. You can use the StopInstances operation together with the Force parameter to force stop your instance. For more information, see [Troubleshoot Amazon EC2 instance stop issues](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/TroubleshootingInstancesStopping.html) in the _Amazon EC2 User Guide_ . @@ -81,0 +82 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/ec2-20 + [--skip-os-shutdown | --no-skip-os-shutdown] @@ -122 +123,11 @@ Syntax: -> Hibernates the instance if the instance was enabled for hibernation at launch. If the instance cannot hibernate successfully, a normal shutdown occurs. For more information, see [Hibernate your instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html) in the _Amazon EC2 User Guide_ . +> Hibernates the instance if the instance was enabled for hibernation at launch. If the instance cannot hibernate successfully, a normal shutdown occurs. For more information, see [Hibernate your Amazon EC2 instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html) in the _Amazon EC2 User Guide_ . +> +> Default: `false` + +`--skip-os-shutdown` | `--no-skip-os-shutdown` (boolean) + +> Specifies whether to bypass the graceful OS shutdown process when the instance is stopped. +> +> ### 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. @@ -388 +399 @@ StoppingInstances -> (list) - * [AWS CLI 2.27.56 Command Reference](../../index.html) » + * [AWS CLI 2.27.59 Command Reference](../../index.html) »