AWS AWSEC2 documentation change
Summary
Reorganized content structure, moved operating system references and Systems Manager information to 'Related resources' section. Added structured CLI/PowerShell examples with ownership filtering and AMI type specifications.
Security assessment
Changes focus on documentation reorganization and adding operational examples for AMI discovery. No evidence of addressing security vulnerabilities or introducing new security features. The ownership filtering examples demonstrate standard AMI selection practices rather than security remediation.
Diff
diff --git a/AWSEC2/latest/UserGuide/finding-an-ami.md b/AWSEC2/latest/UserGuide/finding-an-ami.md index 18b107fc0..a9d0be068 100644 --- a//AWSEC2/latest/UserGuide/finding-an-ami.md +++ b//AWSEC2/latest/UserGuide/finding-an-ami.md @@ -26,24 +25,0 @@ When selecting an AMI, consider the following requirements you might have for th -For more information about AMIs for a specific operating system, see the following: - - * Amazon Linux 2023 – [AL2023 on Amazon EC2](https://docs.aws.amazon.com/linux/al2023/ug/ec2.html) in the _Amazon Linux 2023 User Guide_ - - * Ubuntu – [Amazon EC2 AMI Locator](https://cloud-images.ubuntu.com/locator/ec2/) on the _Canonical Ubuntu website_ - - * RHEL – [Red Hat Enterprise Linux Images (AMI) Available on Amazon Web Services (AWS)](https://access.redhat.com/solutions/15356) on the Red Hat website - - * Windows Server – [AWS Windows AMI reference](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/windows-amis.html) - - - - -For information about AMIs that you can subscribe to on the AWS Marketplace see [Paid AMIs in the AWS Marketplace for Amazon EC2 instances](./paid-amis.html). - -For information about using Systems Manager to help your users find the latest AMI that they should use when launching an instance, see the following: - - * [Reference AMIs using Systems Manager parameters](./using-systems-manager-parameter-to-find-AMI.html) - - * [Reference the latest AMIs using Systems Manager public parameters](./finding-an-ami-parameter-store.html) - - - - @@ -92 +68,3 @@ AWS CLI -You can use the [describe-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-images.html) command to list only the AMIs that match your requirements. After locating an AMI that matches your requirements, make note of its ID so that you can use it to launch instances. For more information, see [Launch your instance](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-ec2-instances.html) in the _AWS Command Line Interface User Guide_. +Use the [describe-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-images.html) command to find an AMI that meets your requirements. By default, this command returns all AMIs that are public, that you own, and that are shared with you. + +###### To find an AMI owned by Amazon @@ -94 +72 @@ You can use the [describe-images](https://awscli.amazonaws.com/v2/documentation/ -The [describe-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-images.html) command supports filtering parameters. For example, use the `--owners` parameter to display public AMIs owned by Amazon. +Use the [describe-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-images.html) command with the `--owners` option. @@ -99 +77,3 @@ The [describe-images](https://awscli.amazonaws.com/v2/documentation/api/latest/r -You can add the following filter to the previous command to display only Windows AMIs. +###### To find a Windows AMI + +Add the following filter to display only Windows AMIs. @@ -104 +84,3 @@ You can add the following filter to the previous command to display only Windows -You can add the following filter to the previous command to display only AMIs backed by Amazon EBS. +###### To find an EBS-backed AMI + +Add the following filter to display only AMIs backed by Amazon EBS. @@ -109 +91 @@ You can add the following filter to the previous command to display only AMIs ba -###### Important +PowerShell @@ -111 +92,0 @@ You can add the following filter to the previous command to display only AMIs ba -If you omit the `--owners` parameter from the `describe-images` command, all images are returned for which you have launch permissions, regardless of ownership. @@ -113 +94,40 @@ If you omit the `--owners` parameter from the `describe-images` command, all ima -PowerShell +Use the [Get-EC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2Image.html) cmdlet to find an AMI that meets your requirements. By default, this cmdlet returns all AMIs that are public, that you own, or that are shared with you. + +###### To find an AMI owned by Amazon + +Use the [Get-EC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2Image.html) command with the `-Owner` parameter. + + + Get-EC2Image -Owner amazon + +###### To find a Windows AMI + +Add the following filter to display only Windows AMIs. + + + -Filter @{Name="platform"; Values="windows"} + +For additional examples, see [Find an Amazon Machine Image Using Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-ec2-get-amis.html) in the _AWS Tools for Windows PowerShell User Guide_. + +###### Related resources + +For more information about AMIs for a specific operating system, see the following: + + * Amazon Linux 2023 – [AL2023 on Amazon EC2](https://docs.aws.amazon.com/linux/al2023/ug/ec2.html) in the _Amazon Linux 2023 User Guide_ + + * Ubuntu – [Amazon EC2 AMI Locator](https://cloud-images.ubuntu.com/locator/ec2/) on the _Canonical Ubuntu website_ + + * RHEL – [Red Hat Enterprise Linux Images (AMI) Available on Amazon Web Services (AWS)](https://access.redhat.com/solutions/15356) on the Red Hat website + + * Windows Server – [AWS Windows AMI reference](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/windows-amis.html) + + + + +For information about AMIs that you can subscribe to on the AWS Marketplace see [Paid AMIs in the AWS Marketplace for Amazon EC2 instances](./paid-amis.html). + +For information about using Systems Manager to help your users find the latest AMI that they should use when launching an instance, see the following: + + * [Reference AMIs using Systems Manager parameters](./using-systems-manager-parameter-to-find-AMI.html) + + * [Reference the latest AMIs using Systems Manager public parameters](./finding-an-ami-parameter-store.html) @@ -116 +135,0 @@ PowerShell -You can use PowerShell cmdlets to list only the Windows AMIs that match your requirements. For information and examples, see [Find an Amazon Machine Image Using Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-ec2-get-amis.html) in the _AWS Tools for Windows PowerShell User Guide_. @@ -118 +136,0 @@ You can use PowerShell cmdlets to list only the Windows AMIs that match your req -After locating an AMI that matches your requirements, make note of its ID so that you can use it to launch instances. For more information, see [Launch an Amazon EC2 Instance Using Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-ec2-launch.html) in the _AWS Tools for Windows PowerShell User Guide_.