**このページの改善にご協力ください** 

このユーザーガイドに貢献するには、すべてのページの右側のペインにある「**GitHub でこのページを編集する**」リンクを選択してください。

# 推奨 Microsoft Windows AMI ID を取得する
<a name="retrieve-windows-ami-id"></a>

ノードをデプロイする際に、事前構築済みの Amazon EKS 最適化 Amazon マシンイメージ (AMI) の ID を指定できます。希望する設定に合った AMI ID を取得するには、AWS Systems Manager Parameter Store API をクエリします。この API を使用すると、Amazon EKS 最適化 AMI ID を手動で検索する必要がなくなります。詳細については、「[GetParameter](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameter.html)」を参照してください。使用する [IAM プリンシパル](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#iam-term-principal)には、Amazon EKS 最適化 AMI メタデータを取得するための `ssm:GetParameter` IAM アクセス許可が必要です。

サブパラメータ `image_id` を使用する次のコマンドで、推奨される最新の Amazon EKS 最適化 Windows AMI のイメージ ID を取得できます。必要に応じてコマンドに次の変更を加え、変更したコマンドを実行してください：
+ *release* は、以下のいずれかのオプションに置き換えます。
  + Windows Server 2025 には *2025* を使用します。
  + Windows Server 2022 には *2022* を使用します。
  + Windows Server 2019 には *2019* を使用します。
+ *installation-option* は、以下のいずれかのオプションに置き換えます。詳細については、「[What is the Server Core installation option in Windows Server](https://learn.microsoft.com/en-us/windows-server/administration/server-core/what-is-server-core)」を参照してください。
  + アタックサーフェスを小さくした最小限のインストールには *Core* を使用します。
  + Windows デスクトップエクスペリエンスを含めるには *Full* を使用します。
+ *kubernetes-version* を、サポートされている [platform-version](https://docs.aws.amazon.com/eks/latest/userguide/platform-versions.html) に置き換えます。
+ *region-code* を、AMI ID が必要な [Amazon EKS がサポートしている AWS リージョン](https://docs.aws.amazon.com/general/latest/gr/eks.html)に置き換えます。

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

プレースホルダーの置換が行われた後のコマンドの例を以下に示します。

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

出力例は次のとおりです。

```
ami-1234567890abcdef0
```