Reference Guide › Command Line Scripting › Amazon Elastic Compute Cloud Commands › dpmec2 createImage--Create AMI Image

dpmec2 createImage--Create AMI Image

The dpmec2 createImage command creates an image from a running or stopped Elastic Block Storage (EBS) instance.

This command has the following format:

dpmec2 createImage [-sc sc_url] -instance instanceID -imageName "imagename" [-imageDesc description] [-noReboot true|false] [-region region] [-pre] [-post][-locale iso639value]

-sc sc_url

(Optional) Defines the URL for the service controller host.

Example: https://hostname:port/...

hostname

Defines the fully qualified host where the service controller is installed.

Example: localhost.ca.com

port

Defines the listening port for the service controller server.

Example: 80

-instance instanceID

Defines the instance ID.

-imageName "imagename"

Defines the image name. Valid entry: 3-128 alphanumeric characters including parethesis, commas, slashes, dashes, and underscores. Must be enclosed in double quotes.

-imageDesc description

Defines a description of the image. Valid entry: any alphanumeric character.

-noReboot true|false

Defines whether the instance is rebooted after it is created. Valid entries: true = reboot, false = do not reboot (default).

-region region

Defines any of the regions supported and defined by Amazon.

-pre

(Optional) Specifies whether to generate an event before the operation is performed.

-post

(Optional) Specifies whether to generate an event after the operation is performed.

-locale iso639value

(Optional) Specifies an IS0 639_3166 combination to override the default English output, for example, fr_FR for French. To use the locale of the command prompt, specify "native".

Example: Create an EBS Instance

This example creates an EBS instance that is not rebooted after it is created.

dpmec2 createImage -image ami-1234abcd -noReboot false