Files

Doug Hellmann e8acf5e736 move existing content into the new standard structure

This patch rearranges and reformats existing content.

It replaces the home-grown autodoc feature with the one built into pbr,
for consistency with other OpenStack projects.

It depends on the doc-migration spec and a pbr feature to allow us to
specify where the autodoc content should go in the source tree during
the build.

Change-Id: I8d2bb11b5ef3e46fcd22c8bed8f84060d8ab6f03
Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454
Depends-On: I2bd5652bb59cbd9c939931ba2e7db1b37d2b30bb
Signed-off-by: Doug Hellmann <doug@doughellmann.com>

2017-06-28 12:24:48 -04:00

1.8 KiB

Raw Blame History

Python API v2

To create a client:

from keystoneauth1 import loading
from keystoneauth1 import session
from glanceclient import Client

loader = loading.get_plugin_loader('password')
auth = loader.load_from_options(
    auth_url=AUTH_URL,
    username=USERNAME,
    password=PASSWORD,
    project_id=PROJECT_ID)
session = session.Session(auth=auth)

glance = Client('2', session=session)

Create

Create a new image:

image = glance.images.create(name="myNewImage")
glance.images.upload(image.id, open('/tmp/myimage.iso', 'rb'))

Show

Describe a specific image:

glance.images.get(image.id)

Update

Update a specific image:

# update with a list of image attribute names and their new values
glance.images.update(image.id, name="myNewImageName")

Custom Properties

Set a custom property on an image:

# set an arbitrary property on an image
glance.images.update(image.id, my_custom_property='value')

Remove a custom property from an image:

# remove the custom property 'my_custom_property'
glance.images.update(image.id, remove_props=['my_custom_property'])

Delete

Delete specified image(s):

glance.images.delete(image.id)

List

List images you can access:

for image in glance.images.list():
   print image

Download

Download a specific image:

d = glance.images.data(image.id)

Share a specific image with a tenant:

glance.image_members.create(image_id, member_id)

Remove a shared image from a tenant:

glance.image_members.delete(image_id, member_id)

List Sharings

Describe sharing permissions by image or tenant:

glance.image_members.list(image_id)

1.8 KiB Raw Blame History