22 Commits

Author SHA1 Message Date
Jenkins
b9fa1172f5 Merge "API to list nodes using the same driver" 2016-03-02 02:38:11 +00:00
Kan
d3859a79ba API to list nodes using the same driver
Add API to list nodes using the same driver.

Change-Id: I998d6a0a6da44487d5ba90dafd417d81d1c7e504
Partial-Bug: #1530626
2016-03-01 09:59:48 +00:00
Ruby Loo
f2d9886f99 Add manual cleaning to documentation
This updates the documentation to include manual cleaning.

Change-Id: I8f91214911e8916c329c20a140e1d0957b1cc137
Partial-Bug: #1526290
2016-02-22 15:46:46 -05:00
Ruby Loo
edc37cbe1d API to manually clean nodes
This adds an API to allow manual cleaning of nodes, via
PUT /v1/nodes/<node_ident>/states/provision. The argument
'target' is 'clean', and the argument 'clean_steps' (the
list of clean steps to be performed on the node) must be
specified.

The API version is bumped to 1.15.

Change-Id: I0e34407133684e34c4ab9446b3521a24f3038f92
Partial-Bug: #1526290
2016-02-09 14:41:01 +00:00
Zhenguo Niu
6bcbe9d477 Remove duplicate words in API version history
Change-Id: I56ad0f4f0adfd70663a720bcd9366d340dff0851
2016-01-21 14:54:20 +08:00
Anusha Ramineni
3274cdeed4 Make end-points discoverable via Ironic API
This commit makes the following API end-points
discoverable via Ironic API
1. '/v1/nodes/<uuid>/states'
2. '/v1/drivers/<driver-name>/properties'

API Micro version is bumped to v1.14 with this change.

Closes-Bug:#1311288
Closes-Bug: #1475744
Co-Authored-By: Lucas Alvares Gomes <lucasagomes@gmail.com>
Change-Id: Ibc0013b8c09c80d90042bf12b31a54820b00b43c
2015-09-22 17:42:17 +01:00
Jenkins
38a4ebcdf8 Merge "Allow abort for CLEANWAIT states" 2015-09-22 02:29:36 +00:00
Lucas Alvares Gomes
795b5e37ca Allow abort for CLEANWAIT states
This patch allows a node in CLEANWAIT to be aborted.

The @clean_step decorator has been extended to accept a new parameter
"abortable". By default this parameter defaults to False since a clean
step could potentially brick a machine so we better make it explicit.

If the clean step is abortable, the process of aborting will happen
immediately; if the clean step is not abortable the abortion will happen
as soon as the clean step is done. If a clean step is marked to have
the abortion done after its completion but it is the final clean step in
the cleaning operation the cleaning process will just finish successfully.

A new verb 'abort' is being added to the API and the microversion is
being bumped to 1.13.

Closes-Bug: #1455825
Change-Id: Ia6846c048b3dab44a8280366a7305aca1d3eb783
2015-09-21 20:07:57 +01:00
Ramakrishnan G
866e70d743 Fix final comments in RAID commits
This commit addresses some of the final comments
in the following commits:
Ifa640d4839b2f08410ceec57c2972e2f9dc69db3
I806f79d997fab6af9a3640fd69815cadec6cae6b

Change-Id: If3d10dbff24f5aabf0c470ba01c03bf428686920
2015-09-21 09:06:34 +00:00
Ruby Loo
bab5f76c38 Document GET ...raid/logical_disk_properties
This adds documentation for the RAID API
GET /v1/drivers/(driver_name)/raid/logical_disk_properties
to Ironic's webapi documentation at
http://docs.openstack.org/developer/ironic/webapi/v1.html#drivers

Change-Id: Iaff3d14a02b507af6cc26fdef79eb58cf3924669
Implements: blueprint ironic-generic-raid-interface
2015-09-16 23:54:49 +00:00
Ramakrishnan G
6c55ef6ba3 Add APIs for RAID configuration
This commit makes the following changes in the Ironic API:

1) Adds PUT /v1/nodes/NNNN/states/raid which helps to set
   node.target_raid_config.

2) Adds GET /v1/drivers/DDDD/raid/logical_disk_properties
   to retrieve the properties for logical disks that can be
   provided for a node with the driver DDD while setting
   target RAID configuration.

3) Modifies the API endpoints GET /v1/nodes/NNNN and
   GET /v1/nodes/NNNN/states to return node.raid_config and
   node.target_raid_config.

It also bumps the API version to 1.12.

APIImpact
DocImpact

Change-Id: I806f79d997fab6af9a3640fd69815cadec6cae6b
Implements: blueprint ironic-generic-raid-interface
2015-09-04 07:37:29 +00:00
Dmitry Tantsur
172512a64a Document API versioning
This change moves documentation of API versioning from inline
comments to our docs.

