euca-import-instance

Import an instance into the cloud.

Syntax

euca-import-instance -t instance_type -f format -a architecture 
    -p {Windows,Linux} (-b bucket | --manifest-url URL)
	[--prefix prefix] [-x days] [--no-upload]
	[-d description] [-g group] [-z zone] [-s GBs]
	[--image-size bytes]
	[--user-data data | --user-data-file filename]
	[--subnet subnet] [--private-ip-address address]
	[--monitor]
	[--instance-initiated-shutdown-behavior {stop,terminate}]
	[--key keypairname] filename

Options

Options Description Required
filename The file containing the disk image to import. Yes
-t type, --instance-type type The type of instance to import. Yes
-f format, --format format The format of the image.

Valid values: raw, or vhd

Yes
-a architecture, --arch architecture Architecture of the new instance.

Valid values: i386,x86_64,armhf,ppc, or ppc64.

Yes
-p platform, --platform platform The operating system for the instance.

Valid values: Windows or Linux

Yes
-b bucket, --bucket bucket Bucket to upload volume to. Yes
--manifest-url URL A pre-signed URL that points to the import manifest to use. Yes
--prefix prefix The prefix to add to the names of the volume parts as they are uploaded. No
-x days, --expires days The amount of time, in days, that the import manifest should remain valid.

Default: 30 days

Conditional
--no-upload Start the import process, but do not actually upload the volume No
--description Description of the import task. No
-g group, --group group Name of the security group to create the instance in. No
-z zone, --zone zone Name of the zone to create the instance in. No
-s gb, --size gb Size of the volume to import to, in gigabytes. No
--image-size size The size of the image. Required for non-raw files. Conditional
--user-data data User data to supply to the instance. No
--user-data-file file File containing user data to supply to the instance. No
--subnet subnet [VPC only] Subnet in which to create the instance's network interface. No
--private-ip-address address [VPC only] Assign the specified primary private IP address to the instance's interface. No
--monitor Enable detailed monitoring for the instance. No
--instance-initiated-shutdown-behavior behavior Indicates whether to stop or terminate the instance when it's shut down.

Valid values: stop, terminate

Default: stop

No
--key keypairname [Eucalyptus only] The name of the key pair to use when running the instance. No
-o key, --owner-akid key The access key to use for the object storage service.

Default: same as that for the compute service.

No
-w key, --owner-sak key The secret key to use for the object storage service.

Default: same as that for the compute service.

No
--progress Show a progress bar during command execution. This is the default when this command is run interactively. No
--no-progress Do not show a progress bar during command execution. This is the default when this command is run non-interactively. No

Common Options

Option Description
--show-empty-fields Show empty fields as "(nil)".
--region user@region Region and/or user name to search when looking up config file data. Only valid for EC2 endpoints.
-U,--url url URL of the cloud service to connect to. For administrative commands, this should be <ip_address>:8773/services/Empyrean.
-I,--access-key-id key_id User's access key ID.
-S,--secret-key secret_key User's secret key.
--security-token token User's security token.
--debug Prints what the command sends to the server and what it receives from the server. Use when you're trying to debug Euca2ools.
--debugger Enable interactive debugger on error.
-h,--help Display the manual page for the command.
--version Display the version of this tool.

Example

euca-import-instance myimagefile -p Linux -f raw -t m1.large -a x86_64 -b my-bukkit
x