**이 페이지 개선에 도움 주기** 

이 사용자 가이드에 기여하려면 모든 페이지의 오른쪽 창에 있는 **GitHub에서 이 페이지 편집** 링크를 선택합니다.

# 권장 Microsoft Windows AMI ID 검색
<a name="retrieve-windows-ami-id"></a>

노드를 배포할 때 사전 구축된 Amazon EKS 최적화 Amazon Machine Image(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)를 참조하세요. Amazon EKS 최적화 AMI 메타데이터를 검색하려면 [IAM 보안 주체](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#iam-term-principal)에 `ssm:GetParameter` IAM 권한이 있어야 합니다.

하위 파라미터 `image_id`를 사용하는 다음 명령을 사용하여 최신 권장 Amazon EKS 최적화 Windows AMI의 이미지 ID를 검색할 수 있습니다. 필요에 따라 명령을 다음과 같이 수정한 다음에 수정한 명령을 실행합니다.
+ {{release}}를 다음 옵션 중 하나로 변경합니다.
  + Windows Server 2025의 경우 {{2025}}를 사용합니다.
  + Windows Server 2022의 경우 {{2022}}를 사용합니다.
  + Windows Server 2019의 경우 {{2019}}를 사용합니다.
+ {{설치 옵션}}을 다음 옵션 중 하나로 바꿉니다. 자세한 내용은 [Windows Server의 Server Core 설치 옵션이란 무엇인가요](https://learn.microsoft.com/en-us/windows-server/administration/server-core/what-is-server-core)를 참조하세요.
  + {{Core}}를 공격 표면이 더 작은 최소한의 설치에 사용합니다.
  + Windows 데스크톱 환경을 포함하려면 {{전체}}를 사용합니다.
+ [kubernetes-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}}
```