Skip to content

EC2  >  Operations  >  describe_bundle_tasks

describe_bundle_tasks

Operation

describe_bundle_tasks async 

describe_bundle_tasks(input: DescribeBundleTasksInput, plugins: list[Plugin] | None = None) -> DescribeBundleTasksOutput

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

Note

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.

Note: 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.

Parameters:

Name Type Description Default
input DescribeBundleTasksInput

An instance of DescribeBundleTasksInput.

 required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

 None

Returns:

Type Description
DescribeBundleTasksOutput

An instance of DescribeBundleTasksOutput.

Input

DescribeBundleTasksInput dataclass

Bases: _SerdeShape

Dataclass for DescribeBundleTasksInput structure.

Attributes

bundle_ids class-attribute instance-attribute 
bundle_ids: list[str] | None = ...

The bundle task IDs.

Default: Describes all your bundle tasks.

dry_run class-attribute instance-attribute 
dry_run: bool | None = ...

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.

filters class-attribute instance-attribute 
filters: list[Filter] | None = ...

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.

Output

DescribeBundleTasksOutput dataclass

Bases: _SerdeShape

Dataclass for DescribeBundleTasksOutput structure.

Attributes

bundle_tasks class-attribute instance-attribute 
bundle_tasks: list[BundleTask] | None = ...

Information about the bundle tasks.

response_metadata class-attribute instance-attribute 
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.