Retrieving Amazon EKS optimized Amazon Linux AMI IDs
You can programmatically retrieve the Amazon Machine Image (AMI) ID for Amazon EKS
optimized
AMIs by querying the AWS Systems Manager Parameter Store API. This parameter eliminates
the need for
you to manually look up Amazon EKS optimized AMI IDs. For more information about the
Systems Manager
Parameter Store API, see GetParameter. Your user account must have the ssm:GetParameter
IAM permission to retrieve the Amazon EKS optimized AMI metadata.
You can retrieve the AMI ID with the AWS CLI or the AWS Management Console.
-
AWS CLI – You can retrieve the image ID of the latest recommended Amazon EKS optimized Amazon Linux AMI with the following command by using the sub-parameter
image_id
. Replace <1.18> with a supported version and <region-code> with an Amazon EKS supported Region for which you want the AMI ID. Replace <amazon-linux-2> withamazon-linux-2-gpu
to see the accelerated AMI ID andamazon-linux-2-arm64
to see the Arm ID.aws ssm get-parameter --name /aws/service/eks/optimized-ami/<1.18>/<amazon-linux-2>/recommended/image_id --region <region-code> --query "Parameter.Value" --output text
Example output:
ami-<abcd1234efgh5678i>
-
AWS Management Console – You can query for the recommended Amazon EKS optimized AMI ID using a URL. The URL opens the Amazon EC2 Systems Manager console with the value of the ID for the parameter. In the following URL, replace <1.18> with a supported version and <region-code> with an Amazon EKS supported Region for which you want the AMI ID. Replace <amazon-linux-2> with
amazon-linux-2-gpu
to see the accelerated AMI ID andamazon-linux-2-arm64
to see the Arm ID.https://console.aws.amazon.com/systems-manager/parameters/%252Faws%252Fservice%252Feks%252Foptimized-ami%252F<1.18>%252F<amazon-linux-2>%252Frecommended%252Fimage_id/description?region=<region-code>