API 扩展

本文档旨在提供关于 API 扩展的指导。

请参阅关于 API 可发现性 和 确保 API 互操作性 的相关文档。

指导

API 扩展有时被用于向 OpenStack 的单个部署中添加自定义功能。 不建议使用它们，因为使用它们会破坏该云与其他 OpenStack 部署之间的互操作性。

如果部署需要在 HTTP API 上实现自定义行为，则应将其在与现有 OpenStack 服务分离的服务中实现。

那些根据驱动程序是否存在来支持不同功能的项目，应努力将这些差异限制在表示对象的值（而非键）中。 基于不同驱动程序在服务中拥有不同的 URL 会破坏互操作性。 如果绝对需要这种功能，那么通过能力 API 使该功能可发现至关重要。

注意

目前，能力发现的标准和最佳实践尚未定义。