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

# 查找 DLAMI 的 ID
<a name="find-dlami-id"></a>

每个 DLAMI 都有唯一标识符（ID）。当您使用 Amazon EC2 控制台启动 DLAMI 实例时，可以选择使用 DLAMI ID 来搜索要使用的 DLAMI。当您使用 AWS Command Line Interface（AWS CLI）启动 DLAMI 实例时，需要此 ID。

可以使用 AWS CLI 命令为 Amazon EC2 或 Parameter Store（AWS Systems Manager 的一项功能）查找所选 DLAMI 的 ID。有关安装和配置 AWS CLI 的说明，请参阅《AWS Command Line Interface 用户指南》**中的 [Get started with the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started)。

------
#### [ Using Parameter Store ]

**使用 **ssm get-parameter** 查找 DLAMI ID**

在以下 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm/get-parameter.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm/get-parameter.html) 命令中，对于 `--name` 选项，参数名称格式为 */aws/service/deeplearning/ami/\$1architecture/\$1ami\$1type/latest/ami-id*。在该名称格式中，*architecture* 可以是 **x86\$164** 或 **arm64**。通过使用 DLAMI 名称并移除关键字“deep”、“learning”和“ami”来指定 *ami\$1type*。可以在 [深度学习 AMIs 发行说明](appendix-ami-release-notes.md)中找到 AMI 名称。
**重要**  
要使用此命令，您使用的 AWS Identity and Access Management（IAM）主体必须具有 `ssm:GetParameter` 权限。有关 IAM 主体的更多信息，请参阅《IAM 用户指南》**中 **IAM 角色**的[其他资源](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#id_roles_additional-resources)部分。
+ 

  ```
  aws ssm get-parameter --name /aws/service/deeplearning/ami/x86_64/base-oss-nvidia-driver-ubuntu-22.04/latest/ami-id  \
  --region us-east-1 --query "Parameter.Value" --output text
  ```

  该输出值应该类似于以下内容：

  ```
  ami-09ee1a996ac214ce7
  ```
**提示**  
对于目前支持的一些 DLAMI 框架，可以在 [深度学习 AMIs 发行说明](appendix-ami-release-notes.md)中找到更具体的示例 **ssm get-parameter** 命令。选择指向所选 DLAMI 的发布说明的链接，然后在发布说明中查找其 ID 查询。

------
#### [ Using Amazon EC2 CLI ]

**使用 **ec2 describe-images** 查找 DLAMI ID**

在以下 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-images.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-images.html) 命令中，对于筛选条件 `Name=name` 的值，输入 DLAMI 名称。可以为给定的框架指定发布版本，也可以通过将版本号替换为问号（?）来获取最新版本。
+ 

  ```
  aws ec2 describe-images --region us-east-1 --owners amazon \
  --filters 'Name=name,Values=Deep Learning Base OSS Nvidia Driver GPU AMI (Ubuntu 22.04) ????????' 'Name=state,Values=available' \
  --query 'reverse(sort_by(Images, &amp;CreationDate))[:1].ImageId' --output text
  ```

  该输出值应该类似于以下内容：

  ```
  ami-09ee1a996ac214ce7
  ```
**提示**  
有关特定于您选择的 DLAMI 的示例 **ec2 describe-images** 命令，请参阅 [深度学习 AMIs 发行说明](appendix-ami-release-notes.md)。选择指向所选 DLAMI 的发布说明的链接，然后在发布说明中查找其 ID 查询。

------

**后续步骤**  
[启动 DLAMI 实例](launch.md)