org.jclouds.gogrid.services

Interface GridImageClient

public interface GridImageClient

Manages the server images

Author:

Oleksiy Yarmula

See Also:

Method Summary

Methods

Modifier and Type	Method and Description
ServerImage	deleteById(long id) Deletes an existing image
ServerImage	editImageDescription(String idOrName, String newDescription) Edits an existing image
ServerImage	editImageFriendlyName(String idOrName, String newFriendlyName) Edits an existing image
Set<Option>	getDatacenters() Retrieves the list of supported Datacenters to save images in.
Set<ServerImage>	getImageList(GetImageListOptions... options) Returns all server images.
Set<ServerImage>	getImagesById(Long... ids) Returns images, found by specified ids
Set<ServerImage>	getImagesByName(String... names) Returns images, found by specified names
ServerImage	saveImageFromServer(String friendlyName, String idOrName, SaveImageOptions... options) This call will save a private (visible to only you) server image to your library of available images.

Method Detail

deleteById

ServerImage deleteById(long id)

Deletes an existing image

Parameters:

id - id of the existing image

saveImageFromServer

ServerImage saveImageFromServer(String friendlyName,
                              String idOrName,
                              SaveImageOptions... options)

This call will save a private (visible to only you) server image to your library of available images. The image will be saved from an existing server.

Parameters:

idOrName - id or name of the existing server

friendlyName - friendly name of the image

Returns:

saved server image

getImageList

Set<ServerImage> getImageList(GetImageListOptions... options)

Returns all server images.

Parameters:

options - options to narrow the search down

Returns:

server images found

getImagesById

Set<ServerImage> getImagesById(Long... ids)

Returns images, found by specified ids

Parameters:

ids - the ids that match existing images

Returns:

images found

getImagesByName

Set<ServerImage> getImagesByName(String... names)

Returns images, found by specified names

Parameters:

names - the names that march existing images

Returns:

images found

editImageDescription

ServerImage editImageDescription(String idOrName,
                               String newDescription)

Edits an existing image

Parameters:

idOrName - id or name of the existing image

newDescription - description to replace the current one

Returns:

edited server image

editImageFriendlyName

ServerImage editImageFriendlyName(String idOrName,
                                String newFriendlyName)

Edits an existing image

Parameters:

idOrName - id or name of the existing image

newFriendlyName - friendly name to replace the current one

Returns:

edited server image

getDatacenters

Set<Option> getDatacenters()

Retrieves the list of supported Datacenters to save images in. The objects will have datacenter ID, name and description. In most cases, id or name will be used for getImageList(org.jclouds.gogrid.options.GetImageListOptions...).

Returns:

supported datacenters