List image workflows - EC2 Image Builder
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

List image workflows

On the Image workflows list page in the Image Builder console, you can get a list of the image workflow resources that you own or have access to, along with some key details about these resources. You can also use commands or actions with the Image Builder API, SDKs, or Amazon CLI to list image workflows in your account.

You can use one of the following methods to list image workflow resources that you own or have access to. For the API action, see ListWorkflows in the EC2 Image Builder API Reference. For the associated SDK request, refer to the See Also link on the same page.

Console
Workflow details

Details on the Image workflows list page in the Image Builder console include the following:

  • Workflow – The name of the most recent version of the image workflow resource. In the Image Builder console, the Workflow column links to the workflow detail page.

  • Version – The most recent version of the image workflow resource.

  • Type – The workflow type: BUILD or TEST.

  • Owner – The owner of the workflow resource.

  • Creation time – The date and time when Image Builder created the most recent version of the image workflow resource.

  • ARN – The Amazon Resource Name (ARN) of the current version of the image workflow resource.

List image workflows

To list image workflow resources in the Image Builder console, perform the following steps:

  1. Open the EC2 Image Builder console at https://console.amazonaws.cn/imagebuilder/.

  2. Choose Image workflows from the navigation pane.

Filter results

On the Image workflows list page, you can search for specific image workflows to filter your results. The following filters are available for image workflows:

Workflow

You can enter all or part of a workflow name to streamline results. The default is to show all workflows in the list.

Version

You can enter all or part of a version number to streamline results. The default is to show all versions in the list.

Type

You can filter by the workflow type or view all types. The default is to show all workflow types in the list.

  • BUILD

  • TEST

Owner

When you select the owner filter from the search bar, Image Builder shows a list of the owners for the image workflows in your account. You can select an owner from the list to streamline results. The default is to show all owners in the list.

  • Amazon Web Services account – The account that owns the workflow resource.

  • Amazon – Workflow resources that Amazon owns and manages.

Amazon CLI

When you run the list-workflows command in the Amazon CLI, you can get a list of image workflows that you own or have access to.

The following command example shows how to use the list-workflows command without filters to list all of the Image Builder image workflow resources that you own or have access to.

Example: list all image workflows

aws imagebuilder list-workflows

Output:

{
	"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"
		}
	]
}

When you run the list-workflows command, you can apply filters to streamline the results, as the following example shows. For more information about how to filter your results, see the list-workflows command in the Amazon CLI Command Reference.

Example: filter for build workflows

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

Output:

{
	"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"
		}
	]
}