本文档旨在提供关于 API 扩展的指导。
请参阅关于 API 可发现性 和 确保 API 互操作性 的相关文档。
API 扩展有时被用于为单个 OpenStack 部署添加自定义功能。 不建议使用它们,因为使用它们会破坏该云与其他 OpenStack 部署之间的互操作性。
如果部署需要通过 HTTP API 实现自定义行为,则应将其在与现有 OpenStack 服务分离的服务中实现。
那些根据驱动程序是否存在来支持不同功能的项目,应努力将这些差异限制在表示对象的值(而非键)中。 基于不同驱动程序在服务中拥有不同的 URL 会破坏互操作性。 如果绝对需要这种功能,则至关重要的是该功能可以通过能力 API 进行发现。
注意
目前,能力发现的标准和最佳实践尚未定义。