

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.

# Créer un modèle de lancement Amazon EC2
<a name="create-launch-template"></a>

Vous pouvez créer un modèle de lancement Amazon EC2 en spécifiant vos propres valeurs pour les paramètres de configuration de l’instance, ou en obtenant les valeurs d’un modèle de lancement ou d’une instance Amazon EC2 existant.

Il n’est pas nécessaire de spécifier une valeur pour chaque paramètre du modèle de lancement ; il suffit de spécifier un paramètre de configuration d’instance pour créer un modèle de lancement. Pour indiquer les paramètres que vous choisissez de ne pas spécifier, sélectionnez **Ne pas inclure dans le modèle de lancement** lorsque vous utilisez la console. Lorsque vous utilisez un outil de ligne de commande, n’incluez pas les paramètres pour indiquer que vous choisissez de ne pas les spécifier dans le modèle de lancement.

Si vous souhaitez spécifier une AMI dans le modèle de lancement, vous pouvez sélectionner une AMI ou spécifier un paramètre Systems Manager pointant vers une AMI au lancement de l’instance.

Lorsqu’une instance est lancée avec un modèle de lancement, les valeurs spécifiées dans le modèle de lancement sont utilisées pour configurer les paramètres d’instance correspondants. Si aucune valeur n’est spécifiée dans le modèle de lancement, la valeur par défaut du paramètre d’instance correspondant est utilisée.

