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