Skip to content
AWS for Query.Farm

aws.imagebuilder.list_component_build_versions

Example SQL Queries

SELECT * FROM
aws.imagebuilder.list_component_build_versions
WHERE
"component_version_arn" = 'VALUE';

Description

Returns the list of component build versions for the specified semantic version.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the base image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.

Table Definition

Column NameColumn Data Type
component_version_arn Required Input Column

The component version Amazon Resource Name (ARN) whose versions you want to list.

VARCHAR
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.

component_summary_list

The list of component summaries for the specified semantic version.

STRUCT(
    "arn" VARCHAR,
    "name" VARCHAR,
    "version" VARCHAR,
    "platform" VARCHAR,
    "supported_os_versions" VARCHAR[],
    "state" STRUCT(
        "status" VARCHAR,
        "reason" VARCHAR
    ),
    "type" VARCHAR,
    "owner" VARCHAR,
    "description" VARCHAR,
    "change_description" VARCHAR,
    "date_created" VARCHAR,
    "tags" MAP(VARCHAR, VARCHAR),
    "publisher" VARCHAR,
    "obfuscate" BOOLEAN
)[]
Show child fields
component_summary_list[]
Show child fields
component_summary_list[].arn

The Amazon Resource Name (ARN) of the component.

component_summary_list[].change_description

The change description for the current version of the component.

component_summary_list[].date_created

The original creation date of the component.

component_summary_list[].description

The description of the component.

component_summary_list[].name

The name of the component.

component_summary_list[].obfuscate

Indicates whether component source is hidden from view in the console, and from component detail results for API, CLI, or SDK operations.

component_summary_list[].owner

The owner of the component.

component_summary_list[].platform

The operating system platform of the component.

component_summary_list[].publisher

Contains the name of the publisher if this is a third-party component. Otherwise, this property is empty.

component_summary_list[].state

Describes the current status of the component.

Show child fields
component_summary_list[].state.reason

Describes how or why the component changed state.

component_summary_list[].state.status

The current state of the component.

component_summary_list[].supported_os_versions[]
component_summary_list[].tags

The tags that apply to the component.

component_summary_list[].type

The component type specifies whether Image Builder uses the component to build the image or only to test it.

component_summary_list[].version

The version of the component.

request_id

The request ID that uniquely identifies this request.

VARCHAR