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:
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.
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.
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
"
}
]
}