229 lines
9.5 KiB
Python
229 lines
9.5 KiB
Python
# 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.
|
|
|
|
"""
|
|
Version 1 of the Zun API
|
|
|
|
NOTE: IN PROGRESS AND NOT FULLY IMPLEMENTED.
|
|
"""
|
|
|
|
from oslo_log import log as logging
|
|
import pecan
|
|
|
|
from zun.api.controllers import base as controllers_base
|
|
from zun.api.controllers import link
|
|
from zun.api.controllers.v1 import availability_zone as a_zone
|
|
from zun.api.controllers.v1 import capsules as capsule_controller
|
|
from zun.api.controllers.v1 import containers as container_controller
|
|
from zun.api.controllers.v1 import hosts as host_controller
|
|
from zun.api.controllers.v1 import images as image_controller
|
|
from zun.api.controllers.v1 import networks as network_controller
|
|
from zun.api.controllers.v1 import quota_classes as quota_classes_controller
|
|
from zun.api.controllers.v1 import quotas as quotas_controller
|
|
from zun.api.controllers.v1 import registries as registries_controller
|
|
from zun.api.controllers.v1 import zun_services
|
|
from zun.api.controllers import versions as ver
|
|
from zun.api import http_error
|
|
from zun.common.i18n import _
|
|
|
|
LOG = logging.getLogger(__name__)
|
|
|
|
|
|
BASE_VERSION = 1
|
|
|
|
MIN_VER_STR = '%s %s' % (ver.Version.service_string, ver.BASE_VER)
|
|
|
|
MAX_VER_STR = '%s %s' % (ver.Version.service_string, ver.CURRENT_MAX_VER)
|
|
|
|
MIN_VER = ver.Version({ver.Version.string: MIN_VER_STR},
|
|
MIN_VER_STR, MAX_VER_STR)
|
|
MAX_VER = ver.Version({ver.Version.string: MAX_VER_STR},
|
|
MIN_VER_STR, MAX_VER_STR)
|
|
|
|
|
|
class MediaType(controllers_base.APIBase):
|
|
"""A media type representation."""
|
|
|
|
fields = (
|
|
'base',
|
|
'type',
|
|
)
|
|
|
|
|
|
class V1(controllers_base.APIBase):
|
|
"""The representation of the version 1 of the API."""
|
|
|
|
fields = (
|
|
'id',
|
|
'media_types',
|
|
'links',
|
|
'services',
|
|
'containers',
|
|
'images',
|
|
'networks',
|
|
'hosts',
|
|
'capsules',
|
|
'availability_zones',
|
|
'quotas',
|
|
'quota_classes',
|
|
'registries',
|
|
)
|
|
|
|
@staticmethod
|
|
def convert():
|
|
v1 = V1()
|
|
v1.id = "v1"
|
|
v1.links = [link.make_link('self', pecan.request.host_url,
|
|
'v1', '', bookmark=True),
|
|
link.make_link('describedby',
|
|
'https://docs.openstack.org',
|
|
'developer/zun/dev',
|
|
'api-spec-v1.html',
|
|
bookmark=True, type='text/html')]
|
|
v1.media_types = [MediaType(
|
|
base='application/json',
|
|
type='application/vnd.openstack.zun.v1+json')]
|
|
v1.services = [link.make_link('self', pecan.request.host_url,
|
|
'services', ''),
|
|
link.make_link('bookmark',
|
|
pecan.request.host_url,
|
|
'services', '',
|
|
bookmark=True)]
|
|
v1.containers = [link.make_link('self', pecan.request.host_url,
|
|
'containers', ''),
|
|
link.make_link('bookmark',
|
|
pecan.request.host_url,
|
|
'containers', '',
|
|
bookmark=True)]
|
|
v1.images = [link.make_link('self', pecan.request.host_url,
|
|
'images', ''),
|
|
link.make_link('bookmark',
|
|
pecan.request.host_url,
|
|
'images', '',
|
|
bookmark=True)]
|
|
v1.networks = [link.make_link('self', pecan.request.host_url,
|
|
'networks', ''),
|
|
link.make_link('bookmark',
|
|
pecan.request.host_url,
|
|
'networks', '',
|
|
bookmark=True)]
|
|
v1.hosts = [link.make_link('self', pecan.request.host_url,
|
|
'hosts', ''),
|
|
link.make_link('bookmark',
|
|
pecan.request.host_url,
|
|
'hosts', '',
|
|
bookmark=True)]
|
|
v1.availability_zones = [link.make_link('self', pecan.request.host_url,
|
|
'availability_zones', ''),
|
|
link.make_link('bookmark',
|
|
pecan.request.host_url,
|
|
'availability_zones', '',
|
|
bookmark=True)]
|
|
v1.capsules = [link.make_link('self', pecan.request.host_url,
|
|
'capsules', ''),
|
|
link.make_link('bookmark',
|
|
pecan.request.host_url,
|
|
'capsules', '',
|
|
bookmark=True)]
|
|
v1.quotas = [link.make_link('self', pecan.request.host_url,
|
|
'quotas', ''),
|
|
link.make_link('bookmark',
|
|
pecan.request.host_url,
|
|
'quotas', '',
|
|
bookmark=True)]
|
|
v1.quota_classes = [link.make_link('self', pecan.request.host_url,
|
|
'quota_classes', ''),
|
|
link.make_link('bookmark',
|
|
pecan.request.host_url,
|
|
'quota_classes', '',
|
|
bookmark=True)]
|
|
v1.registries = [link.make_link('self', pecan.request.host_url,
|
|
'registries', ''),
|
|
link.make_link('bookmark', pecan.request.host_url,
|
|
'registries', '', bookmark=True)]
|
|
return v1
|
|
|
|
|
|
class Controller(controllers_base.Controller):
|
|
"""Version 1 API controller root."""
|
|
|
|
services = zun_services.ZunServiceController()
|
|
containers = container_controller.ContainersController()
|
|
images = image_controller.ImagesController()
|
|
networks = network_controller.NetworkController()
|
|
hosts = host_controller.HostController()
|
|
availability_zones = a_zone.AvailabilityZoneController()
|
|
capsules = capsule_controller.CapsuleController()
|
|
quotas = quotas_controller.QuotaController()
|
|
quota_classes = quota_classes_controller.QuotaClassController()
|
|
registries = registries_controller.RegistryController()
|
|
|
|
@pecan.expose('json')
|
|
def get(self):
|
|
return V1.convert()
|
|
|
|
def _check_version(self, version, headers=None):
|
|
if headers is None:
|
|
headers = {}
|
|
# ensure that major version in the URL matches the header
|
|
if version.major != BASE_VERSION:
|
|
raise http_error.HTTPNotAcceptableAPIVersion(_(
|
|
"Mutually exclusive versions requested. Version %(ver)s "
|
|
"requested but not supported by this service. "
|
|
"The supported version range is: "
|
|
"[%(min)s, %(max)s].") % {'ver': version,
|
|
'min': MIN_VER_STR,
|
|
'max': MAX_VER_STR},
|
|
headers=headers,
|
|
max_version=str(MAX_VER),
|
|
min_version=str(MIN_VER))
|
|
# ensure the minor version is within the supported range
|
|
if version < MIN_VER or version > MAX_VER:
|
|
raise http_error.HTTPNotAcceptableAPIVersion(_(
|
|
"Version %(ver)s was requested but the minor version is not "
|
|
"supported by this service. The supported version range is: "
|
|
"[%(min)s, %(max)s].") % {'ver': version, 'min': MIN_VER_STR,
|
|
'max': MAX_VER_STR},
|
|
headers=headers,
|
|
max_version=str(MAX_VER),
|
|
min_version=str(MIN_VER))
|
|
|
|
@pecan.expose()
|
|
def _route(self, args):
|
|
version = ver.Version(
|
|
pecan.request.headers, MIN_VER_STR, MAX_VER_STR)
|
|
|
|
# Always set the basic version headers
|
|
pecan.response.headers[ver.Version.min_string] = MIN_VER_STR
|
|
pecan.response.headers[ver.Version.max_string] = MAX_VER_STR
|
|
pecan.response.headers[ver.Version.string] = " ".join(
|
|
[ver.Version.service_string, str(version)])
|
|
pecan.response.headers["vary"] = ver.Version.string
|
|
|
|
# assert that requested version is supported
|
|
self._check_version(version, pecan.response.headers)
|
|
pecan.request.version = version
|
|
if pecan.request.body:
|
|
msg = ("Processing request: url: %(url)s, %(method)s, "
|
|
"body: %(body)s" %
|
|
{'url': pecan.request.url,
|
|
'method': pecan.request.method,
|
|
'body': pecan.request.body})
|
|
LOG.debug(msg)
|
|
|
|
return super(Controller, self)._route(args)
|
|
|
|
|
|
__all__ = ('Controller',)
|