Retrieving Amazon EKS optimized Bottlerocket AMI IDs - Amazon EKS
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Retrieving Amazon EKS optimized Bottlerocket AMI IDs

You can retrieve the Amazon Machine Image (AMI) ID for Amazon EKS optimized AMIs by querying the Amazon Systems Manager Parameter Store API. Using this parameter, you don't need to manually look up Amazon EKS optimized AMI IDs. For more information about the Systems Manager Parameter Store API, see GetParameter. The IAM principal that you use must have the ssm:GetParameter IAM permission to retrieve the Amazon EKS optimized AMI metadata.

You can retrieve the AMI ID with the Amazon CLI or the Amazon Web Services Management Console.

  • Amazon CLI – You can retrieve the image ID of the latest recommended Amazon EKS optimized Bottlerocket AMI with the following Amazon CLI command by using the sub-parameter image_id. Replace 1.25 with a supported version and region-code with an Amazon EKS supported Region for which you want the AMI ID.

    aws ssm get-parameter --name /aws/service/bottlerocket/aws-k8s-1.25/x86_64/latest/image_id --region region-code --query "Parameter.Value" --output text

    The example output is as follows.

    ami-1234567890abcdef0

  • Amazon Web Services Management Console – You can query for the recommended Amazon EKS optimized AMI ID using a URL in the Amazon Web Services Management Console. The URL opens the Amazon EC2 Systems Manager console with the value of the ID for the parameter. In the following URL, replace 1.25 with a supported version and region-code with an Amazon EKS supported Region for which you want the AMI ID.

    https://console.amazonaws.cn/systems-manager/parameters/aws/service/bottlerocket/aws-k8s-1.25/x86_64/latest/image_id/description?region=region-code