Skip to main content

export_image_tasks

Creates, updates, deletes, gets or lists an export_image_tasks resource.

Overview

Nameexport_image_tasks
TypeResource
Idaws.ec2.export_image_tasks

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
descriptionstringA description of the image being exported.
export_image_task_idstringThe ID of the export image task.
image_idstringThe ID of the image.
progressstringThe percent complete of the export image task.
s3_export_locationstringInformation about the destination Amazon S3 bucket.
statusstringThe status of the export image task. The possible values are active, completed, deleting, and deleted.
status_messagestringThe status message for the export image task.
tagsstringAny tags assigned to the export image task.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
describe_export_image_tasksselectregionDryRun, Filter, ExportImageTaskId, MaxResults, NextTokenDescribes the specified export image tasks or all of your export image tasks.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
DryRunbooleanChecks 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.
ExportImageTaskIdarrayThe IDs of the export image tasks.
FilterarrayFilter tasks using the task-state filter and one of the following values: active, completed, deleting, or deleted.
MaxResultsintegerThe maximum number of results to return in a single call.
NextTokenstringA token that indicates the next page of results.

SELECT examples

Describes the specified export image tasks or all of your export image tasks.

SELECT
description,
export_image_task_id,
image_id,
progress,
s3_export_location,
status,
status_message,
tags
FROM aws.ec2.export_image_tasks
WHERE region = '{{ region }}' -- required
AND DryRun = '{{ DryRun }}'
AND Filter = '{{ Filter }}'
AND ExportImageTaskId = '{{ ExportImageTaskId }}'
AND MaxResults = '{{ MaxResults }}'
AND NextToken = '{{ NextToken }}'
;