Utilisation d'AMIalias dans AWS Marketplace

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

Lorsque vous lancez un produit à partir de AWS Marketplace, AMI ID il est automatiquement renseigné pour vous. AMI IDIl 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 (AmazonEC2). Vous pouvez trouver le AMI ID moment où vous configurez votre logiciel au moment du lancement. Pour plus d’informations, consultez Étape 3 : Configuration de votre logiciel.

Ami AliasIl se trouve également au même endroit que leAMI ID, lors de la configuration de votre logiciel. Ami AliasIl s'agit d'un identifiant similaire auAMI ID, mais il est plus facile à utiliser en automatisation. An AMI alias a la formeaws/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éeAMI 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 version la plus récente 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 d'AMIalias

AMIles alias sont utiles en automatisation. Vous pouvez les utiliser dans AWS CLI ou dans les AWS CloudFormation modèles.

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

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

L'exemple suivant montre un CloudFormation modèle qui accepte l'AMIalias 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