Monty Taylor 5a247055ae Update docs to recommend KSA instead of KSC

For the session workflow (which is really the only workflow a dev should
use), session objects should now come from keystoneauth1 instead of
python-keystoneclient.

Change-Id: Icb5f20ce3dc09ff7790b27d07f7f0cb3b83e1e7e

2015-10-21 17:38:54 +09:00

1.8 KiB

Raw Permalink 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 Permalink Blame History