# Copyright 2013 NetApp # All Rights Reserved. # # Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. """The share snapshots api.""" import webob from webob import exc from cinder.api import common from cinder.api.contrib import shares from cinder.api import extensions from cinder.api.openstack import wsgi from cinder.api.views import share_snapshots as snapshot_views from cinder.api import xmlutil from cinder import exception from cinder.openstack.common import log as logging from cinder import share LOG = logging.getLogger(__name__) def make_snapshot(elem): elem.set('id') elem.set('size') elem.set('status') elem.set('name') elem.set('description') elem.set('share_proto') elem.set('export_location') class SnapshotTemplate(xmlutil.TemplateBuilder): def construct(self): root = xmlutil.TemplateElement('share-snapshot', selector='share-snapshot') make_snapshot(root) return xmlutil.MasterTemplate(root, 1) class SnapshotsTemplate(xmlutil.TemplateBuilder): def construct(self): root = xmlutil.TemplateElement('share-snapshots') elem = xmlutil.SubTemplateElement(root, 'share-snapshot', selector='share-snapshots') make_snapshot(elem) return xmlutil.MasterTemplate(root, 1) class ShareSnapshotsController(wsgi.Controller): """The Share Snapshots API controller for the OpenStack API.""" _view_builder_class = snapshot_views.ViewBuilder def __init__(self): super(ShareSnapshotsController, self).__init__() self.share_api = share.API() @wsgi.serializers(xml=SnapshotTemplate) def show(self, req, id): """Return data about the given snapshot.""" context = req.environ['cinder.context'] try: snapshot = self.share_api.get_snapshot(context, id) except exception.NotFound: raise exc.HTTPNotFound() return self._view_builder.detail(req, snapshot) def delete(self, req, id): """Delete a snapshot.""" context = req.environ['cinder.context'] LOG.audit(_("Delete snapshot with id: %s"), id, context=context) try: snapshot = self.share_api.get_snapshot(context, id) self.share_api.delete_snapshot(context, snapshot) except exception.NotFound: raise exc.HTTPNotFound() return webob.Response(status_int=202) @wsgi.serializers(xml=SnapshotsTemplate) def index(self, req): """Returns a summary list of snapshots.""" return self._get_snapshots(req, is_detail=False) @wsgi.serializers(xml=SnapshotsTemplate) def detail(self, req): """Returns a detailed list of snapshots.""" return self._get_snapshots(req, is_detail=True) def _get_snapshots(self, req, is_detail): """Returns a list of snapshots.""" context = req.environ['cinder.context'] search_opts = {} search_opts.update(req.GET) # NOTE(rushiagr): v2 API allows name instead of display_name if 'name' in search_opts: search_opts['display_name'] = search_opts['name'] del search_opts['name'] shares.remove_invalid_options(context, search_opts, self._get_snapshots_search_options()) snapshots = self.share_api.get_all_snapshots(context, search_opts=search_opts) limited_list = common.limited(snapshots, req) if is_detail: snapshots = self._view_builder.detail_list(req, limited_list) else: snapshots = self._view_builder.summary_list(req, limited_list) return snapshots def _get_snapshots_search_options(self): """Return share search options allowed by non-admin.""" return ('name', 'status', 'share_id') @wsgi.response(202) @wsgi.serializers(xml=SnapshotTemplate) def create(self, req, body): """Creates a new snapshot.""" context = req.environ['cinder.context'] if not self.is_valid_body(body, 'share-snapshot'): raise exc.HTTPUnprocessableEntity() snapshot = body['share-snapshot'] share_id = snapshot['share_id'] share = self.share_api.get(context, share_id) msg = _("Create snapshot from share %s") LOG.audit(msg, share_id, context=context) # NOTE(rushiagr): v2 API allows name instead of display_name if 'name' in snapshot: snapshot['display_name'] = snapshot.get('name') del snapshot['name'] # NOTE(rushiagr): v2 API allows description instead of # display_description if 'description' in snapshot: snapshot['display_description'] = snapshot.get('description') del snapshot['description'] new_snapshot = self.share_api.create_snapshot( context, share, snapshot.get('display_name'), snapshot.get('display_description')) return self._view_builder.summary(req, dict(new_snapshot.iteritems())) class Share_snapshots(extensions.ExtensionDescriptor): """Enable share snapshtos API.""" name = 'ShareSnapshots' alias = 'share-snapshots' namespace = '' updated = '2013-03-01T00:00:00+00:00' def get_resources(self): controller = ShareSnapshotsController() resource = extensions.ResourceExtension( 'share-snapshots', controller, collection_actions={'detail': 'GET'}) return [resource]