列出映像和构建版本

在 Image Builder 控制台的映像页面上，您可以看到您拥有、与您共享以及您有权访问的所有 Image Builder 映像资源的列表。列表结果包括有关这些资源的一些关键详细信息。

您还可以查看账户中所有待处理工作流操作的映像。

内容

列出映像
列出等待操作的映像
列出映像构建版本

列出映像

本节介绍列出映像相关信息的不同方式。

您可以使用以下方法之一列出您有权访问的 Image Builder 映像资源。有关API操作，请参阅 EC2Image Builder API 参考ListImages中的。有关关联的SDK请求，请参阅同一页面上的 “另请参阅” 链接。

内容

在控制台中列出映像
使用 Amazon CLI 命令列出图像

在控制台中列出映像

要在控制台中打开映像列表页面，请执行以下步骤：

打开 EC2 Image Builder 控制台，网址为https://console.aws.amazon.com/imagebuilder/。
从导航窗格中，选择映像。

根据映像所有权或待处理的工作流操作，控制台中的映像页面分为多个选项卡。本节介绍前三个选项卡，这些选项卡显示了您拥有或有权访问的映像。

在我拥有的选项卡中，您可以使用以下筛选条件来简化映像列表结果。

您可以在搜索栏中搜索完整或部分名称。
您可以根据映像的操作系统平台（Windows、Linux 或 macOS）筛选映像。
您可以根据图像生成的输出类型（AMI或容器映像）对其进行过滤。
您可以使用 F ilter sourc e 来查找从带有的虚拟机导入的图像VMIE。

根据筛选条件控件，我拥有的选项卡会显示您创建的 Image Builder 映像列表，以及所列资源的以下详细信息：

名称/版本: Image Builder 映像资源名称以配方名称和其构建版本开头。选择该链接以查看所有相关的映像构建版本。
类型: Image Builder 为此图像资源创建的输出图像的类型（AMI或容器映像）。
平台: 映像资源的操作系统平台，例如“Linux”、“Windows”或“macOS”。
映像来源: Image Builder 用于构建此映像资源的基础映像的来源。这主要用于筛选从虚拟机导入的图像的结果 (VMIE)。
Creation time: Image Builder 创建当前版本映像资源的日期和时间。
ARN: 图片资源当前版本的 Amazon 资源名称 (ARN)。

在与我共享选项卡中，您可以使用以下筛选条件来简化映像列表结果。

您可以在搜索栏中搜索完整或部分名称。
您可以根据映像的操作系统平台（Windows、Linux 或 macOS）筛选映像。
您可以根据图像生成的输出类型（AMI或容器映像）对其进行过滤。
您可以使用 F ilter sourc e 来查找从带有的虚拟机导入的图像VMIE。

根据筛选条件控件，与我共享选项卡会显示与您共享的 Image Builder 映像列表，以及所列资源的以下详细信息：

映像名称: 与您共享的映像资源的名称。要在配方中使用共享映像，请选择选择托管映像选项，然后将映像来源更改为与我共享的映像。
类型: Image Builder 为此图像资源创建的输出图像的类型（AMI或容器映像）。
版本: 映像资源的操作系统平台版本，通常是以下格式的数字字段：<major>.<minor>.<patch>。
映像来源: Image Builder 用于构建此映像资源的基础映像的来源（如适用）。这主要用于筛选从虚拟机导入的图像的结果 (VMIE)。
平台: 映像资源的操作系统平台，例如“Linux”、“Windows”或“macOS”。
Creation time: Image Builder 创建与您共享的映像资源版本的日期和时间。
所有者: 共享映像资源的所有者。
ARN: 与您共享的图像资源版本的 Amazon 资源名称 (ARN)。

在由 Amazon 管理选项卡中，您可以使用以下筛选条件来简化映像列表结果。

您可以在搜索栏中搜索完整或部分名称。
您可以根据映像的操作系统平台（Windows、Linux 或 macOS）筛选映像。
您可以根据图像生成的输出类型（AMI或容器映像）对其进行过滤。
您可以使用 F ilter sourc e 来查找从带有的虚拟机导入的图像VMIE。

根据筛选条件控件，由 Amazon 管理选项卡会显示 Amazon 管理的 Image Builder 映像列表，您可以将其用作配方的基础映像。Image Builder 会显示所列资源的以下详细信息：