**Topics**
+ [

## Créer un modèle de lancement en spécifiant des paramètres
](#create-launch-template-define-parameters)
+ [

## Créer un modèle de lancement à partir d’un modèle de lancement existant
](#create-launch-template-from-existing-launch-template)
+ [

## Créer un modèle de lancement à partir d’une instance
](#create-launch-template-from-instance)
+ [

## Utilisation d’un paramètre Systems Manager au lieu d’un ID d’AMI
](#use-an-ssm-parameter-instead-of-an-ami-id)

## Créer un modèle de lancement en spécifiant des paramètres
<a name="create-launch-template-define-parameters"></a>

Pour créer un modèle de lancement, vous devez spécifier son nom et au moins un paramètre de configuration d’instance.

Pour obtenir une description de chaque paramètre, consultez [Référence pour les paramètres de configuration des EC2 instances Amazon](ec2-instance-launch-parameters.md).

------
#### [ Console ]

**Pour créer un modèle de lancement**

1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Dans le panneau de navigation, choisissez **Modèles de lancement**, puis **Créer un modèle de lancement**.

1. Sous **Nom et description du modèle de lancement**, procédez comme suit :

   1. Pour **Nom du modèle de lancement**, entrez un nom descriptif pour le modèle.

   1. Pour **Description de la version du modèle**, fournissez une brève description de cette version du modèle de lancement.

   1. Pour [étiqueter](Using_Tags.md) le modèle de lancement à la création, développez **Template tags** (Identifications du modèle), choisissez **Add new tag** (Ajouter une nouvelle balise), puis saisissez une paire de clé et de valeur de balise. Choisissez à nouveau **Ajouter une nouvelle balise** pour chaque balise supplémentaire à ajouter.
**Note**  
Pour étiqueter les ressources créées lors du lancement d’une instance, vous devez spécifier les identifications sous **Resource tags** (Identifications de ressource). Pour plus d’informations, consultez l’étape 9 de la procédure .

1. Sous **Application and OS Images (Amazon Machine Image)**, vous pouvez soit conserver l’option **Ne pas inclure dans le modèle de lancement**, soit choisir le système d’exploitation (OS) pour l’instance, puis choisir une AMI. Vous pouvez également spécifier un paramètre du gestionnaire de systèmes au lieu d’indiquer une AMI. Pour de plus amples informations, veuillez consulter [Utilisation d’un paramètre Systems Manager au lieu d’un ID d’AMI](#use-an-ssm-parameter-instead-of-an-ami-id).

   Une AMI est un modèle contenant le système d’exploitation et le logiciel requis pour lancer une instance.

1. Sous **Type d’instance**, vous pouvez soit conserver l’option **Ne pas inclure dans le modèle de lancement** soit sélectionner un type d’instance, soit spécifier des attributs d’instance et laisser Amazon EC2 identifier les types d’instance avec ces attributs.
**Note**  
La spécification des attributs d’instance n’est prise en charge que lorsque le modèle de lancement est utilisé par les groupes Auto Scaling, flotte EC2 et parc d’instances Spot pour lancer des instances. Pour plus d'informations, consultez la section [Créer un groupe d'instances mixtes à l'aide d'une sélection de type d'instance basée sur les attributs](https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-mixed-instances-group-attribute-based-instance-type-selection.html) et [Spécifiez des attributs pour la sélection de type d’instance pour la flotte EC2](ec2-fleet-attribute-based-instance-type-selection.md).  
Si vous prévoyez d'utiliser le modèle de lancement dans l'[assistant de lancement d'instance](ec2-launch-instance-wizard.md) ou avec l'[RunInstances API](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html), vous ne pouvez pas spécifier d'attributs de type d'instance. 

   Le type d’instance détermine la configuration matérielle (CPU, mémoire, capacité de stockage et de mise en réseau) et la taille de l’ordinateur hôte utilisé pour une instance.

   Si vous n’êtes pas sûr du type d’instance à choisir, vous pouvez procéder comme suit :
   + Choisissez **Comparer les types d'instance** pour comparer différents types d'instances en fonction des attributs suivants : nombre de vCPUs, architecture, quantité de mémoire (GiB), quantité de stockage (Go), type de stockage et performances du réseau.
   + Choisissez **Obtenir des conseils** pour obtenir des conseils et des suggestions sur les types d’instance à partir de l’outil de recherche de type d’instance EC2. Pour de plus amples informations, veuillez consulter [Obtenir des recommandations de la part de l'outil de recherche de type d'instance EC2](get-ec2-instance-type-recommendations.md).
**Note**  
Selon la date à laquelle vous avez créé votre compte, vous pouvez bénéficier d’une éligibilité à l’utilisation d’Amazon EC2 dans le cadre de l’offre gratuite.  
**Si vous avez créé votre instance Compte AWS avant le 15 juillet 2025 et qu'elle date de moins de 12 mois, vous pouvez utiliser Amazon EC2 dans le cadre du niveau gratuit en sélectionnant le type d'instance **t2.micro ou le type d'instance t3.micro** **dans les régions où t2.micro** n'est pas disponible.** Sachez que lorsque vous lancez une instance **t3.micro**, elle passe par défaut en [mode **illimité**](burstable-performance-instances-unlimited-mode.md), ce qui peut entraîner des frais supplémentaires en fonction de l’utilisation du processeur. Si un type d’instance est éligible à l’offre gratuite, il est étiqueté **Éligible à l’offre gratuite**.  
**Si vous avez créé votre instance Compte AWS le 15 juillet 2025 ou après cette date, vous pouvez utiliser les types d'instance **t3.micro**, **t3.small, **t4g.small****, **c7i-flex.large et **m7i-flex.large**** pendant 6 mois ou jusqu'à épuisement de vos crédits.**  
Pour de plus amples informations, veuillez consulter [Avantages de l’offre gratuite avant et après le 15 juillet 2025](ec2-free-tier-usage.md#ec2-free-tier-comparison).

1. Sous **Paire de clés (connexion)**, pour le **nom de la paire de clés**, vous pouvez soit conserver l’option **Ne pas inclure dans le modèle de lancement**, soit choisir une paire de clés existante, soit en créer une nouvelle.

1. Sous **Paramètres réseau**, vous pouvez soit conserver l’option **Ne pas inclure dans le modèle de lancement** sélectionnée, soit spécifier des valeurs pour les différents paramètres réseau.

1. Sous **Configurer le stockage**, si vous spécifiez une AMI pour le modèle de lancement, l’AMI inclut un ou plusieurs volumes de stockage, notamment le volume racine (**Volume 1 (AMI Root)** (Volume 1 (racine AMI). Vous pouvez éventuellement spécifier des volumes supplémentaires à attacher à l’instance. Pour ajouter un nouveau volume, choisissez **Ajouter un volume**.

1. Pour **étiqueter** les ressources créées lors du lancement d’une instance, sous [Resource tags](Using_Tags.md) (Identifications de ressource), choisissez **Add tag** (Ajouter une identification), puis saisissez une paire de clé et de valeur d’identification. Pour **Resource types** (Types de ressource), spécifiez les ressources à étiqueter lors de la création. Vous pouvez spécifier la même identification pour toutes les ressources ou spécifier des identifications différentes pour différentes ressources. Choisissez **Add tag** (Ajouter une identification) pour chaque étiquette supplémentaire.

   Vous pouvez spécifier des identifications pour les ressources suivantes qui sont créées lorsqu’un modèle de lancement est utilisé :
   + instances
   + Volumes
   + Elastic Graphics
   + Demandes d’instance Spot
   + Interfaces réseau
**Note**  
Pour étiqueter le modèle de lancement lui-même, vous devez spécifier les identifications sous **Template tags** (Identifications de modèle). Pour plus d’informations, consultez l’étape 3 de la procédure .

1. Pour la section **Détails avancés** développez la section pour afficher les champs et, éventuellement, préciser des paramètres supplémentaires pour votre instance.

1. Utilisez le panneau **Summary** (Récapitulatif) pour passer en revue la configuration de votre modèle de lancement. Vous pouvez accéder à n’importe quelle section en choisissant le lien correspondant, puis en apportant les modifications nécessaires.

1. Lorsque vous êtes prêt à créer votre modèle de lancement, choisissez**Create launch template** (Créer un modèle de lancement).

------
#### [ AWS CLI ]

**Pour créer un modèle de lancement**  
Utilisez la commande [create-launch-template](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-launch-template.html).

```
aws ec2 create-launch-template \
    --launch-template-name TemplateForWebServer \
    --version-description WebVersion1 \
    --tag-specifications 'ResourceType=launch-template,Tags=[{Key=purpose,Value=production}]' \
    --launch-template-data file://template-data.json
```

Voici un exemple de fichier JSON contenant les données du modèle de lancement pour la configuration de l’instance. Enregistrez le JSON dans un fichier et incluez-le dans le `--launch-template-data` paramètre, comme indiqué dans l’exemple de commande.

```
{
    "NetworkInterfaces": [{
        "AssociatePublicIpAddress": true,
        "DeviceIndex": 0,
        "Ipv6AddressCount": 1,
        "SubnetId": "subnet-0abcdef1234567890"
    }],
    "ImageId": "ami-0abcdef1234567890",
    "InstanceType": "r5.4xlarge",
    "TagSpecifications": [{
        "ResourceType": "instance",
        "Tags": [{
            "Key":"Name",
            "Value":"webserver"
        }]
    }],
    "CpuOptions": {
        "CoreCount":4,
        "ThreadsPerCore":2
    }
}
```

Voici un exemple de sortie.

```
{
    "LaunchTemplate": {
        "LatestVersionNumber": 1, 
        "LaunchTemplateId": "lt-01238c059e3466abc", 
        "LaunchTemplateName": "TemplateForWebServer", 
        "DefaultVersionNumber": 1, 
        "CreatedBy": "arn:aws:iam::123456789012:root", 
        "CreateTime": "2017-11-27T09:13:24.000Z"
    }
}
```

------
#### [ PowerShell ]

**Pour créer un modèle de lancement**  
Utilisez l’applet de commande [New-EC2LaunchTemplate](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2LaunchTemplate.html).

```
$launchTemplateData = [Amazon.EC2.Model.RequestLaunchTemplateData]@{
    ImageId = 'ami-0abcdef1234567890'
    InstanceType = 'r5.4xlarge'
    NetworkInterfaces = @(
        [Amazon.EC2.Model.LaunchTemplateInstanceNetworkInterfaceSpecificationRequest]@{
            AssociatePublicIpAddress = $true
            DeviceIndex = 0
            Ipv6AddressCount = 1
            SubnetId = 'subnet-0abcdef1234567890'
        }
    )
    TagSpecifications = @(
        [Amazon.EC2.Model.LaunchTemplateTagSpecificationRequest]@{
            ResourceType = 'instance'
            Tags = [Amazon.EC2.Model.Tag]@{
                Key = 'Name'
                Value = 'webserver'
            }
        }
    )
    CpuOptions = [Amazon.EC2.Model.LaunchTemplateCpuOptionsRequest]@{
        CoreCount = 4
        ThreadsPerCore = 2
    }
}
$tagSpecificationData = [Amazon.EC2.Model.TagSpecification]@{
    ResourceType = 'launch-template'
    Tags = [Amazon.EC2.Model.Tag]@{
        Key = 'purpose'
        Value = 'production'
    }
}
New-EC2LaunchTemplate -LaunchTemplateName 'TemplateForWebServer' `
    -VersionDescription 'WebVersion1' `
    -LaunchTemplateData $launchTemplateData `
    -TagSpecification $tagSpecificationData
```

Voici un exemple de sortie.

```
CreatedBy            : arn:aws:iam::123456789012:root
CreateTime           : 9/19/2023 16:57:55
DefaultVersionNumber : 1
LatestVersionNumber  : 1
LaunchTemplateId     : lt-01238c059eEXAMPLE
LaunchTemplateName   : TemplateForWebServer
Tags                 : {purpose}
```

------

## Créer un modèle de lancement à partir d’un modèle de lancement existant
<a name="create-launch-template-from-existing-launch-template"></a>

Vous pouvez cloner un modèle de lancement existant, puis ajuster les paramètres pour créer un modèle de lancement. Toutefois, vous ne pouvez effectuer cette opération que si vous utilisez la console Amazon EC2. Le AWS CLI ne prend pas en charge le clonage d'un modèle. Pour obtenir une description de chaque paramètre, consultez [Référence pour les paramètres de configuration des EC2 instances Amazon](ec2-instance-launch-parameters.md).

------
#### [ Console ]

**Pour créer un modèle de lancement à partir d’un modèle de lancement existant**

1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Dans le panneau de navigation, choisissez **Modèles de lancement**, puis **Créer un modèle de lancement**.

1. Pour **Nom du modèle de lancement**, entrez un nom descriptif pour le modèle.

1. Pour **Description de la version du modèle**, fournissez une brève description de cette version du modèle de lancement.

1. Pour baliser le modèle de lancement à la création, développez **Template tags** (Balises du modèle), **Ajouter une nouvelle balise**, puis entrez une paire de clé et de valeur de balise.

1. Développez **Modèle source**, et, pour **Nom du modèle de lancement**, choisissez un modèle de lancement sur lequel baser le nouveau modèle.

1. Pour **Version du modèle source**, choisissez la version du modèle de lancement sur laquelle baser le nouveau modèle de lancement.

1. Ajustez les paramètres de lancement si nécessaire, puis choisissez **Créer un modèle de lancement**.

------

## Créer un modèle de lancement à partir d’une instance
<a name="create-launch-template-from-instance"></a>

Vous pouvez cloner les paramètres d’une instance Amazon EC2, puis ajuster les paramètres pour créer un modèle de lancement. Pour obtenir une description de chaque paramètre, consultez [Référence pour les paramètres de configuration des EC2 instances Amazon](ec2-instance-launch-parameters.md).

------
#### [ Console ]

**Pour créer un modèle de lancement à partir d’une instance**

1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Dans le panneau de navigation, choisissez **Instances**.

1. Sélectionnez l’instance et choisissez **Actions**, **Image et modèles**, **Créer un modèle à partir d’une instance**.

1. Indiquez un nom, une description eet des balises, puis ajustez les paramètres de lancement si nécessaire.
**Note**  
Lorsque vous créez un modèle de lancement à partir d'une instance, l'interface réseau IDs et les adresses IP de l'instance ne sont pas incluses dans le modèle.

1. Choisissez **Créer un modèle de lancement**.

------
#### [ AWS CLI ]

Vous pouvez utiliser le AWS CLI pour créer un modèle de lancement à partir d'une instance existante en obtenant d'abord les données du modèle de lancement à partir d'une instance, puis en créant un modèle de lancement à l'aide des données du modèle de lancement.

**Pour obtenir des données de modèle de lancement à partir d’une instance**
+ Utilisez la commande [get-launch-template-data](https://docs.aws.amazon.com/cli/latest/reference/ec2/get-launch-template-data.html) et spécifiez l’ID de l’instance. Vous pouvez utiliser la sortie comme base pour créer un modèle de lancement ou une version de modèle de lancement. Par défaut, la sortie contient un objet `LaunchTemplateData` de niveau supérieur qui ne peut pas être spécifié dans les données de modèle de lancement. Excluez cet objet à l’aide de l’option `--query`.

  ```
  aws ec2 get-launch-template-data \
      --instance-id i-0123d646e8048babc \
      --query "LaunchTemplateData"
  ```

  Voici un exemple de sortie.

  ```
      {
          "Monitoring": {}, 
          "ImageId": "ami-8c1be5f6", 
          "BlockDeviceMappings": [
              {
                  "DeviceName": "/dev/xvda", 
                  "Ebs": {
                      "DeleteOnTermination": true
                  }
              }
          ], 
          "EbsOptimized": false, 
          "Placement": {
              "Tenancy": "default", 
              "GroupName": "", 
              "AvailabilityZone": "us-east-1a"
          }, 
          "InstanceType": "t2.micro", 
          "NetworkInterfaces": [
              {
                  "Description": "", 
                  "NetworkInterfaceId": "eni-35306abc", 
                  "PrivateIpAddresses": [
                      {
                          "Primary": true, 
                          "PrivateIpAddress": "10.0.0.72"
                      }
                  ], 
                  "SubnetId": "subnet-7b16de0c", 
                  "Groups": [
                      "sg-7c227019"
                  ], 
                  "Ipv6Addresses": [
                      {
                          "Ipv6Address": "2001:db8:1234:1a00::123"
                      }
                  ], 
                  "PrivateIpAddress": "10.0.0.72"
              }
          ]
      }
  ```

  Par exemple, vous pouvez écrire directement la sortie dans un fichier :

  ```
  aws ec2 get-launch-template-data \
      --instance-id i-0123d646e8048babc \
      --query "LaunchTemplateData" >> instance-data.json
  ```

**Pour créer un modèle de lancement à l’aide des données du modèle de lancement**
+ Utilisez la [create-launch-template](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-launch-template.html)commande pour créer un modèle de lancement en utilisant le résultat de la procédure précédente. Pour plus d'informations sur la création d'un modèle de lancement à l'aide du AWS CLI, consultez[Créer un modèle de lancement en spécifiant des paramètres](#create-launch-template-define-parameters).

------

## Utilisation d’un paramètre Systems Manager au lieu d’un ID d’AMI
<a name="use-an-ssm-parameter-instead-of-an-ami-id"></a>

Au lieu de spécifier un ID d’AMI dans vos modèles de lancement, vous pouvez spécifier un paramètre AWS Systems Manager . Si l’ID d’AMI change, vous pouvez le mettre à jour en un seul endroit en mettant à jour le paramètre Systems Manager dans le stockage de paramètres de Systems Manager. Les paramètres peuvent également être [partagés](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html) avec d'autres Comptes AWS. Vous pouvez stocker et gérer de manière centralisée les paramètres de l’AMI dans un seul compte et les partager avec tous les autres comptes qui ont besoin de les référencer. En utilisant un paramètre Systems Manager, tous vos modèles de lancement peuvent être mis à jour en une seule action.

Un paramètre du gestionnaire de systèmes est une paire clé-valeur définie par l’utilisateur que vous créez dans le [magasin de paramètres AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html). Le stockage de paramètres est un endroit central où vous pouvez stocker les valeurs de configuration de votre application.

Dans le schéma suivant, le paramètre `golden-ami` est d’abord mappé à l’AMI d’origine`ami-aabbccddeeffgghhi` dans le stockage de paramètres. Dans le modèle de lancement, la valeur de l’ID d’AMI est `golden-ami`. Lorsqu’une instance est lancée à l’aide de ce modèle de lancement, l’ID d’AMI est défini sur `ami-aabbccddeeffgghhi`. Par la suite, l’AMI est mise à jour et un nouvel ID d’AMI est créé. Dans le stockage de paramètres, le paramètre `golden-ami` est mappé au nouveau `ami-00112233445566778`. *Le modèle de lancement reste inchangé.* Lorsqu’une instance est lancée à l’aide de ce modèle de lancement, l’ID d’AMI devient le nouveau `ami-00112233445566778`.

![\[Utilisation des paramètres Systems Manager dans le stockage de paramètres pour mettre à jour un modèle de lancement.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/launch-template-ami-alias.png)


### Format des paramètres de Systems Manager pour AMI IDs
<a name="ssm-parameter-format-for-ami-ids"></a>

Les modèles de lancement nécessitent que les paramètres Systems Manager définis par l’utilisateur respectent le format suivant lorsqu’ils sont utilisés à la place d’un ID d’AMI :
+ Type de paramètre : `String`
+ Type de données de paramètre : `aws:ec2:image` – Cela garantit que le stockage de paramètres vérifie que la valeur que vous entrez est au format approprié pour un ID d’AMI.

Pour plus d’informations sur la création d’un paramètre valide pour un ID d’AMI, consultez [Création de paramètres Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-su-create.html) dans le *Guide de l’utilisateur AWS Systems Manager *.

### Format des paramètres Systems Manager dans les modèles de lancement
<a name="ssm-parameter-format-in-launch-templates"></a>

Pour utiliser un paramètre Systems Manager à la place d’un ID d’AMI dans un modèle de lancement, vous devez utiliser l’un des formats suivants lorsque vous spécifiez le paramètre dans le modèle de lancement :

Pour référencer un paramètre public :
+ `resolve:ssm:public-parameter`

Pour référencer un paramètre stocké dans le même compte :
+ `resolve:ssm:parameter-name`
+ `resolve:ssm:parameter-name:version-number` – Le numéro de version lui-même est une étiquette par défaut
+ `resolve:ssm:parameter-name:label`

Pour référencer un paramètre partagé par un autre Compte AWS :
+ `resolve:ssm:parameter-ARN`
+ `resolve:ssm:parameter-ARN:version-number`
+ `resolve:ssm:parameter-ARN:label`

**Versions des paramètres**

Les paramètres Systems Manager sont des ressources versionnées. Lorsque vous mettez à jour un paramètre, vous créez de nouvelles versions successives du paramètre. Systems Manager prend en charge les [étiquettes de paramètres](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-labels.html) que vous pouvez associer à des versions spécifiques d’un paramètre.

Par exemple, le paramètre `golden-ami` peut avoir trois versions : `1`, `2` et `3`. Vous pouvez créer une étiquette de paramètre `beta` qui correspond à la version `2` et une étiquette de paramètre `prod` qui correspond à la version `3`.

Dans un modèle de lancement, vous pouvez spécifier la version 3 du paramètre `golden-ami` en utilisant l’un des formats suivants :
+ `resolve:ssm:golden-ami:3`
+ `resolve:ssm:golden-ami:prod`

La spécification de la version ou de l’étiquette est facultative. Si aucune version ou étiquette n’est spécifiée, c’est la dernière version du paramètre qui est utilisée.

### Spécifier un paramètre Systems Manager dans un modèle de lancement
<a name="specify-systems-manager-parameter-in-launch-template"></a>

Vous pouvez spécifier un paramètre Systems Manager dans un modèle de lancement au lieu d’un ID d’AMI lorsque vous créez un modèle de lancement ou une nouvelle version d’un modèle de lancement.

------
#### [ Console ]

**Pour spécifier un paramètre Systems Manager dans un modèle de lancement**

1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Dans le panneau de navigation, choisissez **Modèles de lancement**, puis **Créer un modèle de lancement**. 

1. Pour **Nom du modèle de lancement**, entrez un nom descriptif pour le modèle.

1. Sous **Images de l'application et du système d'exploitation (Amazon Machine Image)**, sélectionnez **Parcourir davantage AMIs**.

1. Sélectionnez le bouton fléché à droite de la barre de recherche, puis choisissez **Spécifier une valeur personnalisée/un paramètre Systems Manager**.

1. Dans la boîte de dialogue **Spécifier une valeur personnalisée ou un paramètre Systems Manager**, procédez comme suit :

   1. Pour **ID d’AMI ou chaîne de paramètres Systems Manager**, saisissez le nom du paramètre Systems Manager en utilisant l’un des formats suivants :

      Pour référencer un paramètre public :
      + **resolve:ssm:*public-parameter***

      Pour référencer un paramètre stocké dans le même compte :
      + **resolve:ssm:*parameter-name***
      + **resolve:ssm:*parameter-name*:*version-number***
      + **resolve:ssm:*parameter-name*:*label***

      Pour référencer un paramètre partagé par un autre Compte AWS :
      + **resolve:ssm:*parameter-ARN***
      + **resolve:ssm:*parameter-ARN*:*version-number***
      + **resolve:ssm:*parameter-ARN*:*label***

   1. Choisissez **Enregistrer**.

1. Spécifiez tout autre paramètre de modèle de lancement selon vos besoins, puis choisissez **Créer un modèle de lancement**.

Pour de plus amples informations, veuillez consulter [Créer un modèle de lancement en spécifiant des paramètres](#create-launch-template-define-parameters).

------
#### [ AWS CLI ]

**Pour spécifier un paramètre Systems Manager dans un modèle de lancement**
+ Utilisez la [create-launch-template](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-launch-template.html)commande pour créer le modèle de lancement. Pour spécifier l’AMI à utiliser, saisissez le nom du paramètre Systems Manager en utilisant l’un des formats suivants :

  Pour référencer un paramètre public :
  + **resolve:ssm:*public-parameter***

  Pour référencer un paramètre stocké dans le même compte :
  + **resolve:ssm:*parameter-name***
  + **resolve:ssm:*parameter-name*:*version-number***
  + **resolve:ssm:*parameter-name*:*label***

  Pour référencer un paramètre partagé par un autre Compte AWS :
  + **resolve:ssm:*parameter-ARN***
  + **resolve:ssm:*parameter-ARN*:*version-number***
  + **resolve:ssm:*parameter-ARN*:*label***

  L’exemple suivant crée un modèle de lancement qui spécifie ce qui suit :
  + Nom du modèle de lancement (`TemplateForWebServer`)
  + Une balise pour le modèle de lancement (`purpose`=`production`)
  + Les données de la configuration de l’instance, spécifiées dans un fichier JSON :
    + L’AMI à utiliser (`resolve:ssm:golden-ami`)
    + Le type d’instance à lancer (`m5.4xlarge`)
    + Une balise pour l’instance (`Name`=`webserver`)

  ```
  aws ec2 create-launch-template \
      --launch-template-name TemplateForWebServer \
      --tag-specifications 'ResourceType=launch-template,Tags=[{Key=purpose,Value=production}]' \
      --launch-template-data file://template-data.json
  ```

  Voici un exemple de fichier JSON contenant les données du modèle de lancement pour la configuration de l’instance. La valeur pour `ImageId` est le nom du paramètre Systems Manager, saisi au format requis `resolve:ssm:golden-ami`.

  ```
  {"LaunchTemplateData": {
      "ImageId": "resolve:ssm:golden-ami",
      "InstanceType": "m5.4xlarge",
      "TagSpecifications": [{
          "ResourceType": "instance",
          "Tags": [{
              "Key":"Name",
              "Value":"webserver"
          }]
      }]
    }
  }
  ```

------

### Vérifiez qu’un modèle de lancement obtient le bon ID d’AMI
<a name="ssm-parameter-verify-ami-id"></a>

**Pour convertir le paramètre Systems Manager en ID AMI réel**  
Utilisez la [describe-launch-template-versions](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-launch-template-versions.html)commande et incluez le `--resolve-alias` paramètre.

```
aws ec2 describe-launch-template-versions \
    --launch-template-name my-launch-template \
    --versions $Default \
    --resolve-alias
```

La réponse inclut l’ID d’AMI pour`ImageId`. Dans cet exemple, lorsqu’une instance est lancée à l’aide de ce modèle de lancement, l’ID d’AMI est défini sur `ami-0ac394d6a3example`.

```
{
    "LaunchTemplateVersions": [
        {
            "LaunchTemplateId": "lt-089c023a30example",
            "LaunchTemplateName": "my-launch-template",
            "VersionNumber": 1,
            "CreateTime": "2022-12-28T19:52:27.000Z",
            "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
            "DefaultVersion": true,
            "LaunchTemplateData": {
                "ImageId": "ami-0ac394d6a3example",
                "InstanceType": "t3.micro",
            }
        }
    ]
}
```

### Ressources connexes
<a name="ssm-parameter-related-resources"></a>

Pour plus d’informations sur l’utilisation des paramètres Systems Manager, consultez les documents de référence suivants dans la documentation Systems Manager.
+ Pour plus d’informations sur la façon de rechercher les paramètres publics de l’AMI pris en charge par Amazon EC2, consultez la section Appeler les paramètres [publics de l’AMI](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-public-parameters-ami.html).
+ Pour plus d'informations sur le partage de paramètres avec d'autres AWS comptes ou via d'autres comptes AWS Organizations, consultez la section [Utilisation de paramètres partagés](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html).
+ Pour plus d'informations sur le suivi de la création réussie de vos paramètres, consultez la section [Prise en charge des paramètres natifs pour Amazon Machine Image IDs](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-ec2-aliases.html).

### Limitations
<a name="ssm-parameter-limitations"></a>
+ Seules les flottes EC2 de type `instant` prennent en charge l’utilisation d’un modèle de lancement dont le paramètre Systems Manager (gestionnaire de systèmes) est spécifié à la place de l’ID d’AMI.
+ Les flottes EC2 de type `maintain` et `request`, et les flottes Spot ne prennent pas en charge l’utilisation d’un modèle de lancement dont le paramètre Systems Manager (gestionnaire de systèmes) est spécifié à la place de l’ID d’AMI. Pour les flottes EC2 de type `maintain` et `request`, les parcs d’instances Spot, si vous spécifiez une AMI dans le modèle de lancement, vous devez spécifier l’ID d’AMI.
+ Si vous utilisez la [sélection d’instance basée sur les attributs](ec2-fleet-attribute-based-instance-type-selection.md) dans votre parc EC2, vous ne pouvez pas spécifier de paramètre Systems Manager à la place d’un ID AMI. Lorsque vous utilisez la sélection d’instance basée sur les attributs, vous devez spécifier l’ID de l’AMI.
+ Amazon EC2 Auto Scaling fournit d’autres restrictions. Pour plus d'informations, consultez la section [Utiliser des AWS Systems Manager paramètres plutôt que des AMI IDs dans les modèles de lancement](https://docs.aws.amazon.com/autoscaling/ec2/userguide/using-systems-manager-parameters.html) dans le manuel *Amazon EC2 Auto Scaling User Guide*.