NovaAdminServiceAPI

Launchpad 条目：NovaSpec:admin-service-actions
创建时间：2011年8月18日
贡献者: GlenCampbell

总结

Nova 云管理员需要对特定服务执行操作。例如，主机上磁盘出现故障的计算节点可以置于“维护模式”，以便可以采取措施将活动实例从主机上移走，同时不允许创建任何新实例。此蓝图定义了这些函数以及用于检索 Nova 服务信息的 API。

发布说明

“服务操作”是一个管理 API 扩展，允许检索和管理云部署中的 Nova 服务。

原理

用户故事

作为 Nova 管理员，我需要有关当前运行的服务的信息，并能够对它们执行管理操作，例如启动、停止和暂停它们。

前提条件

这些作为 OS API 1.1 的扩展实现，并且可能在 API 的未来版本中移动到核心。

设计

/services

/services 资源管理当前区域的服务信息集合。（有关更多详细信息，请参阅有关多区域支持的文档；本质上，“当前”区域是 API 端点使用的区域。）

方式	返回值
GET	当前区域中所有服务的集合
PUT	不允许
POST	不允许。
DELETE	不允许

/services/{service_id}

管理单个主机的信息，由 service_id 标识。

方式	返回值
GET	单个服务的整合元数据

/services/{service_id}/actions

与在其他地方定义的其他“…/actions”URL 类似，此 URL 接受 POST 主体中的消息，该消息指定要执行的操作。

服务	操作
计算	PAUSE	限制计算节点接受新的实例创建请求，但允许所有其他请求。还防止任何用户操作发生。
计算	RESUME	将计算节点恢复到完全运行状态

实现

本节应描述实施所讨论更改的行动计划（“如何”）。可以包括诸如

UI 变更

应涵盖对 UI 的要求更改或实施此功能的特定 UI

代码变更

代码变更应包括需要更改的内容的概述，并且在某些情况下甚至包括具体细节。

迁移

包括

数据迁移（如果有）
从旧 URL 到新 URL 的重定向（如果有）
如何引导用户使用新的操作方式（如果需要）。

测试/演示计划

这不必在规范接近 Beta 之前添加或完成。

未解决的问题

这应该突出显示需要在进一步的规范中解决的任何问题，而不是规范本身的问题；因为任何存在问题的规范都无法获得批准。

BoF 议程和讨论

使用本节记录 BoF 期间的笔记；如果将其保留在批准的规范中，请用于总结讨论内容并记录任何被拒绝的选项。