EC2 / Client / describe_export_tasks

describe_export_tasks

EC2.Client.describe_export_tasks(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response = client.describe_export_tasks(
    ExportTaskIds=[
        'string',
    ],
    Filters=[
        {
            'Name': 'string',
            'Values': [
                'string',
            ]
        },
    ]
)

Parameters:

• ExportTaskIds (list) –

  The export task IDs.

  • (string) –

• Filters (list) –

  the filters for the export tasks.

  • (dict) –

    A filter name and value pair that is used to return a more specific list of results from a describe operation. Filters can be used to match a set of resources by specific criteria, such as tags, attributes, or IDs.

    If you specify multiple filters, the filters are joined with an AND , and the request returns only results that match all of the specified filters.

    • Name (string) –

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

    • Values (list) –

      The filter values. Filter values are case-sensitive. If you specify multiple values for a filter, the values are joined with an OR , and the request returns all results that match any of the specified values.

      • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'ExportTasks': [
        {
            'Description': 'string',
            'ExportTaskId': 'string',
            'ExportToS3Task': {
                'ContainerFormat': 'ova',
                'DiskImageFormat': 'VMDK'|'RAW'|'VHD',
                'S3Bucket': 'string',
                'S3Key': 'string'
            },
            'InstanceExportDetails': {
                'InstanceId': 'string',
                'TargetEnvironment': 'citrix'|'vmware'|'microsoft'
            },
            'State': 'active'|'cancelling'|'cancelled'|'completed',
            'StatusMessage': 'string',
            'Tags': [
                {
                    'Key': 'string',
                    'Value': 'string'
                },
            ]
        },
    ]
}

Response Structure

• (dict) –

  • ExportTasks (list) –

    Information about the export tasks.

    • (dict) –

      Describes an export instance task.

      • Description (string) –

        A description of the resource being exported.

      • ExportTaskId (string) –

        The ID of the export task.

      • ExportToS3Task (dict) –

        Information about the export task.

        • ContainerFormat (string) –

          The container format used to combine disk images with metadata (such as OVF). If absent, only the disk image is exported.

        • DiskImageFormat (string) –

          The format for the exported image.

        • S3Bucket (string) –

          The Amazon S3 bucket for the destination image. The destination bucket must exist and have an access control list (ACL) attached that specifies the Region-specific canonical account ID for the Grantee . For more information about the ACL to your S3 bucket, see Prerequisites in the VM Import/Export User Guide.

        • S3Key (string) –

          The encryption key for your S3 bucket.

      • InstanceExportDetails (dict) –

        Information about the instance to export.

        • InstanceId (string) –

          The ID of the resource being exported.

        • TargetEnvironment (string) –

          The target virtualization environment.

      • State (string) –

        The state of the export task.

      • StatusMessage (string) –

        The status message related to the export task.

      • Tags (list) –

        The tags for the export task.

        • (dict) –

          Describes a tag.

          • Key (string) –

            The key of the tag.

            Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with aws: .

          • Value (string) –

            The value of the tag.

            Constraints: Tag values are case-sensitive and accept a maximum of 256 Unicode characters.