Creates a Eucalyptus Machine Image (EMI) from an EBS-based instance.


euca-create-image instance_id -n, --name <name> [-b DEVICE=MAPPED] [--no-reboot] [-d, --description <description> ][-S,
     --secret-key <secret_key> ][-I <key_id>]


Option Description Required
instance_id The instance ID to use to create the EMI. Yes
-n,--name name The name of the new image. Yes
-d,--description description The description of the new image. No
--no-reboot Indicates that the instance should not be shut down before creating the image.
Note: This may affect image integrity.
-b,--block-device-mapping Block device mapping for the instance. This is passed in the form of <devicename>=<blockdevice>, where: devicename is the device name of the physical device on the instance to map and blockdevice is one of the following values:
  • none: Use this value to suppress existing mapping on the specified image for this device. For example: /dev/sdc=none
  • ephemeral[0..3]: Use this value to indicate that an instance local storage device should be mapped to this device. For example: /dev/sdc=ephemeral0
  • [snapshot-id]:[size]:[delete-on-termination (true|false)]: Use this value to map a device to an existing EBS-backed volume, and to specify whether the EBS volume should be deleted on termination. This value defaults to true.

    To specify a new EBS-backed volume, skip the snapshot ID and pass in a volume size instead. For example: /dev/sdb=:20.


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.