翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# イメージとビルドバージョンを一覧表示する
Image Builder コンソールの **[イメージ]** ページには、所有しているもの、共有されているもの、アクセス可能なすべての Image Builder イメージリソースのリストが表示されます。リストの結果には、それらのリソースに関する重要な詳細がいくつか含まれています。
ワークフローアクションが保留になっているアカウント内のイメージもすべて表示できます。
**Topics**
+ [イメージを一覧表示する](#list-images)
+ [アクション待ちのイメージを一覧表示する](#list-images-waiting-for-action)
+ [イメージビルドバージョンを一覧表示する](#list-image-build-versions)
## イメージを一覧表示する
このセクションでは、イメージに関する情報を一覧表示するさまざまな方法について説明します。
以下の方法のいずれかを使用して、アクセスできる Image Builder イメージリソースを一覧表示できます。API アクションについては、EC2 Image Builder API Reference の [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. [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/) で、EC2 Image Builder コンソールを開きます。
1. ナビゲーションペインから [**イメージ**] を選択します。
コンソールの **[イメージ]** ページは、イメージの所有権または保留中のワークフローアクションに基づいて、複数のタブに分かれています。このセクションでは、自分が所有している、またはアクセスできるイメージを表示する最初の 3 つのタブについて説明します。
#### コンソールタブ: 自分で所有
**[自分で所有]** タブでは、以下のフィルターを使用してイメージリストの結果を効率化できます。
+ 検索バーで名前の全部または一部を検索できます。
+ オペレーティングシステムプラットフォーム (Windows、Linux、macOS) に基づいてイメージをフィルタリングできます。
+ 生成される出力のタイプ (AMI またはコンテナイメージ) に基づいてイメージをフィルタリングできます。
+ **Filter source** を使用して、仮想マシン (VMIE) または ISO ディスクイメージからインポートされたイメージを検索できます。
フィルターコントロールに従って、**[自分で所有]** タブには、作成した Image Builder イメージのリストと、リストされたリソースに関する以下の詳細が表示されます。
**[名前 / バージョン]**
Image Builder のイメージリソース名は、ビルド元のレシピ名とバージョンで始まります。リンクを選択すると、関連するすべてのイメージビルドバージョンが表示されます。
**Type**
このイメージリソース (AMI またはコンテナイメージ) に対して Image Builder が作成する出力イメージのタイプ。
**プラットフォーム**
イメージリソースのオペレーティングシステムプラットフォーム。例えば、「Windows」、「Linux」、または「macOS」になります。
**[イメージソース]**
Image Builder がこのイメージリソースの構築に使用したベースイメージのオリジン。これは主に、仮想マシン (**[VMIE]**) からインポートされたイメージの結果をフィルタリングするために使用されます。
**作成時刻**
Image Builder が現在のバージョンのイメージリソースを作成した日付と時刻。
**ARN**
イメージリソースの現在のバージョンの Amazon リソースネーム (ARN)。
#### コンソールタブ: 自分と共有
**[自分と共有]** タブでは、以下のフィルターを使用してイメージリストの結果を効率化できます。
+ 検索バーで名前の全部または一部を検索できます。
+ オペレーティングシステムプラットフォーム (Windows、Linux、macOS) に基づいてイメージをフィルタリングできます。
+ 生成される出力のタイプ (AMI またはコンテナイメージ) に基づいてイメージをフィルタリングできます。
+ **Filter** source を使用して、仮想マシン (VMIE) または ISO ディスクイメージからインポートされたイメージを検索できます。
フィルターコントロールに従って、**[自分と共有]** タブには、共有された Image Builder イメージのリストと、リストされたリソースに関する以下の詳細が表示されます。
**[イメージ名]**
共有されたイメージリソースの名前。レシピで共有画像を使用するには、**[管理対象イメージを選択する]** オプションを選択し、**[イメージのオリジン]** を **[ユーザーと共有されたイメージ]** に変更します。
**Type**
このイメージリソース (AMI またはコンテナイメージ) に対して Image Builder が作成する出力イメージのタイプ。
**バージョン**
イメージリソースのオペレーティングシステムプラットフォームのバージョン。通常は .. という形式の数値フィールドです。
**[イメージソース]**
Image Builder がこのイメージリソースの構築に使用したベースイメージのオリジン (該当する場合)。これは主に、仮想マシン (**[VMIE]**) からインポートされたイメージの結果をフィルタリングするために使用されます。
**プラットフォーム**
イメージリソースのオペレーティングシステムプラットフォーム。例えば、「Windows」、「Linux」、または「macOS」になります。
**作成時刻**
Image Builder がユーザーと共有していたバージョンのイメージリソースを作成した日付と時刻。
**[所有者]**
共有されたイメージリソースの所有者。
**ARN**
共有されたイメージリソースバージョンの Amazon リソースネーム (ARN)。
#### コンソールタブ: Amazon が管理
**[Amazon が管理]** タブでは、以下のフィルターを使用してイメージリストの結果を効率化できます。
+ 検索バーで名前の全部または一部を検索できます。
+ オペレーティングシステムプラットフォーム (Windows、Linux、macOS) に基づいてイメージをフィルタリングできます。
+ 生成される出力のタイプ (AMI またはコンテナイメージ) に基づいてイメージをフィルタリングできます。
+ **Filter source** を使用して、仮想マシン (VMIE) または ISO ディスクイメージからインポートされたイメージを検索できます。
フィルターコントロールに従い、**[Amazon が管理]** タブには、レシピのベースイメージとして使用できる Amazon が管理する Image Builder イメージのリストが表示されます。Image Builder には、リストされたリソースに関する以下の詳細が表示されます。
**[イメージ名]**
管理イメージの名前。レシピを作成すると、ベースイメージのデフォルトは **[クイックスタート (Amazon 管理)]** です。このタブに一覧表示されるイメージは、レシピの作成時にベースイメージ用に選択したオペレーティングシステムプラットフォームに関連付けられた **[イメージ名]** リストに入力します。
**Type**
このイメージリソース (AMI またはコンテナイメージ) に対して Image Builder が作成する出力イメージのタイプ。
**バージョン**
イメージリソースのオペレーティングシステムプラットフォームのバージョン。通常は .. という形式の数値フィールドです。
**プラットフォーム**
イメージリソースのオペレーティングシステムプラットフォーム。例えば、「Windows」、「Linux」、または「macOS」になります。
**作成時刻**
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 Command Reference の [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 アクションについては、「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. [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/) で、EC2 Image Builder コンソールを開きます。
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
```
**出力:**
この例の出力には、アクション待ちのステップを含むアカウント内の 1 つのイメージが表示されます。
```
{
"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、または でコマンドまたはアクションを使用して、イメージビルドバージョン AWS CLI を一覧表示することもできます。
以下の方法のいずれかを使用して、所有しているイメージリソースのイメージビルドバージョンを一覧表示できます。API アクションについては、EC2 Image Builder API Reference の [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 build versions** ページには、以下の詳細が記載されています：
+ **[バージョン]** — イメージリソースのビルドバージョン。Image Builder コンソールでは、バージョンはイメージの詳細ページにリンクしています。
+ **[タイプ]** — このイメージリソース (AMI またはコンテナイメージ) を作成したときに Image Builder が配信した出力のタイプ。
+ **[作成日]** — Image Builder がイメージビルドバージョンを作成した日付と時刻。
+ **[イメージステータス]** — イメージビルドバージョンの現在のステータス。ステータスは、イメージのビルドまたは廃棄に関連する場合があります。例えば、ビルドプロセス中に、`Building` または `Distributing` のステータスが表示される場合があります。イメージの廃棄については、`Deprecated` または `Deleted` のステータスが表示される場合があります。
+ **[障害の理由]** — イメージステータスの理由。Image Builder コンソールには、ビルドが失敗した理由 (**イメージステータス** は `Failed` と等しい) のみが表示されます。
+ **[セキュリティ検出結果]** — 参照先のイメージビルドバージョンのイメージスキャン結果の集約です。
+ **[ARN]** — イメージリソースの参照バージョンの Amazon リソースネーム (ARN)。
+ **[ログストリーム]** — 参照先のイメージビルドバージョンのログストリームの詳細へのリンク。
**バージョンを一覧表示する**
Image Builder コンソールにイメージビルドバージョンを一覧表示するには、次の手順を実行します。
1. [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/) で、EC2 Image Builder コンソールを開きます。
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}}
```
**出力:**
この例の出力には、指定したイメージレシピの 2 つのビルドバージョンが含まれています。
```
{
"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** コマンドの出力にはセキュリティ検出結果やログストリームは含まれていません。
------