View a markdown version of this page

イメージワークフローを一覧表示する - EC2 イメージビルダー

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

イメージワークフローを一覧表示する

Image Builder コンソールの [イメージワークフロー] リストページでは、所有している、またはアクセスできるイメージワークフローリソースの一覧と、これらのリソースに関する重要な詳細情報を確認できます。Image Builder API、 SDKs、または でコマンドまたはアクションを使用して、アカウントのイメージワークフローを AWS CLI 一覧表示することもできます。

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

次の詳細をフィルタリングして、結果のリストを合理化できます。たとえば、コンソールで Owner = Amazon でフィルタリングすると、リストには AWS マネージドワークフローのみが表示されます。

  • ワークフロー

  • バージョン

  • タイプ

  • 所有者

Console
ワークフローの詳細

Image Builder コンソールの[イメージワークフロー]リストページには、以下の詳細が含まれます。

  • [ワークフロー] — イメージワークフローリソースの最新バージョンの名前。Image Builder コンソールの [ワークフロー] 列は、ワークフローの詳細ページにリンクしています。

  • [バージョン] — イメージワークフローリソースの最新バージョン。

  • タイプ – ワークフロータイプ: BUILD、TEST、または DISTRIBUTION。

  • [所有者] – ワークフローリソースの所有者。

  • [作成日] — Image Builder が最新バージョンのイメージワークフローリソースを作成した日付と時刻。

  • [ARN] — 最新バージョンのイメージワークフローリソースの Amazon リソースネーム (ARN)。

イメージワークフローを一覧表示する

Image Builder コンソールにイメージワークフローリソースを一覧表示するには、次の手順を実行します。

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

  2. ナビゲーションペインから [イメージワークフロー] を選択します。

結果のフィルタ処理

[イメージワークフロー] リストページでは、特定のイメージワークフローを検索して結果をフィルタリングできます。イメージワークフローでは、次のフィルターを使用できます。

Workflow

結果を効率化するために、ワークフロー名の全体または一部を入力できます。デフォルトでは、リスト内のすべてのワークフローが表示されます。

Version

結果を効率化するために、バージョン番号の全体または一部を入力できます。デフォルトでは、リスト内のすべてのバージョンが表示されます。

Type

ワークフローのタイプでフィルタリングすることも、すべてのタイプを表示することもできます。デフォルトでは、リスト内のすべてのワークフローのタイプが表示されます。

  • BUILD

  • TEST

  • ディストリビューション

Owner

検索バーから所有者フィルターを選択すると、Image Builder はアカウントのイメージワークフローの所有者のリストを表示します。リストから所有者を選択すると、検索結果を効率化できます。デフォルトでは、リスト内のすべての所有者が表示されます。

  • AWS アカウント– ワークフローリソースを所有するアカウント。

  • Amazon – Amazon が所有および管理する AWS マネージドビルド、テスト、およびディストリビューションワークフローリソース。

AWS CLI

で list-workflows コマンドを実行すると AWS CLI、所有またはアクセスできるイメージワークフローのリストを取得できます。

次のコマンド例は、フィルターなしで list-workflows コマンドを使用し、所有している、もしくはアクセス権のあるすべての Image Builder イメージワークフローリソースを一覧表示する方法を示しています。

例:すべてのイメージワークフローを一覧表示する

aws imagebuilder list-workflows

出力:

{
    "workflowVersionList": [
        {
            "name": "example-test-workflow",
            "dateCreated": "2023-11-21T22:53:14.347Z",
            "version": "1.0.0",
            "owner": "111122223333",
            "type": "TEST",
            "arn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/test/example-test-workflow/1.0.0"
        },
        {
            "name": "example-build-workflow",
            "dateCreated": "2023-11-20T12:26:10.425Z",
            "version": "1.0.0",
            "owner": "111122223333",
            "type": "BUILD",
            "arn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/build/example-build-workflow/1.0.0"
        },
        {
            "name": "example-distribution-workflow",
            "dateCreated": "2025-11-19T10:25:10.425Z",
            "version": "1.0.0",
            "owner": "111122223333",
            "type": "DISTRIBUTION",
            "arn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/distribution/example-distribution-workflow/1.0.0"
        }
    ]
}

list-workflows コマンドを実行すると、次の例のようにフィルタを適用して結果を効率化できます。結果をフィルタリングする方法の詳細については、「AWS CLI コマンドリファレンス」の「list-workflows」コマンドを参照してください。

例: ビルドワークフローのフィルター

aws imagebuilder list-workflows --filters name="type",values="BUILD"

出力:

{
    "workflowVersionList": [
        {
            "name": "example-build-workflow",
            "dateCreated": "2023-11-20T12:26:10.425Z",
            "version": "1.0.0",
            "owner": "111122223333",
            "type": "BUILD",
            "arn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/build/example-build-workflow/1.0.0"
        }
    ]
}
ワークフローの詳細を取得する

特定のイメージワークフローバージョンの詳細を取得するには、 で get-workflow コマンドを実行します AWS CLI。API アクションについては、EC2 Image Builder API リファレンスのGetWorkflow」を参照してください。

例: ワークフローの詳細を取得する

aws imagebuilder get-workflow \
    --workflow-build-version-arn arn:aws:imagebuilder:us-west-2:111122223333:workflow/build/example-build-workflow/1.0.0/1

レスポンスには、ワークフロー type、state、 data (YAML ワークフロードキュメント)parameters、、owner、および が含まれますkmsKeyId。