Registers a manifest for use with the cloud. Note that the registered image by default is set to private. To make publically available, use the euca-modify-image-attribute and set the --add value to all.


euca-register [manifest] -n name [-d description ] 
				[-a architecture ][--kernel kernel ] [--ramdisk ramdisk ]
				[--root-device-name root_device_name ] [-b block_device_mapping ] 
				[-s snapshot ][--virtualization-type type]


Option Description Required
manifest Path to the uploaded image (bucket/manifest). Required if you are registering an S3-based image. Conditional
-n,--name Name of the image.

Constraints: 3-128 alphanumeric characters, parenthesis (()), commas (,), slashes (/), dashes (-), or underscores(_)

-d,--description description Description of the image

Constraints: Up to 255 characters.

-a,--architecture architecture The architecture of the image

Valid Values: i386 | x86_64

--kernel Kernel ID associated with the image No
--ramdisk Ramdisk ID associated with the image No
--root-device-name name Root device name (for example, /dev/sda1, or xvda) No
-b,--block-device-mapping 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.

-s,--snapshot snapshot EBS snapshot ID to use as the root device No
--virtualization-type type The virtualization type for the new image.

Valid values: paravirtual | hvm

Note: You should always explicitly declare the instance type of a bundle created with euca-bundle-instance as an HVM type using --virtualization-type parameter.
--platform windows [Privileged] Indicates that the new image is a Windows image. 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.



euca-register -a i386 --description 'My new image' --name 'myimage'
IMAGE   emi-15A1386E