Change-Id: Iaac7e1178f605956bed5b31998ba4599a1be0750
2015-08-04 12:48:04 +02:00
Ruby Loo
ae521740bd Update API doc to reflect node uuid or name
The RESTful Web API for nodes [1] was showing 'node_uuid', whereas
this can now be node UUID or node name, so it has been changed to
'node_ident' (which is how it is described in the code/docstrings).

[1] http://docs.openstack.org/developer/ironic/webapi/v1.html#nodes

Change-Id: I5cc5b86c5d8b0551a53d1b3b1f002f27e1f290bb
Implements: blueprint logical-names
2015-03-10 13:49:47 +00:00
Ruby Loo
7d6dea06f1 Put nodes-related API in same section
The documentation for our web API (v1) has the nodes-related API
in three different sections: Nodes, NodeStates, and BootDevice.
This makes it difficult to find all the available nodes-related
API.

This puts all the nodes-related API in the same Nodes section,
removing the NodeStates and BootDevice sections.

The ConsoleInfo class/type is included in the documentation as well.

Change-Id: I3bdcb2df13861d3a098b1880062b8115855c28b6
Closes-Bug: #1386291
2014-10-27 16:20:50 +00:00
Ruby Loo
201aec4a96 Add maintenance to RESTful web API documentation
This adds [PUT|DELETE] v1/nodes/(node_uuid)/maintenance
to our RESTful web API documentation. It will show up at

http://docs.openstack.org/developer/ironic/webapi/v1.html#nodes

Change-Id: I42171e429ec72d270b51b246d7c8c6c38fed2e1e
Implements: blueprint maintenance-reason
2014-10-22 14:06:09 +00:00
Yuiko Takada
eb7f075326 Update API document with BootDevice
This patch adds description about above BootDevice Web APIs.
* GET v1/nodes/(node_uuid)/management/boot_device
* GET v1/nodes/(node_uuid)/management/boot_device/supported
* PUT v1/nodes/(node_uuid)/management/boot_device

Change-Id: I2826e59332102b258b72e9850baa1a6b0d189f79
2014-08-15 10:47:21 +09:00
Ruby Loo
ec78868ee0 Update webapi doc with link and console
http://docs.openstack.org/developer/ironic/webapi/v1.html is updated
as follows:
- changes the path descriptor of NodeStates to use '(node_uuid)' instead
  of '<uuid>' to be consistent with other paths
- adds [GET/PUT] /v1/nodes/(node_uuid)/states/console to show how to
  access the node's console
- fixes the "Links" section so that Link information is shown

Change-Id: I9d4a32550b81bb5ccf2fa23d8b591d8a945c04cc
2014-07-10 12:38:38 -04:00
Ruby Loo
3cf57238b7 Document 'POST /v1/.../vendor_passthru'
http://docs.openstack.org/developer/ironic/webapi/v1.html does
not contain anything about how to use vendor passthru endpoints.
This adds 'POST /v1/nodes/(node_uuid)/vendor_passthru' and
'POST /v1/drivers/(driver_name)/vendor_passthru' to that
html page.

Change-Id: I6191be759f168c58e80d946530af7a0c4267501c
Closes-Bug: #1331415
2014-07-09 17:22:17 -04:00
Srinivasa Acharya
79f3780431 Corrects a typo in RESTful Web API (v1) document
The typo /v1/nodes/<uuid>/state is changed to /v1/nodes/<uuid>/states
Closes-Bug: 1311285

Change-Id: I66bc695298c04b423c9c9be45b23fce5b60727f0
2014-05-11 09:21:40 -04:00
Devananda van der Veen
a0a013c927 Some minor clean up of various doc pages
* simplify the links on index.rst
* update the main description on the index page

* move install/ironic-install under deploy/
* rename ironic-install to install-guide
* rename userguide to user-guide
* clarify a few things in the install-guide

Change-Id: Ic6eff035df42d0c3fa78f54eac7ad8322ebb0afc
2014-04-15 12:08:43 -07:00
Matt Wagner
d5b7af3294 Remove errors from API documentation
The API documentation mentions NodePowerState, NodeProvisionState,
and NodeVendorPassthru. They do not exist in the code, and their
entries here are error messages. Remove them.

Change-Id: I48c357cdf5d7ef2149b8af0becb517a578def97a
2014-03-05 19:10:53 -05:00
Devananda van der Veen
30206795b7 Add hooks to auto-generate REST API docs
Add the necessary bits for sphinxcontrib-pecanwsme
so that we can start auto-generating REST API docs.

Change-Id: I6ad61a5185462916865884dd1619465ef90aba0a
Closes-bug: 1251011
2013-11-20 09:25:06 -08:00