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

このユーザーガイドに貢献するには、すべてのページの右側のペインにある「**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}}
```