AWS cli medium security documentation change
Summary
Added --skip-os-shutdown parameter documentation with data integrity warnings, updated instance lifecycle references
Security assessment
The change adds a --skip-os-shutdown parameter for termination operations with similar data integrity warnings as in stop-instances.md. While termination is destructive by nature, the explicit documentation of risks associated with bypassing OS shutdown processes constitutes security-relevant guidance about potential data corruption risks.
Diff
diff --git a/cli/latest/reference/ec2/terminate-instances.md b/cli/latest/reference/ec2/terminate-instances.md index fdfb6dc21..e4c33e58c 100644 --- a//cli/latest/reference/ec2/terminate-instances.md +++ b//cli/latest/reference/ec2/terminate-instances.md @@ -15 +15 @@ - * [AWS CLI 2.27.56 Command Reference](../../index.html) » + * [AWS CLI 2.27.59 Command Reference](../../index.html) » @@ -91 +91 @@ By default, Amazon EC2 deletes all EBS volumes that were attached when the insta -You can stop, start, and terminate EBS-backed instances. You can only terminate instance store-backed instances. What happens to an instance differs if you stop or terminate it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, any attached EBS volumes with the `DeleteOnTermination` block device mapping parameter set to `true` are automatically deleted. For more information about the differences between stopping and terminating instances, see [Instance lifecycle](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-lifecycle.html) in the _Amazon EC2 User Guide_ . +By default, the TerminateInstances operation includes a graceful operating system (OS) shutdown. To bypass the graceful shutdown, use the `skipOsShutdown` parameter; however, this might risk data integrity. @@ -93 +93,3 @@ You can stop, start, and terminate EBS-backed instances. You can only terminate -For more information about troubleshooting, see [Troubleshooting terminating your instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/TroubleshootingInstancesShuttingDown.html) in the _Amazon EC2 User Guide_ . +You can stop, start, and terminate EBS-backed instances. You can only terminate instance store-backed instances. What happens to an instance differs if you stop or terminate it. For example, when you stop an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, any attached EBS volumes with the `DeleteOnTermination` block device mapping parameter set to `true` are automatically deleted. For more information about the differences between stopping and terminating instances, see [Amazon EC2 instance state changes](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-lifecycle.html) in the _Amazon EC2 User Guide_ . + +When you terminate an instance, we attempt to terminate it forcibly after a short while. If your instance appears stuck in the shutting-down state after a period of time, there might be an issue with the underlying host computer. For more information about terminating and troubleshooting terminating your instances, see [Terminate Amazon EC2 instances](https://docs.aws.amazon.com/) and [Troubleshooting terminating your instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/TroubleshootingInstancesShuttingDown.html) in the _Amazon EC2 User Guide_ . @@ -101,0 +104 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/ec2-20 + [--skip-os-shutdown | --no-skip-os-shutdown] @@ -140,0 +144,6 @@ Syntax: +`--skip-os-shutdown` | `--no-skip-os-shutdown` (boolean) + +> Specifies whether to bypass the graceful OS shutdown process when the instance is terminated. +> +> Default: `false` + @@ -364 +373 @@ TerminatingInstances -> (list) - * [AWS CLI 2.27.56 Command Reference](../../index.html) » + * [AWS CLI 2.27.59 Command Reference](../../index.html) »