Provided by: ec2-api-tools_1.6.12.0-0ubuntu1_all bug

NAME

       ec2-create-instance-export-task  - Initiate an instance export task to export a running or
       stopped

SYNOPSIS

        ec2addixt ([ec2addixt, ec2-create-instance-export-task])
        ec2addixt [GENERAL OPTIONS]  INSTANCE  -e  TARGET_ENVIRONMENT  -f  DISK_IMAGE_FORMAT  [-c
       CONTAINER_FORMAT] -b S3_BUCKET [-p S3_PREFIX] [-d DESCRIPTION]

GENERAL NOTES

        Any command option/parameter may be passed a value of '-' to indicate
        that values for that option should be read from stdin.

DESCRIPTION

        Initiate an instance export task to export a running or stopped
        instance to a file in S3
        The INSTANCE parameter specifies the instance to export.
        The instance will be rebooted once, in the same fashion as
        ec2-create-image
        Temporary AMIs or snapshots of the instance and its attached
        volumes may be created under your account during the initial phase of
        the export task. They will be deleted automatically when they are no
        longer needed for the export task.

GENERAL OPTIONS

        -O, --aws-access-key KEY
            AWS Access Key ID. Defaults to the value of the AWS_ACCESS_KEY
            environment variable (if set).

        -W, --aws-secret-key KEY
            AWS Secret Access Key. Defaults to the value of the AWS_SECRET_KEY
            environment variable (if set).

        -T, --security-token TOKEN
            AWS delegation token. Defaults to the value of the AWS_DELEGATION_TOKEN
            environment variable (if set).

        -K, --private-key KEY
            [DEPRECATED] Specify KEY as the private key to use. Defaults to the value of the
            EC2_PRIVATE_KEY environment variable (if set). Overrides the default.

        -C, --cert CERT
            [DEPRECATED] Specify CERT as the X509 certificate to use. Defaults to the value
            of the EC2_CERT environment variable (if set). Overrides the default.

        -U, --url URL
            Specify URL as the web service URL to use. Defaults to the value of
            'https://ec2.amazonaws.com' (us-east-1) or to that of the
            EC2_URL environment variable (if set). Overrides the default.

        --region REGION
            Specify REGION as the web service region to use.
            This option will override the URL specified by the "-U URL" option
            and EC2_URL environment variable.
            This option defaults to the region specified by the EC2_URL environment variable
            or us-east-1 if this environment variable is not set.

        -D, --auth-dry-run
            Check if you can perform the requested action rather than actually performing it.

        -v, --verbose
            Verbose output.

        -?, --help
            Display this help.

        -H, --headers
            Display column headers.

        --debug
            Display additional debugging information.

        --show-empty-fields
            Indicate empty fields.

        --hide-tags
            Do not display tags for tagged resources.

        --connection-timeout TIMEOUT
            Specify a connection timeout TIMEOUT (in seconds).

        --request-timeout TIMEOUT
            Specify a request timeout TIMEOUT (in seconds).

SPECIFIC OPTIONS

        -f, --disk-image-format DISK-IMAGE-FORMAT
            The file format of the disk image. Refer to the latest Developer's
            Guide for valid values. [OPTIONAL]

        -e, --target-environment TARGET-ENVIRONMENT
            The target environment. Refer to the latest Developer's
            Guide for valid values. [REQUIRED]

        -c, --container-format CONTAINER-FORMAT
            The container format used to combine disk images with metadata.
            If absent, only the disk image will be exported. [OPTIONAL]

        -b, --s3-bucket S3-BUCKET
            S3 destination bucket name for the exported file.
            The target bucket must grant WRITE and READ_ACL permissions to the
            vm-import-export@amazon.com AWS account. [REQUIRED]

        -p, --s3-prefix S3-PREFIX
            Initial part of the S3 key (object name) used for the exported file.
            Maximum length is 1000 bytes of UTF-8. [OPTIONAL]

        -d, --description DESCRIPTION
            A free-form comment that will be returned verbatim during
            subsequent calls to ec2-describe-export-tasks.  Maximum length is 255
            characters. [OPTIONAL]

SEE ALSO

         http://docs.amazonwebservices.com/AWSEC2/2013-10-15/CommandLineReference
         http://docs.amazonwebservices.com/AWSEC2/latest/CommandLineReference