扩展 OpenStack 的 REST API 的方法

原文来自：扩展 OpenStack 的 REST API 的方法

以Nova REST API为例, 你应该按照以下步骤来扩展 Nova REST API

(使用 类nova.api.openstack.compute.contrib.floating_ips.Floating_ips 作为例子)

1. 创建一个新的extension 子类. Extension子类应该派生于“nova.api.openstack.extensions ExtensionDescriptor”

以 Floating_ips 类为例

2. 在 Nova API 中 添加一个新的资源类型

在Floating_ips 类中

• 覆写父类中的方法 “get_resources()”
• 在方法 “get_resources()” 中,,返回 ResourceExtensions 列表, 来注册你的新的 资源类型 / URL路径 / Controller 等等

例如, 以下代码会创建一个新的资源类型 “os-floating-ips”.

    def get_resources(self):        resources = []        res =extensions.ResourceExtension('os-floating-ips',                        FloatingIPController(),                        member_actions={})       resources.append(res)        return resources

新资源 “os-floating-ips” 会和以下URL匹配.

3. 为Nova API中已有的资源类型, 添加新的 controller 方法

在Floating_ips 类中

• 覆写父类中的方法 “get_controller_extensions”
• 在函数 “get_controller_extensions”,中 返回一系列controller列表

例如, 以下代码会为 已有资源“servers” 添加新的

controller(/opt/stack/nova/nova/api/openstack/compute/servers.py)    defget_controller_extensions(self):        controller =FloatingIPActionController(self.ext_mgr)        extension =extensions.ControllerExtension(self, 'servers',controller)        return [extension]

新的controller会和以下URL匹配

4. 注册我们的extension 子类到Nova API中

• Extension Module 命名规则
  比如我们的extension子类名字叫: classFloating_ips(extensions.ExtensionDescriptor):
  那么Python module的文件名就要叫(注意全部小写): floating_ips.py

• Extension Module 位置
  把新的module文件放到路径 “/opt/stack/nova/nova/api/openstack/compute/contrib/”
  e.g /opt/stack/nova/nova/api/openstack/compute/contrib/floating_ips.py
  Nova API会在启动时, 自动发现我们的extension, 并进行注册