**Ajudar a melhorar esta página** 

Para contribuir com este guia de usuário, escolha o link **Editar esta página no GitHub**, disponível no painel direito de cada página.

# Recuperar IDs de AMI do Amazon Linux recomendadas
<a name="retrieve-ami-id"></a>

Ao implantar nós, é possível especificar um ID para uma imagem de máquina da Amazon (AMI) pré-compilada e otimizada para o Amazon EKS. Para recuperar um ID de AMI que se ajuste à configuração desejada, consulte a API AWS Systems Manager Parameter Store. O uso dessa API elimina a necessidade de pesquisar manualmente IDs de AMIs otimizadas para o Amazon EKS. Para obter mais informações, consulte [GetParameter](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameter.html). A [entidade principal do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#iam-term-principal) que você usou deve ter a permissão `ssm:GetParameter` do IAM para recuperar os metadados da AMI otimizada para o Amazon EKS.

Você pode recuperar o ID de imagem da mais recente AMI do Amazon Linux recomendada otimizada para o Amazon EKS com o comando a seguir, que usa o subparâmetro `image_id`. Faça as seguintes modificações no comando, conforme necessário, e execute o comando atualizado:
+ Substitua `<kubernetes-version>` por uma [versão compatível do Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/kubernetes-versions.html).
+ Substitua *ami-type* por uma das seguintes opções. Para obter mais informações sobre os tipos de instâncias do Amazon EC2, consulte [Tipos de instância do Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html).
  + Use *amazon-linux-2023/x86\$164/standard* para instâncias baseadas no Amazon Linux 2023 (AL2023) `x86`.
  + Use *amazon-linux-2023/arm64/standard* para instâncias ARM do AL2023, como as instâncias baseadas no [AWS Graviton](https://aws.amazon.com/ec2/graviton/).
  + Use *amazon-linux-2023/x86\$164/nvidia* para as instâncias `x86` baseadas do NVIDIA do AL2023 aprovadas mais recentemente.
  + Use *amazon-linux-2023/arm64/nvidia* para as instâncias `arm64` do NVIDIA do AL2023 aprovadas mais recentemente.
  + Use *amazon-linux-2023/x86\$164/neuron* para as instâncias mais recentes do AL2023 [AWS Neuron](https://aws.amazon.com/machine-learning/neuron/).
+ Substitua `<region-code>` por uma [região da AWS compatível com o Amazon EKS](https://docs.aws.amazon.com/general/latest/gr/eks.html) para a qual você deseja o ID da AMI.

```
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
```

Aqui está um exemplo de comando após as substituições do espaço reservado terem sido feitas.

```
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
```

Veja abaixo um exemplo de saída.

```
ami-1234567890abcdef0
```