**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 Microsoft Windows recomendadas
<a name="retrieve-windows-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 Windows otimizada e recomendada para 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 {{release}} por uma das seguintes opções.
  + Use {{2025}} para o Windows Server 2025.
  + Use {{2022}} para o Windows Server 2022.
  + Use {{2019}} para o Windows Server 2019.
+ Substitua {{installation-option}} por uma das seguintes opções. Para obter mais informações, consulte [O que é a opção de instalação do Server Core no Windows Server](https://learn.microsoft.com/en-us/windows-server/administration/server-core/what-is-server-core).
  + Use o {{Core}} para uma instalação mínima com uma superfície de ataque menor.
  + Use {{Full}} para incluir a experiência de desktop do Windows.
+ Substitua {{kubernetes-version}} por uma [versão da plataforma](https://docs.aws.amazon.com/eks/latest/userguide/platform-versions.html) compatível.
+ 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/ami-windows-latest/Windows_Server-{{release}}-English-{{installation-option}}-EKS_Optimized-{{kubernetes-version}}/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/ami-windows-latest/Windows_Server-{{2022}}-English-{{Core}}-EKS_Optimized-{{k8s-n-2}}/image_id \
    --region {{us-west-2}} --query "Parameter.Value" --output text
```

Veja abaixo um exemplo de saída.

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