# 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 を取得するには**  
サブパラメータ `image_id` を入れた次の [get-parameter](https://docs.aws.amazon.com/cli/latest/reference/ssm/get-parameter.html) コマンドを使用します。次の例で、`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 ユーザーガイド*」の「[macOS 用 AMI パブリックパラメータを呼び出す](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-public-parameters-ami.html#public-parameters-ami-macos)」を参照してください。