本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

Amazon Machine Image (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 ID`， `Ami Alias` 也位於與 相同的位置。`Ami Alias` 是與 類似的 ID`AMI 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 它們。

下列範例顯示使用 AMI 別名，透過使用 啟動執行個體 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
```

下列範例顯示 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
```