本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 列出映像和构建版本
在 Image Builder 控制台的**映像**页面上，您可以看到您拥有、与您共享以及您有权访问的所有 Image Builder 映像资源的列表。列表结果包括有关这些资源的一些关键详细信息。
您还可以查看账户中所有待处理工作流操作的映像。
**Topics**
+ [列出映像](#list-images)
+ [列出等待操作的映像](#list-images-waiting-for-action)
+ [列出映像构建版本](#list-image-build-versions)
## 列出映像
本节介绍列出映像相关信息的不同方式。
您可以使用以下方法之一列出您有权访问的 Image Builder 映像资源。有关 API 操作，请参阅 I *EC2 mage Builder API 参考[ListImages](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImages.html)*中的。有关关联的 SDK 请求，请参阅同一页面上的[另请参阅](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImages.html#API_ListImages_SeeAlso)链接。
**Topics**
+ [在控制台中列出映像](#list-images-console)
+ [使用 AWS CLI 命令列出图像](#list-images-cli)
### 在控制台中列出映像
要在控制台中打开**映像**列表页面，请执行以下步骤：
1. 打开 EC2 Image Builder 控制台，网址为[https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)。
1. 从导航窗格中，选择**映像**。
根据映像所有权或待处理的工作流操作，控制台中的**映像**页面分为多个选项卡。本节介绍前三个选项卡，这些选项卡显示了您拥有或有权访问的映像。
#### “控制台”选项卡：我拥有的
在**我拥有的**选项卡中，您可以使用以下筛选条件来简化映像列表结果。
+ 您可以在搜索栏中搜索完整或部分名称。
+ 您可以根据映像的操作系统平台（Windows、Linux 或 macOS）筛选映像。
+ 您可以根据映像生成的输出类型（AMI 或容器映像）筛选映像。
+ 您可以使用**筛选源**来查找从虚拟机 (VMIE) 或 ISO 磁盘映像导入的图像。
根据筛选条件控件，**我拥有的**选项卡会显示您创建的 Image Builder 映像列表，以及所列资源的以下详细信息：
**名称/版本**
Image Builder 映像资源名称以配方名称和其构建版本开头。选择该链接以查看所有相关的映像构建版本。
**类型**
Image Builder 在创建此映像资源（AMI 或容器映像）时的输出映像类型。
**平台**
映像资源的操作系统平台，例如“Linux”、“Windows”或“macOS”。
**映像来源**
Image Builder 用于构建此映像资源的基础映像的来源。主要用于筛选从虚拟机（**VMIE**）导入的映像结果。
**Creation time**
Image Builder 创建当前版本映像资源的日期和时间。
**ARN**
当前版本映像资源的 Amazon 资源名称（ARN）。
#### “控制台”选项卡：与我共享
在**与我共享**选项卡中，您可以使用以下筛选条件来简化映像列表结果。
+ 您可以在搜索栏中搜索完整或部分名称。
+ 您可以根据映像的操作系统平台（Windows、Linux 或 macOS）筛选映像。
+ 您可以根据映像生成的输出类型（AMI 或容器映像）筛选映像。
+ 您可以使用**筛选源**来查找从虚拟机 (VMIE) 或 ISO 磁盘映像导入的图像。
根据筛选条件控件，**与我共享**选项卡会显示与您共享的 Image Builder 映像列表，以及所列资源的以下详细信息：
**映像名称**
与您共享的映像资源的名称。要在配方中使用共享映像，请选择**选择托管映像**选项，然后将**映像来源**更改为**与我共享的映像**。
**类型**
Image Builder 在创建此映像资源（AMI 或容器映像）时的输出映像类型。
**版本**
映像资源的操作系统平台版本，通常是以下格式的数字字段：..。
**映像来源**
Image Builder 用于构建此映像资源的基础映像的来源（如适用）。主要用于筛选从虚拟机（**VMIE**）导入的映像结果。
**平台**
映像资源的操作系统平台，例如“Linux”、“Windows”或“macOS”。
**Creation time**
Image Builder 创建与您共享的映像资源版本的日期和时间。
**所有者**
共享映像资源的所有者。
**ARN**
与您共享的映像资源版本的 Amazon 资源名称（ARN）。
#### “控制台”选项卡：由 Amazon 管理
在**由 Amazon 管理**选项卡中，您可以使用以下筛选条件来简化映像列表结果。
+ 您可以在搜索栏中搜索完整或部分名称。
+ 您可以根据映像的操作系统平台（Windows、Linux 或 macOS）筛选映像。
+ 您可以根据映像生成的输出类型（AMI 或容器映像）筛选映像。
+ 您可以使用**筛选源**来查找从虚拟机 (VMIE) 或 ISO 磁盘映像导入的图像。
根据筛选条件控件，**由 Amazon 管理**选项卡会显示 Amazon 管理的 Image Builder 映像列表，您可以将其用作配方的基础映像。Image Builder 会显示所列资源的以下详细信息：
**映像名称**
托管映像的名称。创建配方时，基础映像的默认设置为**快速启动（由 Amazon 管理）**。此选项卡中列出的映像将填充与您在创建配方时为基础映像选择的操作系统平台关联的**映像名称**列表。
**类型**
Image Builder 在创建此映像资源（AMI 或容器映像）时的输出映像类型。
**版本**
映像资源的操作系统平台版本，通常是以下格式的数字字段：..。
**平台**
映像资源的操作系统平台，例如“Linux”、“Windows”或“macOS”。
**Creation time**
Image Builder 创建与您共享的映像资源版本的日期和时间。
**所有者**
Amazon 拥有这些托管映像。
**ARN**
与您共享的映像资源版本的 Amazon 资源名称（ARN）。
### 使用 AWS CLI 命令列出图像
在中运行**[list-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html)**命令时 AWS CLI，您可以获得自己拥有或有权访问的图像的列表。
以下命令示例演示了如何使用不带筛选条件的 **list-images** 命令列出您拥有的所有 Image Builder 映像资源。
**示例：列出所有映像**
```
aws imagebuilder list-images
```
**输出：**
```
{
"requestId": "1abcd234-e567-8fa9-0123-4567b890cd12",
"imageVersionList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0",
"name": "image-recipe-name",
"type": "AMI",
"version": "1.0.0",
"platform": "Linux",
"owner": "123456789012",
"dateCreated": "2022-04-28T01:38:23.286Z"
},
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-win/1.0.1",
"name": "image-recipe-win",
"type": "AMI",
"version": "1.0.1",
"platform": "Windows",
"owner": "123456789012",
"dateCreated": "2022-04-28T01:38:23.286Z"
},
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-macos/1.1.1",
"name": "image-recipe-macos",
"type": "AMI",
"version": "1.1.1",
"platform": "macOS",
"owner": "123456789012",
"dateCreated": "2022-04-28T01:38:23.286Z"
}
]
}
```
运行 **list-images** 命令时，可以应用筛选器来简化结果，如以下示例所示。有关如何筛选结果的更多信息，请参阅*AWS CLI 命令引用*中的 [list-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html) 命令。
**示例：筛选 Linux 映像**
```
aws imagebuilder list-images --filters name="platform",values="Linux"
```
**输出**：
```
{
"requestId": "1abcd234-e567-8fa9-0123-4567b890cd12",
"imageVersionList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0",
"name": "image-recipe-name",
"type": "AMI",
"version": "1.0.0",
"platform": "Linux",
"owner": "123456789012",
"dateCreated": "2022-04-28T01:38:23.286Z"
}
]
}
```
## 列出等待操作的映像
当您在映像工作流中使用 `WaitForAction` 步骤操作时，其会暂停工作流，直到您向其发送恢复处理或使工作流失败的信号。如果需要在继续操作前运行某个外部进程，则可以使用此步骤操作。然后，您可以使用 `SendWorkflowStepAction` 将暂停步骤的信号发送到 `RESUME` 或 `STOP`。您也可以通过控制台停止或恢复工作流。
以下选项卡显示了如何获取账户中所有映像资源的列表，其中包含当前暂停以等待信号恢复或停止的工作流步骤。这些选项卡涵盖了控制台步骤和 AWS CLI 命令。
您还可以使用 API 或 SDK 来获取等待操作的工作流步骤列表。有关 API 操作，请参阅 I *EC2 mage Builder API 参考[ListWaitingWorkflowSteps](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListWaitingWorkflowSteps.html)*中的。有关关联的 SDK 请求，请参阅同一页面上的[另请参阅](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListWaitingWorkflowSteps.html#API_ListWaitingWorkflowSteps_SeeAlso)链接。
------
#### [ Console ]
要进入控制台中的**等待操作**选项卡，请按照以下步骤操作：
1. 打开 EC2 Image Builder 控制台，网址为[https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)。
1. 从导航窗格中，选择**映像**。此操作将打开**映像**列表页面。
1. 从列表页面中选择**等待操作**选项卡。
1. （可选）要停止或恢复步骤，请选中名称旁边的复选框，然后选择**停止步骤**或**恢复步骤**。您可以选中多个复选框，对所有选定步骤执行相同的操作。
**待处理的工作流步骤详细信息**
待处理步骤的工作流详细信息包括以下内容：
+ **映像名称** – 包含待处理步骤的映像资源名称。您可以选择名称链接以显示该映像的详情页面。
+ **待处理步骤名称** – 等待操作的工作流步骤名称。
+ **步骤执行 ID** – 对工作流步骤的运行时实例进行唯一标识。您可以选择链接的 ID 以显示该步骤的运行时详细信息。
+ **步骤启动** – 工作流步骤的运行时实例启动时的时间戳。
+ **工作流 ARN** – 包含待处理步骤的工作流的 Amazon 资源名称（ARN）。
+ **操作** – 处于等待状态的步骤操作。
------
#### [ AWS CLI ]
当你运行中的**[list-waiting-workflow-steps](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-waiting-workflow-steps.html)**命令时 AWS CLI，你会得到一份清单，列出你账户中所有有工作流程步骤在完成图像创建过程之前等待操作的图片。
以下命令示例演示了如何使用 **list-waiting-workflow-steps** 命令列出您账户中的所有映像，其中包含正在等待操作的工作流步骤。
**示例：列出账户中包含等待工作流步骤的映像**
```
aws imagebuilder list-waiting-workflow-steps
```
**输出**：
此示例的输出显示了账户中的一个映像，其中有一个步骤正在等待操作。
```
{
"steps": [
{
"imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:image/example-image/1.0.0/8",
"name": "WaitForAction",
"workflowExecutionId": "wf-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"stepExecutionId": "step-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/test/wait-for-action/1.0.0/1",
"startTime": "2023-11-21T23:21:23.609Z",
"action": "WaitForAction"
}
]
}
```
------
## 列出映像构建版本
在 Image Builder 控制台的**映像构建版本**页面上，您可以看到构建版本列表以及您拥有的映像资源的更多详细信息。您还可以在 Image Builder API 中使用命令或操作 AWS CLI 来列出映像构建版本。 SDKs
您可以使用以下方法之一列出您拥有的映像资源的映像构建版本。有关 API 操作，请参阅 I *EC2 mage Builder API 参考[ListImageBuildVersions](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImageBuildVersions.html)*中的。有关关联的 SDK 请求，请参阅同一页面上的[另请参阅](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImageBuildVersions.html#API_ListImageBuildVersions_SeeAlso)链接。
------
#### [ Console ]
**版本详细信息**
Image Builder 控制台中**映像构建版本**页面上的详细信息包括以下内容：
+ **版本** - 映像资源构建版本。在 Image Builder 控制台中，该版本链接到映像详细信息页面。
+ **类型** – Image Builder 在创建此映像资源（AMI 或容器映像）时分发的输出类型。
+ **创建日期** – Image Builder 创建映像构建版本的日期和时间。
+ **映像状态** - 映像构建版本的当前状态。状态可能与映像构建或处置有关。例如，在构建 过程中，您可能会看到`Building` 或 `Distributing` 的状态。有关映像的处置情况，您可能会看到 `Deprecated` 或的状态`Deleted`。
+ **失败原因** – 映像状态的原因。Image Builder 控制台仅显示构建失败的原因（**映像状态**等于 `Failed`）。
+ **安全调查结果** – 所引用映像构建版本的聚合映像扫描调查发现。
+ **ARN** – 映像资源引用版本的 Amazon 资源名称（ARN）。
+ **日志流** – 指向所引用映像构建版本的日志流详细信息的链接。
**列出版本**
要在 Image Builder 控制台中列出映像构建版本，请执行以下步骤：
1. 打开 EC2 Image Builder 控制台，网址为[https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)。
1. 从导航窗格中，选择 **映像**。默认情况下，映像列表显示您拥有的每个映像的当前版本。
1. 要查看映像的所有版本列表，请选择当前版本链接。该链接将打开**映像构建版本**页面，其中列出了特定映像的所有构建版本。
------
#### [ AWS CLI ]
在中运行**[list-image-build-versions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-build-versions.html)**命令时 AWS CLI，您将获得指定图像资源的完整构建版本列表。您必须是映像的拥有者才能执行此命令。
以下命令示例说明如何使用 **list-image-build-versions** 命令列出指定映像的所有构建版本。
**示例：列出特定映像的构建版本**
```
aws imagebuilder list-image-build-versions --image-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0
```
**输出**：
此示例的输出包括指定映像配方的两个构建版本。
```
{
"requestId": "12f3e45d-67cb-8901-af23-45ed678c9b01",
"imageSummaryList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0/2",
"name": "image-recipe-name",
"type": "AMI",
"version": "1.0.0/2",
"platform": "Linux",
"osVersion": "Amazon Linux 2",
"state": {
"status": "AVAILABLE"
},
"owner": "123456789012",
"dateCreated": "2023-03-10T01:04:40.609Z",
"outputResources": {
"amis": [
{
"region": "us-west-2",
"image": "ami-012b3456789012c3d",
"name": "image-recipe-name 2023-03-10T01-05-12.541Z",
"description": "First verison of image-recipe-name",
"accountId": "123456789012"
}
]
},
"tags": {}
},
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0/1",
"name": "image-recipe-name",
"type": "AMI",
"version": "1.0.0/1",
"platform": "Linux",
"osVersion": "Amazon Linux 2",
"state": {
"status": "AVAILABLE"
},
"owner": "123456789012",
"dateCreated": "2023-03-10T00:07:16.384Z",
"outputResources": {
"amis": [
{
"region": "us-west-2",
"image": "ami-0d1e23456789f0a12",
"name": "image-recipe-name 2023-03-10T00-07-18.146132Z",
"description": "First verison of image-recipe-name",
"accountId": "123456789012"
}
]
},
"tags": {}
}
]
}
```
**注意**
**list-image-build-versions** 命令的输出目前不包括安全调查发现或日志流。
------