Previous Topic: dpmec2 ec2jobcheck Command--Get Amazon EC2 Job Status

Next Topic: dpmec2 getinstances Command--Get Amazon EC2 Instances


dpmec2 getimages Command--Get Amazon EC2 Images

The dpmec2 getimages command lists Amazon EC2 images.

This command has the following format:

dpmec2 getimages [-sc sc_url] {-image all|imageID[,imageID] | -owner ownerID[,ownerID]} [-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

-image all|imageID[,imageID] |
-owner ownerID [,ownerID]

Defines the list of all images, specific images, or images by owners.

all

Lists all images for a specified region. If -region is not specified, the default region is used.

imageID[,imageID]

Lists specific images.

-owner ownerID[,ownerID]

Lists all images for a specified region. If -region is not specified, the default region is used.

-region region

Lists AMIs for the default or specified region. If you do not specify this option, the default region (set during or after installation in the UI or CLI) is used.

-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: Get a Specific Image

This example lists details for image AMI-40fb5892.

dpmec2 getimages -image ami-40bf5892