# AWS Systems Manager Parameter Store API를 사용하여 macOS AMI ID 검색
<a name="macos-ami-ids-parameter-store"></a>

인스턴스를 시작할 때 AMI를 지정해야 합니다. AMI는 AWS 리전, 운영 체제, 프로세서 아키텍처에 따라 다릅니다. AWS Systems Manager Parameter Store API를 쿼리하여 AWS 리전의 모든 macOS AMI를 보고 최신 macOS AMI를 검색할 수 있습니다. 이러한 퍼블릭 파라미터를 사용하면 macOS AMI ID를 수동으로 조회할 필요가 없습니다. 퍼블릭 파라미터는 x86 및 ARM64 macOS AMI에서 모두 사용할 수 있으며 기존 AWS CloudFormation 템플릿과 통합할 수 있습니다.

**필수 권한**  
이 작업을 수행하려면 [IAM 보안 주체](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#id_roles_terms-and-concepts)에게 `ssm:GetParameter` API 작업을 직접적으로 호출할 수 있는 권한이 있어야 합니다.

**AWS CLI를 사용하여 현재 AWS 리전의 모든 macOS AMI 목록을 보려면**  
다음 [get-parameters-by-path](https://docs.aws.amazon.com/cli/latest/reference/ssm/get-parameters-by-path.html) 명령을 사용하여 현재 리전에 있는 모든 macOS AMI의 목록을 볼 수 있습니다.

```
aws ssm get-parameters-by-path --path /aws/service/ec2-macos --recursive --query "Parameters[].Name"
```

**AWS CLI를 사용하여 최신 메이저 macOS AMI의 AMI ID를 검색하려면**  
다음 [get-parameter](https://docs.aws.amazon.com/cli/latest/reference/ssm/get-parameter.html) 명령을 서브 파라미터 `image_id`와 함께 사용합니다. 다음 예제에서 `sonoma`를 macOS 지원 메이저 버전으로 바꾸고, `x86_64_mac`을 프로세서로 바꾸고, `region-code`를 최신 macOS AMI ID가 필요한 지원되는 AWS 리전으로 바꿉니다.

```
aws ssm get-parameter --name /aws/service/ec2-macos/sonoma/x86_64_mac/latest/image_id --region region-code
```

자세한 내용은 *AWS Systems Manager 사용 설명서*의 [Calling AMI public parameters for macOS](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-public-parameters-ami.html#public-parameters-ami-macos)를 참조하세요.