1985e16d2e
blueprint quantum-nec-openflow-plugin Change-Id: Ib6d6f658bbf6d653527fa7820685f9bed1412a18
104 lines
3.7 KiB
Python
104 lines
3.7 KiB
Python
# vim: tabstop=4 shiftwidth=4 softtabstop=4
|
|
#
|
|
# Copyright 2012 NEC Corporation. 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.
|
|
# @author: Ryota MIBU
|
|
|
|
from abc import ABCMeta, abstractmethod
|
|
|
|
|
|
class OFCDriverBase(object):
|
|
"""OpenFlow Controller (OFC) Driver Specification.
|
|
|
|
OFCDriverBase defines the minimum set of methods required by this plugin.
|
|
It would be better that other methods like update_* are implemented.
|
|
"""
|
|
|
|
__metaclass__ = ABCMeta
|
|
|
|
@abstractmethod
|
|
def create_tenant(self, description, tenant_id=None):
|
|
"""Create a new tenant at OpenFlow Controller.
|
|
|
|
:param description: A description of this tenant.
|
|
:param tenant_id: A hint of OFC tenant ID.
|
|
A driver could use this id as a OFC id or ignore it.
|
|
:returns: ID of the tenant created at OpenFlow Controller.
|
|
:raises: quantum.plugin.nec.common.exceptions.OFCException
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def delete_tenant(self, ofc_tenant_id):
|
|
"""Delete a tenant at OpenFlow Controller.
|
|
|
|
:raises: quantum.plugin.nec.common.exceptions.OFCException
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def create_network(self, ofc_tenant_id, description, network_id=None):
|
|
"""Create a new network on specified OFC tenant at OpenFlow Controller.
|
|
|
|
:param ofc_tenant_id: a OFC tenant ID in which a new network belongs.
|
|
:param description: A description of this network.
|
|
:param network_id: A hint of a OFC network ID.
|
|
:returns: ID of the network created at OpenFlow Controller.
|
|
:raises: quantum.plugin.nec.common.exceptions.OFCException
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def update_network(self, ofc_tenant_id, ofc_network_id, description):
|
|
"""Update description of specified network.
|
|
|
|
:raises: quantum.plugin.nec.common.exceptions.OFCException
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def delete_network(self, ofc_tenant_id, ofc_network_id):
|
|
"""Delete a netwrok at OpenFlow Controller.
|
|
|
|
:raises: quantum.plugin.nec.common.exceptions.OFCException
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def create_port(self, ofc_tenant_id, ofc_network_id, portinfo,
|
|
port_id=None):
|
|
"""Create a new port on specified tenant and network at OFC.
|
|
|
|
:param ofc_network_id: a OFC tenant ID in which a new port belongs.
|
|
:param portinfo: An OpenFlow information of this port.
|
|
{'datapath_id': Switch ID that a port connected.
|
|
'port_no': Port Number that a port connected on a Swtich.
|
|
'vlan_id': VLAN ID that a port tagging.
|
|
'mac': Mac address.
|
|
}
|
|
:param port_id: A hint of a OFC port ID.
|
|
|
|
:returns: ID of the port created at OpenFlow Controller.
|
|
:raises: quantum.plugin.nec.common.exceptions.OFCException
|
|
"""
|
|
pass
|
|
|
|
@abstractmethod
|
|
def delete_port(self, ofc_tenant_id, ofc_network_id, ofc_port_id):
|
|
"""Delete a port at OpenFlow Controller.
|
|
|
|
:raises: quantum.plugin.nec.common.exceptions.OFCException
|
|
"""
|
|
pass
|