本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 列出映像和建置版本
在**映像**建置器主控台的映像頁面上，您可以查看您擁有、與您共用，以及您有權存取的所有映像建置器映像資源清單。清單結果包含有關這些資源的一些關鍵詳細資訊。
您也可以查看帳戶中具有待定工作流程動作的所有映像。
**Topics**
+ [
## 列出影像
](#list-images)
+ [
## 列出等待動作的影像
](#list-images-waiting-for-action)
+ [
## 列出映像建置版本
](#list-image-build-versions)
## 列出影像
本節說明列出映像相關資訊的不同方式。
您可以使用下列其中一種方法來列出您有權存取的映像建置器映像資源。如需 API 動作，請參閱 *EC2 Image Builder API 參考*中的 [ListImages](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImages.html)。如需相關聯的 SDK 請求，請參閱相同頁面上的 [See Also](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 為此映像資源 (AMI 或容器映像） 建立的輸出映像類型。
**平台**
映像資源的作業系統平台，例如「Linux」、「Windows」或「macOS」。
**影像來源**
Image Builder 用來建置此映像資源的基本映像原始伺服器。這主要用於篩選從虛擬機器 (**VMIE**) 匯入之映像的結果。
**建立時間**
Image Builder 建立影像資源目前版本的日期和時間。
**ARN**
影像資源目前版本的 Amazon Resource Name (ARN)。
#### 主控台標籤：與我共用
在**與我共用**索引標籤中，您可以使用下列篩選條件來簡化影像清單結果。
+ 您可以在搜尋列中搜尋全部或部分名稱。
+ 您可以根據映像的作業系統平台 (Windows、Linux 或 macOS) 來篩選映像。
+ 您可以根據產生的輸出類型 (AMI 或容器映像） 來篩選映像。
+ 您可以使用**篩選來源**來尋找從虛擬機器 (VMIE) 或從 ISO 磁碟映像匯入的影像。
在篩選條件控制之後，**與我共用**索引標籤會顯示與您共用的映像建置器映像清單，其中包含所列資源的下列詳細資訊：
**映像名稱**
與您共用的映像資源名稱。若要在配方中使用共用映像，請選取**選取受管映像**選項，並將**映像原始**伺服器變更為**與我共用的映像**。
**類型**
Image Builder 為此映像資源 (AMI 或容器映像） 建立的輸出映像類型。
**版本**
映像資源的作業系統平台版本，通常是下列格式的數值欄位：..。
**影像來源**
映像建置器用來建置此映像資源之基礎映像的原始伺服器，如適用。這主要用於篩選從虛擬機器 (**VMIE**) 匯入之映像的結果。
**平台**
映像資源的作業系統平台，例如「Linux」、「Windows」或「macOS」。
**建立時間**
Image Builder 建立與您共用之映像資源版本的日期和時間。
**擁有者**
共用映像資源的擁有者。
**ARN**
與您共用之映像資源版本的 Amazon Resource Name (ARN)。
#### 主控台標籤：由 Amazon 管理
在 **Managed by Amazon** 索引標籤中，您可以使用下列篩選條件來簡化映像清單結果。
+ 您可以在搜尋列中搜尋全部或部分名稱。
+ 您可以根據映像的作業系統平台 (Windows、Linux 或 macOS) 來篩選映像。
+ 您可以根據產生的輸出類型 (AMI 或容器映像） 來篩選映像。
+ 您可以使用**篩選來源**來尋找從虛擬機器 (VMIE) 或從 ISO 磁碟映像匯入的影像。
在篩選條件控制之後，**Managed by Amazon** 索引標籤會顯示 Amazon 受管映像建置器映像的清單，您可以將其做為配方的基礎映像。Image Builder 會顯示所列資源的下列詳細資訊：
**映像名稱**
受管映像的名稱。當您建立配方時，基礎映像的預設值為 **Quick Start (Amazon 受管）**。此索引標籤中列出的映像會填入與您在建立配方時為基礎映像選擇的作業系統平台相關聯的**映像名稱**清單。
**類型**
Image Builder 為此映像資源 (AMI 或容器映像） 建立的輸出映像類型。
**版本**
映像資源的作業系統平台版本，通常是下列格式的數值欄位：..。
**平台**
映像資源的作業系統平台，例如「Linux」、「Windows」或「macOS」。
**建立時間**
Image Builder 建立與您共用之映像資源版本的日期和時間。
**擁有者**
Amazon 擁有受管映像。
**ARN**
與您共用之映像資源版本的 Amazon Resource Name (ARN)。
### 使用 AWS CLI 命令列出映像
當您在 中執行 **[list-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html)**命令時 AWS CLI，您可以取得您擁有或可存取的映像清單。
下列命令範例示範如何在沒有篩選條件的情況下使用 **list-images**命令，以列出您擁有的所有映像建置器映像資源。
**範例：列出所有映像**
```
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**命令時，您可以套用篩選條件來簡化結果，如下列範例所示。如需如何篩選結果的詳細資訊，請參閱《 命令參考》中的 [list-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html) 命令。 *AWS CLI *
**範例：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 動作，請參閱 *EC2 Image 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 Resource Name (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"
}
]
}
```
------
## 列出映像建置版本
在**映像建置器主控台的映像建置版本**頁面上，您可以查看建置版本清單，以及您擁有之映像資源的其他詳細資訊。您也可以搭配映像建置器 API、 SDKs 或 使用命令或動作 AWS CLI 來列出映像建置版本。
您可以使用下列其中一種方法來列出您擁有之映像資源的映像建置版本。如需 API 動作，請參閱 *EC2 Image Builder API 參考*中的 [ListImageBuildVersions](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImageBuildVersions.html)。如需相關聯的 SDK 請求，請參閱相同頁面上的 [See Also](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImageBuildVersions.html#API_ListImageBuildVersions_SeeAlso) 連結。
------
#### [ Console ]
**版本詳細資訊**
**映像建置器主控台中映像建置版本**頁面的詳細資訊包括下列項目：
+ **版本** – 映像資源建置版本。在映像建置器主控台中，版本會連結至映像詳細資訊頁面。
+ **類型** – Image Builder 在建立此映像資源 (AMI 或容器映像） 時所分佈的輸出類型。
+ **建立日期** – Image Builder 建立映像建置版本的日期和時間。
+ **影像狀態** – 影像建置版本的目前狀態。狀態可以與映像建置或處置相關。例如，在建置過程中，您可能會看到 `Building`或 的狀態`Distributing`。對於影像的處置，您可能會看到狀態為 `Deprecated`或 `Deleted`。
+ **失敗原因** – 影像狀態的原因。Image Builder 主控台只會顯示建置失敗的原因 (**映像狀態**等於 `Failed`)。
+ **安全性問題清單** – 參考影像建置版本的彙總影像掃描問題清單。
+ **ARN** – 影像資源參考版本的 Amazon Resource Name (ARN)。
+ **日誌串流** – 參考影像建置版本的日誌串流詳細資訊連結。
**列出版本**
若要在映像建置器主控台中列出映像建置版本，請執行下列步驟：
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** 命令的輸出目前不包含安全性問題清單或日誌串流。
------