Management API: /hosts collection

Registered by Glen Campbell on 2011-03-07

The /hosts collection returns information on all hosts in a specific Nova zone. Likewise, the /hosts/{id} URI returns information on a single host. Service providers and other cloud administrators require information at the physical host level to better manage their deployments and services. Currently, there are no API resources that actually return information on a specific host.

One issue with the development of a /hosts API is that many of the desired functions are, in large part, specific to a single hypervisor. Thus, we propose a lightweight API collection that can be implemented as API extensions. The long-term goal is to create a hypervisor-independent mechanism for managing hosts. The API should permit introspection and reveal which of these generic functions are supported for a specific host.

In addition to /hosts, /hosts/{id}, we also propose /hosts/{id}/actions as a way of performing specific actions on a host. The initial proposal is to permit rebooting the host via the API, but additional functions could easily be defined.

This blueprint is a requirement for Rackspace implementation of Nova, but may initially be implemented as API extensions that can be moved into nova-core in the future.

Blueprint information

Status:
Complete
Approver:
Vish Ishaya
Priority:
Undefined
Drafter:
Glen Campbell
Direction:
Approved
Assignee:
Nova API Team
Definition:
Obsolete
Series goal:
None
Implementation:
Unknown
Milestone target:
None
Completed by
Brian Waldon on 2011-12-12

Related branches

Sprints

Whiteboard

It makes sense for this to be part of the Admin API

Actually we're going to abandon this in favor of a service-based approach.

(?)

Work Items

Dependency tree

* Blueprints in grey have been implemented.

This blueprint contains Public information 
Everyone can see this information.