

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 identifiants AMI macOS à l'aide de AWS Systems Manager API de magasin de 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 à une Région AWS architecture de processeur et de système d'exploitation. Vous pouvez afficher toutes les AMI macOS dans 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 présentes dans la version actuelle 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 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, remplacez-le `sonoma` par une version majeure prise en charge par macOS, `x86_64_mac` par le processeur et `region-code` par une version compatible Région AWS pour laquelle vous souhaitez obtenir le dernier identifiant 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 *.