openstacksdk/doc/source/users/guides/image.rst
Richard Theis 003ff67dc8 Add image user guide
Add an image user guide to replace the current placeholder. Also,
add image examples and related tests to go along with the guide.
Much of the content for the guide was pulled from [1].

[1] http://docs.openstack.org/image-guide/

Change-Id: I8b3a1618b09f3570f3b69d8c228bed56d4d1c151
Closes-Bug: #1466183
2016-01-05 15:53:20 -06:00

1.5 KiB

Using OpenStack Image

Before working with the Image service, you'll need to create a connection to your OpenStack cloud by following the connect user guide. This will provide you with the conn variable used in the examples below.

The primary resource of the Image service is the image.

List Images

An image is a collection of files for a specific operating system that you use to create or rebuild a server. OpenStack provides pre-built images. You can also create custom images, or snapshots, from servers that you have launched. Images come in different formats and are sometimes called virtual machine images.

../examples/image/list.py

Full example: image resource list

Create Image

Create an image by uploading its data and setting its attributes.

../examples/image/create.py

Full example: image resource create

Delete Image

Delete an image.

../examples/image/delete.py

Full example: image resource delete