イメージとビルドバージョンを一覧表示する

Image Builder コンソールの [イメージ] ページには、所有しているもの、共有されているもの、アクセス可能なすべての Image Builder イメージリソースのリストが表示されます。リストの結果には、それらのリソースに関する重要な詳細がいくつか含まれています。

ワークフローアクションが保留になっているアカウント内のイメージもすべて表示できます。

イメージを一覧表示する

このセクションでは、イメージに関する情報を一覧表示するさまざまな方法について説明します。

以下の方法のいずれかを使用して、アクセスできる Image Builder イメージリソースを一覧表示できます。API アクションについては、EC2 Image Builder API Reference の ListImages を参照してください。関連する SDK リクエストについては、同じページの 「関連項目」リンクを参照してください。

コンソールに画像を一覧表示します。

コンソールで [イメージ] リストページを開くには、次の手順に従います。

コンソールの [イメージ] ページは、イメージの所有権または保留中のワークフローアクションに基づいて、複数のタブに分かれています。このセクションでは、自分が所有している、またはアクセスできるイメージを表示する最初の 3 つのタブについて説明します。

AWS CLI コマンドを使用してイメージを一覧表示する

AWS CLI で list-images コマンドを実行すると、所有しているイメージやアクセス権のあるイメージのリストを取得できます。

次のコマンド例は、フィルターなしで 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 コマンドを参照してください。

例: 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」 を参照してください。関連する SDK リクエストについては、同じページの「関連項目」リンクを参照してください。

Console

コンソールの [アクション待ち] タブに移動するには、次の手順に従います。

1. https://console.aws.amazon.com/imagebuilder/ で、EC2 Image Builder コンソールを開きます。

2. ナビゲーションペインから [イメージ] を選択します。[イメージ] リストページが開きます。

3. リストページから [アクション待ち] タブを選択します。

4. (オプション) ステップを停止または再開するには、名前の横にあるチェックボックスを選択し、[ステップを停止] または [ステップを再開] を選択します。複数のチェックボックスを選択して、選択したすべてのステップに対して同じアクションを実行できます。

保留中のワークフローステップの詳細

保留中のステップのワークフローの詳細には以下が含まれます。

• [イメージ名] — 保留中のステップがあるイメージリソースの名前。名前のリンクを選択すると、そのイメージの詳細ページを表示できます。

• [保留中のステップ名] — アクションを待っているワークフローステップの名前。

• [ステップの実行 ID] — ワークフローステップのランタイムインスタンスを一意に識別します。リンクされた ID を選択すると、ステップのランタイム詳細を表示できます。

• [ステップの開始] – ワークフローステップのランタイムインスタンスが開始されたときのタイムスタンプ。

• [ワークフロー ARN] — 保留中のステップが適用されているワークフローの Amazon リソースネーム (ARN)。

• [アクション] — 待機状態にあるステップアクション。

AWS CLI

AWS CLI で list-waiting-workflow-steps コマンドを実行すると、イメージ作成プロセスを完了する前にアクションを待っているワークフローステップを含むアカウント内のすべてのイメージのリストが表示されます。

以下のコマンド例は、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 や SDK または AWS CLI でコマンドやアクションを使用したり、イメージビルドのバージョンを一覧表示したりすることもできます。

以下の方法のいずれかを使用して、所有しているイメージリソースのイメージビルドバージョンを一覧表示できます。API アクションについては、EC2 Image Builder API Reference の ListImageBuildVersions を参照すること。関連する SDK リクエストについては、同じページの 「関連項目」リンクを参照してください。

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/ で、EC2 Image Builder コンソールを開きます。

2. ナビゲーションペインから [イメージ] を選択します。デフォルトでは、イメージリストには所有している各イメージの現在のバージョンが表示されます。

3. イメージのすべてのバージョンのリストを表示するには、現在のバージョンリンクを選択します。このリンクをクリックすると、特定のイメージのすべてのビルドバージョンを一覧表示する [イメージビルドバージョンページ] が開きます。

AWS CLI

AWS CLIでlist-image-build-versionsコマンドを実行すると、指定したイメージリソースのビルドバージョンの全リストが表示されます。このコマンドを実行するには、イメージを所有する必要があります。

以下のコマンド例は、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 コマンドの出力にはセキュリティ検出結果やログストリームは含まれていません。