

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Récupérez les ID AMI macOS à l'aide de AWS Systems Manager API de stockage des paramètres
<a name="macos-ami-ids-parameter-store"></a>

Vous devez spécifier une AMI lorsque vous lancez une instance. Une AMI est spécifique à un système Région AWS d'exploitation et à une architecture de processeur. Vous pouvez afficher toutes les AMI macOS d'une AMI macOS Région AWS et récupérer la dernière en interrogeant l'API AWS Systems Manager Parameter Store. Grâce à ces paramètres publics, vous n’avez pas besoin de rechercher manuellement les ID d’AMI macOS. Les paramètres publics sont disponibles à la fois pour les AMI ARM64 macOS x86 et peuvent être intégrés à vos AWS CloudFormation modèles existants.

**Autorisations requises**  
Pour effectuer cette action, le [principal IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#id_roles_terms-and-concepts) doit être autorisé à appeler l’action d’`ssm:GetParameter`API.

**Pour afficher la liste de toutes les AMI macOS en cours Région AWS à l'aide du AWS CLI**  
Utilisez la commande [get-parameters-by-path](https://docs.aws.amazon.com/cli/latest/reference/ssm/get-parameters-by-path.html) suivante pour afficher une liste de toutes les AMI macOS dans la région actuelle.

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

**Pour récupérer l'ID d'AMI de la dernière AMI macOS majeure à l'aide du AWS CLI**  
Utilisez la commande [get-parameter](https://docs.aws.amazon.com/cli/latest/reference/ssm/get-parameter.html) suivante avec le sous-paramètre. `image_id` Dans l'exemple suivant, `sonoma` remplacez-la par une version majeure compatible avec macOS, `x86_64_mac` avec le processeur et `region-code` par une version compatible Région AWS pour laquelle vous souhaitez obtenir la dernière version de l'AMI macOS.

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

Pour plus d’informations, veuillez consulter la rubrique [Résultat des paramètres publics](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-public-parameters-ami.html#public-parameters-ami-macos) dans le *Guide de l’utilisateur AWS Systems Manager *.