映像名称: 托管映像的名称。创建配方时，基础映像的默认设置为快速启动（由 Amazon 管理）。此选项卡中列出的映像将填充与您在创建配方时为基础映像选择的操作系统平台关联的映像名称列表。
类型: Image Builder 为此图像资源创建的输出图像的类型（AMI或容器映像）。
版本: 映像资源的操作系统平台版本，通常是以下格式的数字字段：<major>.<minor>.<patch>。
平台: 映像资源的操作系统平台，例如“Linux”、“Windows”或“macOS”。
Creation time: Image Builder 创建与您共享的映像资源版本的日期和时间。
所有者: Amazon 拥有这些托管映像。
ARN: 与您共享的图像资源版本的 Amazon 资源名称 (ARN)。

使用 Amazon CLI 命令列出图像

在中运行list-images命令时 Amazon 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 命令时，可以应用筛选器来简化结果，如以下示例所示。有关如何筛选结果的更多信息，请参阅Amazon CLI 命令引用中的 list-images 命令。

示例：筛选 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。您也可以通过控制台停止或恢复工作流。

以下选项卡显示了如何获取账户中所有映像资源的列表，其中包含当前暂停以等待信号恢复或停止的工作流步骤。这些选项卡涵盖了控制台步骤和 Amazon CLI 命令。

您也可以使用API或SDK来获取等待操作的工作流程步骤的列表。有关API操作，请参阅 EC2Image Builder API 参考ListWaitingWorkflowSteps中的。有关关联的SDK请求，请参阅同一页面上的 “另请参阅” 链接。

Console

要进入控制台中的等待操作选项卡，请按照以下步骤操作：

打开 EC2 Image Builder 控制台，网址为https://console.aws.amazon.com/imagebuilder/。
从导航窗格中，选择映像。此操作将打开映像列表页面。
从列表页面中选择等待操作选项卡。
（可选）要停止或恢复步骤，请选中名称旁边的复选框，然后选择停止步骤或恢复步骤。您可以选中多个复选框，对所有选定步骤执行相同的操作。

待处理的工作流步骤详细信息

待处理步骤的工作流详细信息包括以下内容：

映像名称 – 包含待处理步骤的映像资源名称。您可以选择名称链接以显示该映像的详情页面。
待处理步骤名称 – 等待操作的工作流步骤名称。
步骤执行 ID – 对工作流步骤的运行时实例进行唯一标识。您可以选择链接的 ID 以显示该步骤的运行时详细信息。
步骤启动 – 工作流步骤的运行时实例启动时的时间戳。
工作流程 ARN-包含待处理步骤的工作流程的 Amazon 资源名称 (ARN)。
操作 – 处于等待状态的步骤操作。

Amazon CLI

当你运行中的list-waiting-workflow-steps命令时 Amazon 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 SDKs、或中使用命令或操作 Amazon CLI 来列出映像版本版本。

您可以使用以下方法之一列出您拥有的映像资源的映像构建版本。有关API操作，请参阅 EC2Image Builder API 参考ListImageBuildVersions中的。有关关联的SDK请求，请参阅同一页面上的 “另请参阅” 链接。

Console

版本详细信息

Image Builder 控制台中映像构建版本页面上的详细信息包括以下内容：

版本 - 映像资源构建版本。在 Image Builder 控制台中，该版本链接到映像详细信息页面。
类型-Image Builder 在创建此图像资源（AMI或容器映像）时分发的输出类型。
创建日期 – Image Builder 创建映像构建版本的日期和时间。
映像状态 - 映像构建版本的当前状态。状态可能与映像构建或处置有关。例如，在构建过程中，您可能会看到Building 或 Distributing 的状态。有关映像的处置情况，您可能会看到 Deprecated 或的状态Deleted。
失败原因 – 映像状态的原因。Image Builder 控制台仅显示构建失败的原因（映像状态等于 Failed）。
安全调查结果 – 所引用映像构建版本的聚合映像扫描调查发现。
ARN— 图片资源参考版本的 Amazon 资源名称 (ARN)。
日志流 – 指向所引用映像构建版本的日志流详细信息的链接。

列出版本

要在 Image Builder 控制台中列出映像构建版本，请执行以下步骤：

打开 EC2 Image Builder 控制台，网址为https://console.aws.amazon.com/imagebuilder/。
从导航窗格中，选择映像。默认情况下，映像列表显示您拥有的每个映像的当前版本。
要查看映像的所有版本列表，请选择当前版本链接。该链接将打开映像构建版本页面，其中列出了特定映像的所有构建版本。

Amazon CLI

在中运行list-image-build-versions命令时 Amazon 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 命令的输出目前不包括安全调查发现或日志流。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

映像资源

查看映像资源详细信息