# Copyright (C) 2013 Nippon Telegraph and Telephone Corporation. # # 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 json from os_ken.app.wsgi import ControllerBase from os_ken.app.wsgi import Response from os_ken.app.wsgi import route from os_ken.app.wsgi import WSGIApplication from os_ken.base import app_manager from os_ken.lib import dpid as dpid_lib from os_ken.topology.api import get_switch, get_link, get_host # REST API for switch configuration # # get all the switches # GET /v1.0/topology/switches # # get the switch # GET /v1.0/topology/switches/ # # get all the links # GET /v1.0/topology/links # # get the links of a switch # GET /v1.0/topology/links/ # # get all the hosts # GET /v1.0/topology/hosts # # get the hosts of a switch # GET /v1.0/topology/hosts/ # # where # : datapath id in 16 hex class TopologyAPI(app_manager.OSKenApp): _CONTEXTS = { 'wsgi': WSGIApplication } def __init__(self, *args, **kwargs): super(TopologyAPI, self).__init__(*args, **kwargs) wsgi = kwargs['wsgi'] wsgi.register(TopologyController, {'topology_api_app': self}) class TopologyController(ControllerBase): def __init__(self, req, link, data, **config): super(TopologyController, self).__init__(req, link, data, **config) self.topology_api_app = data['topology_api_app'] @route('topology', '/v1.0/topology/switches', methods=['GET']) def list_switches(self, req, **kwargs): return self._switches(req, **kwargs) @route('topology', '/v1.0/topology/switches/{dpid}', methods=['GET'], requirements={'dpid': dpid_lib.DPID_PATTERN}) def get_switch(self, req, **kwargs): return self._switches(req, **kwargs) @route('topology', '/v1.0/topology/links', methods=['GET']) def list_links(self, req, **kwargs): return self._links(req, **kwargs) @route('topology', '/v1.0/topology/links/{dpid}', methods=['GET'], requirements={'dpid': dpid_lib.DPID_PATTERN}) def get_links(self, req, **kwargs): return self._links(req, **kwargs) @route('topology', '/v1.0/topology/hosts', methods=['GET']) def list_hosts(self, req, **kwargs): return self._hosts(req, **kwargs) @route('topology', '/v1.0/topology/hosts/{dpid}', methods=['GET'], requirements={'dpid': dpid_lib.DPID_PATTERN}) def get_hosts(self, req, **kwargs): return self._hosts(req, **kwargs) def _switches(self, req, **kwargs): dpid = None if 'dpid' in kwargs: dpid = dpid_lib.str_to_dpid(kwargs['dpid']) switches = get_switch(self.topology_api_app, dpid) body = json.dumps([switch.to_dict() for switch in switches]) return Response(content_type='application/json', body=body) def _links(self, req, **kwargs): dpid = None if 'dpid' in kwargs: dpid = dpid_lib.str_to_dpid(kwargs['dpid']) links = get_link(self.topology_api_app, dpid) body = json.dumps([link.to_dict() for link in links]) return Response(content_type='application/json', body=body) def _hosts(self, req, **kwargs): dpid = None if 'dpid' in kwargs: dpid = dpid_lib.str_to_dpid(kwargs['dpid']) hosts = get_host(self.topology_api_app, dpid) body = json.dumps([host.to_dict() for host in hosts]) return Response(content_type='application/json', body=body)