本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 AWS Marketplace 中使用 AMI 别名
<a name="buyer-ami-aliases"></a>

亚马逊机器映像 (AMI) 使用 `AMI ID` 进行标识。您可以使用 `AMI ID` 来指明在启动产品时要使用哪个 AMI。`AMI ID` 的格式为 `ami-<identifier>`，例如 ami-123example456。每个 AWS 区域中每个产品的每个版本都有不同的 AMI（以及不同的 `AMI ID`）。

当您从 AWS Marketplace 启动产品时，系统会自动为您填写 `AMI ID`。如果您想要从 AWS Command Line Interface (AWS CLI) 或使用 Amazon Elastic Compute Cloud (Amazon EC2) 自动启动产品，则可以使用 `AMI ID`。您可以在启动时配置软件时找到 `AMI ID`。有关更多信息，请参阅 [第 3 步：配置您的软件](tutorial-buying-ami.md#step-3-configure-your-software)。

配置软件时，`Ami Alias` 也与 `AMI ID` 位于同一位置。`Ami Alias` 是与 `AMI ID` 类似的 ID，但它更易于在自动化中使用。`AMI alias` 的形式为 `aws/service/marketplace/prod-<identifier>/<version>`，例如 ` aws/service/marketplace/prod-1234example5678/12.2`。您可以在任何区域使用此 `Ami Alias` ID，AWS 会自动将其映射到正确的区域 `AMI ID`。

例如，如果您想使用产品的最新版本，请使用术语 **latest** 代替 `AMI alias` 中的版本，以便 AWS 为您选择产品的最新版本，例如 **aws/service/marketplace/prod-1234example5678/latest**。

**警告**  
使用该 **latest** 选项可获得该软件的最新版本。但是，请谨慎使用此特征。例如，如果产品有 1.x 和 2.x 版本可用，则您可能使用的是 2.x。但是，该产品最新发布的版本可能是 1.x 的错误修复。

## 使用 AMI 别名的示例
<a name="buyer-ami-alias-examples"></a>

AMI 别名在自动化中非常实用。您可以在 AWS CLI 或 CloudFormation 模板中使用它们。

以下示例演示如何使用 AWS CLI 通过 AMI 别名启动实例。

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

以下示例演示 CloudFormation 模板接受 AMI 别名作为输入参数来创建实例。

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