**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 da AMI do Bottlerocket recomendadas
<a name="retrieve-ami-id-bottlerocket"></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 da imagem da AMI otimizada mais recente do Bottlerocket para Amazon EKS com o comando a seguir da AWS CLI, 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 da plataforma](https://docs.aws.amazon.com/eks/latest/userguide/platform-versions.html) compatível.
+ Substitua {{-flavor}} por uma das opções a seguir.
  + Remover {{-flavor}} para variantes sem GPU.
  + Use {{-nvidia}} para variantes habilitadas para GPU.
  + Use {{-fips}} para variantes habilitadas para FIPS.
+ Substitua {{architecture}} por uma das opções a seguir.
  + Use {{x86\_64}} para instâncias baseadas em `x86`.
  + Use {{arm64}} para instâncias ARM.
+ Substitua {{region-code}} por uma [região da AWScompatível com o Amazon EKS](https://docs.aws.amazon.com/general/latest/gr/eks.html) para a qual você deseja obter o ID da AMI.

```
aws ssm get-parameter --name /aws/service/bottlerocket/aws-k8s-{{kubernetes-version-flavor}}/{{architecture}}/latest/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/bottlerocket/aws-k8s-{{1.31}}/{{x86_64}}/latest/image_id \
    --region {{us-west-2}} --query "Parameter.Value" --output text
```

Veja abaixo um exemplo de saída.

```
ami-{{1234567890abcdef0}}
```