# Recuperar IDs de AMI do macOS usando a API do AWS Systems Manager Parameter Store
<a name="macos-ami-ids-parameter-store"></a>

Especifique uma AMI ao iniciar uma instância. Uma AMI é específica para uma Região da AWS, um sistema operacional e uma arquitetura de processador. É possível visualizar todas as AMIs do macOS em uma Região da AWS e recuperar a AMI mais recente do macOS consultando a API do AWS Systems Manager Parameter Store. Ao usar esses parâmetros públicos, não será necessário pesquisar manualmente IDs de AMI para o macOS. Os parâmetros públicos estão disponíveis para as AMIs x86 e ARM64 do macOS e podem ser integrados aos modelos do AWS CloudFormation existentes.

**Permissões obrigatórias**  
Para realizar essa ação, a [entidade principal do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#id_roles_terms-and-concepts) deve ter permissões para chamar a ação da API `ssm:GetParameter`.

**Para visualizar uma lista de todas as AMIs do macOS na Região da AWS atual usando a AWS CLI**  
Use o comando [get-parameters-by-path](https://docs.aws.amazon.com/cli/latest/reference/ssm/get-parameters-by-path.html) para visualizar uma lista de todas as AMIs do macOS na região atual.

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

**Para recuperar o ID da AMI principal mais recente do macOS usando a AWS CLI**  
Use o seguinte comando [get-parameter](https://docs.aws.amazon.com/cli/latest/reference/ssm/get-parameter.html) com o subparâmetro `image_id`. No exemplo a seguir, substitua `sonoma` por uma versão principal compatível do macOS, `x86_64_mac` pelo processador e `region-code` por uma Região da AWS compatível para a qual você deseja o ID de AMI mais recente do macOS.

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

Para obter mais informações, consulte [Chamar parâmetros públicos da AMI para macOS](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-public-parameters-ami.html#public-parameters-ami-macos) no *Guia do usuário do AWS Systems Manager*.