Usar aliases de AMI do AWS Marketplace - AWS Marketplace
Exemplos de uso de aliases de AMI

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Usar aliases de AMI do AWS Marketplace

Uma imagem de máquina da Amazon (AMI) é identificada com um AMI ID. Você pode usar o AMI ID para indicar qual AMI deseja usar ao executar um produto. O AMI ID tem o formato ami-<identifier>, por exemplo, ami-123example456. Cada versão de cada produto em cada Região da AWS tem uma AMI diferente (e um AMI ID diferente).

Quando você executa um produto no AWS Marketplace, o AMI ID é preenchido automaticamente. Você pode usar AMI ID se quiser automatizar a execução de produtos no AWS Command Line Interface (AWS CLI) ou usando o Amazon Elastic Compute Cloud (Amazon EC2). Você pode encontrar o AMI ID ao configurar o software no momento da inicialização. Para obter mais informações, consulte Etapa 3: configurar o software.

O Ami Alias também está no mesmo local do AMI ID, ao configurar o software. O Ami Alias é um ID semelhante ao AMI ID, mas é mais fácil de usar na automação. Um AMI alias tem o formato aws/service/marketplace/prod-<identifier>/<version>, por exemplo, aws/service/marketplace/prod-1234example5678/12.2. Você pode usar esse ID do Ami Alias em qualquer região e a AWS vai mapeá-lo automaticamente para o AMI ID regional correto.

Se você quiser usar a versão mais recente de um produto, use o termo latest no lugar da versão no AMI alias para que a AWS escolha a versão mais recente do produto para você, por exemplo, aws/service/marketplace/prod-1234example5678/latest.

Atenção

O uso da opção latest fornece a versão mais recente do software. No entanto, use esse atributo com cuidado. Por exemplo, se um produto tiver as versões 1.x e 2.x disponíveis, você talvez esteja usando 2.x. No entanto, a versão mais recente do produto pode ser uma correção de bug para 1.x.

Exemplos de uso de aliases de AMI

Os aliases da AMI são úteis na automação. Você pode usá-los no AWS CLI ou em modelos do CloudFormation.

O exemplo a seguir mostra como usar um alias de AMI para executar uma instância usando o 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

O exemplo a seguir mostra um modelo do CloudFormation que aceita o alias da AMI como parâmetro de entrada para criar uma instância.

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