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
<a name="buyer-ami-aliases"></a>

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](tutorial-buying-ami.md#step-3-configure-your-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
<a name="buyer-ami-alias-examples"></a>

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
```