**帮助改进此页面** 

要帮助改进本用户指南，请选择位于每个页面右侧窗格中的**在 GitHub 上编辑此页面**链接。

# 检索建议的 Amazon Linux AMI ID
<a name="retrieve-ami-id"></a>

部署节点时，您可以为预先构建的 Amazon EKS 优化版亚马逊机器映像（AMI）指定 ID。要检索符合所需配置的 AMI ID，请查询 Amazon Systems Manager Parameter Store API。使用此 API，您无需手动查找 Amazon EKS 优化版 AMI ID。有关更多信息，请参阅 [GetParameter](https://docs.amazonaws.cn/systems-manager/latest/APIReference/API_GetParameter.html)。您使用的 [IAM 主体](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_roles.html#iam-term-principal)必须具有 `ssm:GetParameter` IAM 权限才能检索 Amazon EKS 优化版 AMI 元数据。

您可以使用以下命令检索最新推荐 Amazon EKS 优化版 AMI 的映像 ID，该命令使用子参数 `image_id`。根据需要对该命令进行以下修改，然后运行修改后的命令：
+ 将 `<kubernetes-version>` 替换为 [Amazon EKS 支持的版本](https://docs.amazonaws.cn/eks/latest/userguide/kubernetes-versions.html)。
+ 将 *ami-type* 替换为以下选项之一。有关 Amazon EC2 实例类型的信息，请参阅 [Amazon EC2 实例类型](https://docs.amazonaws.cn/AWSEC2/latest/UserGuide/instance-types.html)。
  + 将 *amazon-linux-2023/x86\$164/standard* 用于基于 Amazon Linux 2023（AL2023）`x86` 的实例。
  + 将 *amazon-linux-2023/arm64/standard* 用于 AL2023 ARM 实例，例如基于 [Amazon Graviton](https://www.amazonaws.cn/ec2/graviton/) 的实例。
  + 将 *amazon-linux-2023/x86\$164/nvidia* 用于最新批准的基于 AL2023 NVIDIA `x86` 的实例。
  + 将 *amazon-linux-2023/arm64/nvidia* 用于最新批准的基于 AL2023 NVIDIA `arm64` 的实例。
  + 将 *amazon-linux-2023/x86\$164/neuron* 用于最新的 AL2023 [Amazon Neuron](https://www.amazonaws.cn/machine-learning/neuron/) 实例。
+ 请将 `<region-code>` 替换为您需要 AMI ID 的 [Amazon EKS 支持的 Amazon 区域](https://docs.amazonaws.cn/general/latest/gr/eks.html)。

```
aws ssm get-parameter --name /aws/service/eks/optimized-ami/<kubernetes-version>/<ami-type>/recommended/image_id \
    --region <region-code> --query "Parameter.Value" --output text
```

以下是替换占位符后的命令示例。

```
aws ssm get-parameter --name /aws/service/eks/optimized-ami/1.31/amazon-linux-2023/x86_64/standard/recommended/image_id \
    --region us-west-2 --query "Parameter.Value" --output text
```

示例输出如下。

```
ami-1234567890abcdef0
```