# Copyright (c) 2014 Red Hat, Inc. # # 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. import falcon import jsonschema from oslo_log import log import six from zaqar.common.api.schemas import flavors as schema from zaqar.common import utils as common_utils from zaqar.i18n import _ from zaqar.storage import errors from zaqar.transport import utils as transport_utils from zaqar.transport.wsgi import errors as wsgi_errors from zaqar.transport.wsgi import utils as wsgi_utils LOG = log.getLogger(__name__) class Listing(object): """A resource to list registered flavors :param flavors_controller: means to interact with storage """ def __init__(self, flavors_controller): self._ctrl = flavors_controller def on_get(self, request, response, project_id): """Returns a flavor listing as objects embedded in an object: :: { "flavors": [ {"href": "", "capabilities": {}, "pool": ""}, ... ], "links": [ {"rel": "next", "href": ""}, ... ] } :returns: HTTP | 200 """ LOG.debug(u'LIST flavors for project_id %s' % project_id) store = {} request.get_param('marker', store=store) request.get_param_as_int('limit', store=store) request.get_param_as_bool('detailed', store=store) cursor = self._ctrl.list(project=project_id, **store) flavors = list(next(cursor)) results = {'links': []} if flavors: store['marker'] = next(cursor) for entry in flavors: entry['href'] = request.path + '/' + entry['name'] # NOTE(wanghao): remove this in Newton. entry['pool'] = entry['pool_group'] results['links'] = [ { 'rel': 'next', 'href': request.path + falcon.to_query_str(store) } ] results['flavors'] = flavors response.body = transport_utils.to_json(results) response.status = falcon.HTTP_200 class Resource(object): """A handler for individual flavor. :param flavors_controller: means to interact with storage """ def __init__(self, flavors_controller): self._ctrl = flavors_controller validator_type = jsonschema.Draft4Validator self._validators = { 'create': validator_type(schema.create), 'pool_group': validator_type(schema.patch_pool_group), # NOTE(wanghao): Remove this in Newton. 'pool': validator_type(schema.patch_pool), 'capabilities': validator_type(schema.patch_capabilities), } def on_get(self, request, response, project_id, flavor): """Returns a JSON object for a single flavor entry: :: {"pool_group": "", capabilities: {...}} :returns: HTTP | [200, 404] """ LOG.debug(u'GET flavor - name: %s', flavor) data = None detailed = request.get_param_as_bool('detailed') or False try: data = self._ctrl.get(flavor, project=project_id, detailed=detailed) # NOTE(wanghao): remove this in Newton. data['pool'] = data['pool_group'] except errors.FlavorDoesNotExist as ex: LOG.debug(ex) raise wsgi_errors.HTTPNotFound(six.text_type(ex)) data['href'] = request.path response.body = transport_utils.to_json(data) def on_put(self, request, response, project_id, flavor): """Registers a new flavor. Expects the following input: :: {"pool_group": "my-pool-group", "capabilities": {}} A capabilities object may also be provided. :returns: HTTP | [201, 400] """ LOG.debug(u'PUT flavor - name: %s', flavor) data = wsgi_utils.load(request) wsgi_utils.validate(self._validators['create'], data) pool_group = data.get('pool_group') or data.get('pool') try: self._ctrl.create(flavor, pool_group=pool_group, project=project_id, capabilities=data['capabilities']) response.status = falcon.HTTP_201 response.location = request.path except errors.PoolGroupDoesNotExist as ex: LOG.exception(ex) description = (_(u'Flavor %(flavor)s could not be created. ' u'Pool group %(pool_group)s does not exist') % dict(flavor=flavor, pool_group=pool_group)) raise falcon.HTTPBadRequest(_('Unable to create'), description) def on_delete(self, request, response, project_id, flavor): """Deregisters a flavor. :returns: HTTP | [204] """ LOG.debug(u'DELETE flavor - name: %s', flavor) self._ctrl.delete(flavor, project=project_id) response.status = falcon.HTTP_204 def on_patch(self, request, response, project_id, flavor): """Allows one to update a flavors's pool and/or capabilities. This method expects the user to submit a JSON object containing at least one of: 'pool_group', 'capabilities'. If none are found, the request is flagged as bad. There is also strict format checking through the use of jsonschema. Appropriate errors are returned in each case for badly formatted input. :returns: HTTP | [200, 400] """ LOG.debug(u'PATCH flavor - name: %s', flavor) data = wsgi_utils.load(request) EXPECT = ('pool_group', 'capabilities', 'pool') if not any([(field in data) for field in EXPECT]): LOG.debug(u'PATCH flavor, bad params') raise wsgi_errors.HTTPBadRequestBody( 'One of `pool_group` or `capabilities` or `pool` needs ' 'to be specified' ) for field in EXPECT: wsgi_utils.validate(self._validators[field], data) fields = common_utils.fields(data, EXPECT, pred=lambda v: v is not None) # NOTE(wanghao): remove this in Newton. if fields.get('pool') and fields.get('pool_group') is None: fields['pool_group'] = fields.get('pool') fields.pop('pool') try: self._ctrl.update(flavor, project=project_id, **fields) except errors.FlavorDoesNotExist as ex: LOG.exception(ex) raise wsgi_errors.HTTPNotFound(six.text_type(ex))