| Euca2ools Guide / EC2-Compatible Commands | |
Import an instance into the cloud.
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 | 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 |
| 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. |
euca-import-instance myimagefile -p Linux -f raw -t m1.large -a x86_64 -b my-bukkit