Skip to content
AWS for Query.Farm

aws.imagebuilder.list_image_build_versions

Example SQL Queries

SELECT * FROM
aws.imagebuilder.list_image_build_versions
WHERE
"image_version_arn" = 'VALUE';

Description

Returns a list of image build versions.

Table Definition

Column NameColumn Data Type
image_version_arn Required Input Column

The Amazon Resource Name (ARN) of the image whose build versions you want to retrieve.

VARCHAR
filters Input Column

Use the following filters to streamline results:

  • name

  • osVersion

  • platform

  • type

  • version 

STRUCT(
    "name" VARCHAR,
    "values" VARCHAR[]
)[]
Show child fields
filters[]
Show child fields
filters[].name

The name of the filter. Filter names are case-sensitive.

filters[].values[]
max_results Input Column

The maximum items to return in a request.

BIGINT
next_token Input Column

The next token used for paginated responses. When this field isn't empty, there are additional elements that the service hasn't included in this request. Use this token with the next request to retrieve additional objects.

VARCHAR
_aws_profile Input Column

The AWS profile defines the AWS identity used. It can be defined via credentials or by assuming a IAM role.

STRUCT(
    "type" VARCHAR,
    "name" VARCHAR,
    "account_id" VARCHAR,
    "via_profile_name" VARCHAR,
    "assumed_role_arn" VARCHAR,
    "organization" STRUCT(
        "account_name" VARCHAR,
        "id" VARCHAR,
        "tags" STRUCT(
            "key" VARCHAR,
            "value" VARCHAR
        )[],
        "master_account" STRUCT(
            "id" VARCHAR,
            "email" VARCHAR
        ),
        "parents" STRUCT(
            "type" VARCHAR,
            "id" VARCHAR,
            "name" VARCHAR,
            "tags" STRUCT(
                "key" VARCHAR,
                "value" VARCHAR
            )[]
        )[]
    )
)
Show child fields
_aws_profile.account_id

The AWS account id

_aws_profile.assumed_role_arn

The ARN of the assumed role

_aws_profile.name

The unique name of the profile.

_aws_profile.organization

Information about this profile's membership in the AWS organization.

Show child fields
_aws_profile.organization.account_name

The name of account speciifed by the organization

_aws_profile.organization.id

The organization id

_aws_profile.organization.master_account
Show child fields
_aws_profile.organization.master_account.email

The organization master account email address

_aws_profile.organization.master_account.id

The organization master account id

_aws_profile.organization.parents[]
Show child fields
_aws_profile.organization.parents[].id

The id of the parent

_aws_profile.organization.parents[].name

The name of the parent

_aws_profile.organization.parents[].tags[]
Show child fields
_aws_profile.organization.parents[].tags[].key
_aws_profile.organization.parents[].tags[].value
_aws_profile.organization.parents[].type

The type of parent can be an organization unit or a root

_aws_profile.organization.tags[]
Show child fields
_aws_profile.organization.tags[].key
_aws_profile.organization.tags[].value
_aws_profile.type

The type of profile, either 'credentials' or 'assumed_role'

_aws_profile.via_profile_name

This IAM role for this profile is assumed by first utilizing another profile with this name to obtain credentials.

image_summary_list

The list of image build versions.

STRUCT(
    "arn" VARCHAR,
    "name" VARCHAR,
    "type" VARCHAR,
    "version" VARCHAR,
    "platform" VARCHAR,
    "os_version" VARCHAR,
    "state" STRUCT(
        "status" VARCHAR,
        "reason" VARCHAR
    ),
    "owner" VARCHAR,
    "date_created" VARCHAR,
    "output_resources" STRUCT(
        "amis" STRUCT(
            "region" VARCHAR,
            "image" VARCHAR,
            "name" VARCHAR,
            "description" VARCHAR,
            "state" STRUCT(
                "status" VARCHAR,
                "reason" VARCHAR
            ),
            "account_id" VARCHAR
        )[],
        "containers" STRUCT(
            "region" VARCHAR,
            "image_uris" VARCHAR[]
        )[]
    ),
    "tags" MAP(VARCHAR, VARCHAR),
    "build_type" VARCHAR,
    "image_source" VARCHAR,
    "deprecation_time" TIMESTAMP_S,
    "lifecycle_execution_id" VARCHAR
)[]
Show child fields
image_summary_list[]
Show child fields
image_summary_list[].arn

The Amazon Resource Name (ARN) of the image.

image_summary_list[].build_type

Indicates the type of build that created this image. The build can be initiated in the following ways:

  • USER_INITIATED – A manual pipeline build request.

  • SCHEDULED – A pipeline build initiated by a cron expression in the Image Builder pipeline, or from EventBridge.

  • IMPORT – A VM import created the image to use as the base image for the recipe.

image_summary_list[].date_created

The date on which Image Builder created this image.

image_summary_list[].deprecation_time

The time when deprecation occurs for an image resource. This can be a past or future date.

image_summary_list[].image_source

The origin of the base image that Image Builder used to build this image.

image_summary_list[].lifecycle_execution_id

Identifies the last runtime instance of the lifecycle policy to take action on the image.

image_summary_list[].name

The name of the image.

image_summary_list[].os_version

The operating system version of the instances that launch from this image. For example, Amazon Linux 2, Ubuntu 18, or Microsoft Windows Server 2019.

image_summary_list[].output_resources

The output resources that Image Builder produced when it created this image.

Show child fields
image_summary_list[].output_resources.amis[]
Show child fields
image_summary_list[].output_resources.amis[].account_id

The account ID of the owner of the AMI.

image_summary_list[].output_resources.amis[].description

The description of the Amazon EC2 AMI. Minimum and maximum length are in characters.

image_summary_list[].output_resources.amis[].image

The AMI ID of the Amazon EC2 AMI.

image_summary_list[].output_resources.amis[].name

The name of the Amazon EC2 AMI.

image_summary_list[].output_resources.amis[].region

The Amazon Web Services Region of the Amazon EC2 AMI.

image_summary_list[].output_resources.amis[].state

Image status and the reason for that status.

Show child fields
image_summary_list[].output_resources.amis[].state.reason

The reason for the status of the image.

image_summary_list[].output_resources.amis[].state.status

The status of the image.

image_summary_list[].output_resources.containers[]
Show child fields
image_summary_list[].output_resources.containers[].image_uris[]
image_summary_list[].output_resources.containers[].region

Containers and container images are Region-specific. This is the Region context for the container.

image_summary_list[].owner

The owner of the image.

image_summary_list[].platform

The image operating system platform, such as Linux or Windows.

image_summary_list[].state

The state of the image.

Show child fields
image_summary_list[].state.reason

The reason for the status of the image.

image_summary_list[].state.status

The status of the image.

image_summary_list[].tags

The tags that apply to this image.

image_summary_list[].type

Specifies whether this image produces an AMI or a container image.

image_summary_list[].version

The version of the image.

request_id

The request ID that uniquely identifies this request.

VARCHAR