Skip to content

aws.ec2.describe_bundle_tasks

Example SQL Queries

SELECT * FROM
aws.ec2.describe_bundle_tasks;

Description

Describes the specified bundle tasks or all of your bundle tasks.

Completed bundle tasks are listed for only a limited time. If your bundle task is no longer in the list, you can still register an AMI from it. Just use RegisterImage with the Amazon S3 bucket name and image manifest name you provided to the bundle task.

The order of the elements in the response, including those within nested structures, might vary. Applications should not assume the elements appear in a particular order.

Table Definition

Column NameColumn Data Type
bundle_ids Input Column

The bundle task IDs.

Default: Describes all your bundle tasks.

VARCHAR[]
Show child fields
bundle_ids[]
dry_run Input Column

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

BOOLEAN
filters Input Column

The filters.

  • bundle-id - The ID of the bundle task.

  • error-code - If the task failed, the error code returned.

  • error-message - If the task failed, the error message returned.

  • instance-id - The ID of the instance.

  • progress - The level of task completion, as a percentage (for example, 20%).

  • s3-bucket - The Amazon S3 bucket to store the AMI.

  • s3-prefix - The beginning of the AMI name.

  • start-time - The time the task started (for example, 2013-09-15T17:15:20.000Z).

  • state - The state of the task (pending | waiting-for-shutdown | bundling | storing | cancelling | complete | failed).

  • update-time - The time of the most recent update for the task.

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[]
_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.

_aws_region Input Column

The AWS region to use.

VARCHAR
bundle_tasks

Information about the bundle tasks.

STRUCT(
"bundle_id" VARCHAR,
"bundle_task_error" STRUCT(
"code" VARCHAR,
"message" VARCHAR
),
"instance_id" VARCHAR,
"progress" VARCHAR,
"start_time" TIMESTAMP_S,
"state" VARCHAR,
"storage" STRUCT(
"s3" STRUCT(
"aws_access_key_id" VARCHAR,
"bucket" VARCHAR,
"prefix" VARCHAR,
"upload_policy" BLOB,
"upload_policy_signature" VARCHAR
)
),
"update_time" TIMESTAMP_S
)[]
Show child fields
bundle_tasks[]
Show child fields
bundle_tasks[].bundle_id

The ID of the bundle task.

bundle_tasks[].bundle_task_error

If the task fails, a description of the error.

Show child fields
bundle_tasks[].bundle_task_error.code

The error code.

bundle_tasks[].bundle_task_error.message

The error message.

bundle_tasks[].instance_id

The ID of the instance associated with this bundle task.

bundle_tasks[].progress

The level of task completion, as a percent (for example, 20%).

bundle_tasks[].start_time

The time this task started.

bundle_tasks[].state

The state of the task.

bundle_tasks[].storage

The Amazon S3 storage locations.

Show child fields
bundle_tasks[].storage.s3

An Amazon S3 storage location.

Show child fields
bundle_tasks[].storage.s3.aws_access_key_id

The access key ID of the owner of the bucket. Before you specify a value for your access key ID, review and follow the guidance in Best Practices for Amazon Web Services accounts in the Account ManagementReference Guide.

bundle_tasks[].storage.s3.bucket

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

bundle_tasks[].storage.s3.prefix

The beginning of the file name of the AMI.

bundle_tasks[].storage.s3.upload_policy

An Amazon S3 upload policy that gives Amazon EC2 permission to upload items into Amazon S3 on your behalf.

bundle_tasks[].storage.s3.upload_policy_signature

The signature of the JSON document.

bundle_tasks[].update_time

The time of the most recent update for the task.