ó
±EYc@s0dZd
dl
mZ
def
d„ƒYZdS(sl
Main abstraction layer for retrieving and storing information about disk
images used by the compute layer.
iÿÿÿÿ(
tglancetAPIcBskeZ
dZd
„Zd„Zd„Zeed„Zd	d„
Z
d	ed„Zd„Zd	d	d„Z
RS(
sæResponsible for exposing a relatively stable internal API for other
    modules in Nova to retrieve information about disk images. This API
    attempts to match the nova.volume.api and nova.network.api calling
    interface.
    cCstj
|
|ƒS(
s[Returns a tuple of (session, image_id). If the supplied `id_or_uri`
        is an image ID, then the default client session will be returned
        for the context's user, along with the image ID. If the supplied
        `id_or_uri` parameter is a URI, then a client session connecting to
        the URI's image service endpoint will be returned along with a
        parsed image ID from that URI.

        :param context: The `nova.context.Context` object for the request
        :param id_or_uri: A UUID identifier or an image URI to look up image
                          information for.
        (Rtget_remote_image_service(tselftcontextt	id_or_uri((sC/home/tvault/.virtenv/lib/python2.7/site-packages/nova/image/api.pyt_get_session_and_image_idsc
Cs
tj
ƒS(
s¦Returns a client session that can be used to query for image
        information.

        :param _context: The `nova.context.Context` object for the request
        (Rtget_default_image_service(Rt_context((sC/home/tvault/.virtenv/lib/python2.7/site-packages/nova/image/api.pyt_get_session+scKs|j|
ƒ
}|j
|
|
S(
sWRetrieves all information records about all disk images available
        to show to the requesting user. If the requesting user is an admin,
        all images in an ACTIVE status are returned. If the requesting user
        is not an admin, the all public images and all private images that
        are owned by the requesting user in the ACTIVE status are returned.

        :param context: The `nova.context.Context` object for the request
        :param kwargs: A dictionary of filter and pagination values that
                       may be passed to the underlying image info driver.
        (R	tdetail(RRtkwargstsession((sC/home/tvault/.virtenv/lib/python2.7/site-packages/nova/image/api.pytget_all8s
cCs4|j|
|ƒ\}}|j
|
|d
|d|ƒS(sNRetrieves the information record for a single disk image. If the
        supplied identifier parameter is a UUID, the default driver will
        be used to return information about the image. If the supplied
        identifier is a URI, then the driver that matches that URI endpoint
        will be used to query for image information.

        :param context: The `nova.context.Context` object for the request
        :param id_or_uri: A UUID identifier or an image URI to look up image
                          information for.
        :param include_locations: (Optional) include locations in the returned
                                  dict of information if the image service API
                                  supports it. If the image service API does
                                  not support the locations attribute, it will
                                  still be included in the returned dict, as an
                                  empty list.
        :param show_deleted: (Optional) show the image even the status of
                             image is deleted.
        tinclude_locationstshow_deleted(Rtshow(RRRRRRtimage_id((sC/home/tvault/.virtenv/lib/python2.7/site-packages/nova/image/api.pytgetFs


cCs%|j|
ƒ
}|j
|
|d
|ƒ
S(s¨
Creates a new image record, optionally passing the image bits to
        backend storage.

        :param context: The `nova.context.Context` object for the request
        :param image_info: A dict of information about the image that is
                           passed to the image registry.
        :param data: Optional file handle or bytestream iterator that is
                     passed to backend storage.
        tdata(R	tcreate(RRt
image_infoRR((sC/home/tvault/.virtenv/lib/python2.7/site-packages/nova/image/api.pyR_s

cCs7|j|
|ƒ\}}|j
|
||d
|d|ƒS(sUpdate the information about an image, optionally along with a file
        handle or bytestream iterator for image bits. If the optional file
        handle for updated image bits is supplied, the image may not have
        already uploaded bits for the image.

        :param context: The `nova.context.Context` object for the request
        :param id_or_uri: A UUID identifier or an image URI to look up image
                          information for.
        :param image_info: A dict of information about the image that is
                           passed to the image registry.
        :param data: Optional file handle or bytestream iterator that is
                     passed to backend storage.
        :param purge_props: Optional, defaults to False. If set, the backend
                            image registry will clear all image properties
                            and replace them the image properties supplied
                            in the image_info dictionary's 'properties'
                            collection.
        Rtpurge_props(Rtupdate(RRRRRRRR((sC/home/tvault/.virtenv/lib/python2.7/site-packages/nova/image/api.pyRls

cCs(|j|
|ƒ\}}|j
|
|ƒS(
s
Delete the information about an image and mark the image bits for
        deletion.

        :param context: The `nova.context.Context` object for the request
        :param id_or_uri: A UUID identifier or an image URI to look up image
                          information for.
        (Rtdelete(RRRRR((sC/home/tvault/.virtenv/lib/python2.7/site-packages/nova/image/api.pyR„s
cCs4|j|
|ƒ\}}|j
|
|d
|d|ƒS(sTransfer image bits from Glance or a known source location to the
        supplied destination filepath.

        :param context: The `nova.context.RequestContext` object for the
                        request
        :param id_or_uri: A UUID identifier or an image URI to look up image
                          information for.
        :param data: A file object to use in downloading image data.
        :param dest_path: Filepath to transfer image bits to.

        Note that because of the poor design of the
        `glance.ImageService.download` method, the function returns different
        things depending on what arguments are passed to it. If a data argument
        is supplied but no dest_path is specified (only done in the XenAPI virt
        driver's image.utils module) then None is returned from the method. If
        the data argument is not specified but a destination path *is*
        specified, then a writeable file handle to the destination path is
        constructed in the method and the image bits written to that file, and
        again, None is returned from the method. If no data argument is
        supplied and no dest_path argument is supplied (VMWare and XenAPI virt
        drivers), then the method returns an iterator to the image bits that
        the caller uses to write to wherever location it wants. Finally, if the
        allow_direct_url_schemes CONF option is set to something, then the
        nova.image.download modules are used to attempt to do an SCP copy of
        the image bits from a file location to the dest_path and None is
        returned after retrying one or more download locations (libvirt and
        Hyper-V virt drivers through nova.virt.images.fetch).

        I think the above points to just how hacky/wacky all of this code is,
        and the reason it needs to be cleaned up and standardized across the
        virt driver callers.
        Rtdst_path(Rtdownload(RRRRt	dest_pathRR((sC/home/tvault/.virtenv/lib/python2.7/site-packages/nova/image/api.pyRs%

N(t__name__t
__module__t__doc__RR	R
tFalsetTrueRtNoneRRRR(((sC/home/tvault/.virtenv/lib/python2.7/site-packages/nova/image/api.pyR
s		
	
	N(Rt
nova.imageRtobjectR
(((sC/home/tvault/.virtenv/lib/python2.7/site-packages/nova/image/api.pyt<module>s