

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.

# Utilisation d'alias d'AMI dans AWS Marketplace
<a name="buyer-ami-aliases"></a>

Une Amazon Machine Image (AMI) est identifiée par un`AMI ID`. Vous pouvez utiliser le `AMI ID` pour indiquer l'AMI que vous souhaitez utiliser lors du lancement d'un produit. `AMI ID`Il a la forme`ami-<identifier>`, par exemple, ami-123example456. Chaque version de chaque produit Région AWS possède une AMI différente (et différente`AMI ID`).

Lorsque vous lancez un produit à partir de AWS Marketplace, `AMI ID` il est automatiquement renseigné pour vous. `AMI ID`Il est utile de disposer du si vous souhaitez automatiser le lancement de produits depuis AWS Command Line Interface (AWS CLI) ou en utilisant Amazon Elastic Compute Cloud (Amazon EC2). Vous pouvez trouver le `AMI ID` moment où vous configurez votre logiciel au moment du lancement. Pour de plus amples informations, veuillez consulter [Étape 3 : Configuration de votre logiciel](tutorial-buying-ami.md#step-3-configure-your-software). 

`Ami Alias`Il se trouve également au même endroit que le`AMI ID`, lors de la configuration de votre logiciel. `Ami Alias`Il s'agit d'un identifiant similaire au`AMI ID`, mais il est plus facile à utiliser en automatisation. An `AMI alias` a la forme`aws/service/marketplace/prod-<identifier>/<version>`, par exemple,` aws/service/marketplace/prod-1234example5678/12.2`. Vous pouvez utiliser cet `Ami Alias` identifiant dans n'importe quelle région et le mapper AWS automatiquement à la région appropriée`AMI ID`. 

Si vous souhaitez utiliser la version la plus récente d'un produit, utilisez le terme « **latest** à la place de la version » dans le « `AMI alias` so » qui AWS choisit pour vous la version la plus récente du produit, par exemple,**aws/service/marketplace/prod-1234example5678/latest**.

**Avertissement**  
L'utilisation de **latest** cette option vous permet d'accéder à la dernière version du logiciel. Toutefois, utilisez cette fonctionnalité avec prudence. Par exemple, si les versions 1.x et 2.x d'un produit sont disponibles, vous utilisez peut-être la version 2.x. Cependant, la version la plus récente du produit peut corriger un bogue pour la version 1.x.

## Exemples d'utilisation des alias d'AMI
<a name="buyer-ami-alias-examples"></a>

Les alias AMI sont utiles pour l'automatisation. Vous pouvez les utiliser dans AWS CLI ou dans les CloudFormation modèles.

L'exemple suivant montre comment utiliser un alias d'AMI pour lancer une instance à l'aide du AWS CLI.

```
aws ec2 run-instances
--image-id resolve:ssm:/aws/service/marketplace/prod-<identifier>/version-7.1
--instance-type m5.xlarge
--key-name MyKeyPair
```

L'exemple suivant montre un CloudFormation modèle qui accepte l'alias AMI comme paramètre d'entrée pour créer une instance.

```
AWSTemplateFormatVersion: 2010-09-09

Parameters:
    AmiAlias:
        Description: AMI alias
        Type: 'String'
        
Resources:
    MyEC2Instance:
        Type: AWS::EC2::Instance
        Properties:
            ImageId: !Sub "resolve:ssm:${AmiAlias}"
            InstanceType: "g4dn.xlarge"
            Tags:
                -Key: "Created from"
                 Value: !Ref AmiAlias
```