88 Commits

Author SHA1 Message Date
Mark Goddard
5a14eed467 Deploy steps - API & notifications
Adds a 'deploy_step' field to the nodes API.

Co-Authored-By: Ruby Loo <rloo@oath.com>

Change-Id: I1baeeaaa6ed521e4189958fd7624cd6c5de96707
Story: #1753128
Task: #22592
2018-07-11 16:19:31 +00:00
Dongcan Ye
e2899de09d Fix list node vifs api error
The node_ident param should in Request, this patch fix it.

Change-Id: Id70533ff75e0f7b7930725fd74428c390321b98d
2018-07-03 11:23:25 +00:00
Zuul
231cef47fb Merge "Modify the Ironic api-ref's parameters in parameters.yaml" 2018-06-22 01:39:06 +00:00
Sam Betts
233d7d5727 Add detail=[True, False] query string to API list endpoints
We currently support /[nodes, ports, portgroups, chassis]/detail as an
API endpoint for getting a detailed list of each object. This does not
fit the RESTful and resourceful API design principles of <resource
type>/<resource id> and makes it hard to consume the API from frameworks
that expect that structure. We can't remove the old endpoint, so that is
safeguarded by the restricted node names list. This patch adds a
?detail=[True, False] query string to the list API endpoints to allow
those consuming the API to use the expected URL form.

Change-Id: I694919b4a4eaa3419318bbee1cde79de15e19afa
Story: #1662921
Task: #10176
2018-06-18 19:40:07 +00:00
shuangyang.qian
d0dca903df Modify the Ironic api-ref's parameters in parameters.yaml
Separate parameter identifiers in case when a parameter
is required in the request or response.
This patch adjusts the relevant *.nic file to fix the problem.

Change-Id: Ie2c8cae2280fc1e92a5e6f3fef4f2783a12a2c3f
Story: #1651775
Task: #10160
2018-06-14 10:45:48 +08:00
Kaifeng Wang
8ee2f4b58f Power fault recovery follow up
This patch addresses comments relate to API and notification.

[1] https://review.openstack.org/#/c/558152
[2] https://review.openstack.org/#/c/556015/

Story: #1596107
Task: #10469

Change-Id: Ic2f7e6847790ae7af43570ca7af572539e7d5f2c
2018-06-06 13:20:55 +00:00
Kaifeng Wang
b4c4eb99fc Power fault recovery: API implementation
This patch exposes fault field to the API node object,
microversion and compatibility is handled.

Story: #1596107
Task: #10469

Change-Id: I31ed332be12cf98baaf01badcbb09ae4b8c6cae9
Partial-Bug: #1596107
2018-06-01 20:10:25 +08:00
fpxie
36ac2988db Add more parameter explanation when create a node
Change-Id: I8035546a21bf55af5df09aca3038ff377e0758a7
2018-04-20 08:33:17 +08:00
John L. Villalovos
6b91ba21df Resolve pep8 E402 errors and no longer ignore E402
Fix the pep8 E402 (Module level import not at top of file) errors.

For the Alembic files move the definitions of 'revision' and
'down_revision' below the imports. This is now done in Alembic [1]

For other files fix as needed by moving the imports or lines before
the imports.

In a few cases add a "# noqa E402" to whitelist the issue.

[1] dc2aae0374

Change-Id: I48c96d5da0cb747b3ca3fceea9b4ffa85a9ebe22
2018-04-10 17:34:04 -07:00
melissaml
9ea09fca8a Update and replace http with https for doc links
1) Use https instead of http for docs links
2) Update doc links according to OpenStack document migration

Change-Id: Ib9b2fa3b699de361d47aa80d07cdf76b7a1eb143
2018-04-04 22:14:26 +08:00
Zuul
6cbcdaee4e Merge "Add Error Codes" 2018-03-16 15:54:32 +00:00
Zuul
22da631f9c Merge "Remove the deprecated "giturl" option" 2018-03-12 23:15:34 +00:00
wangqi
c6f8d85852 fix a typo in driver-property-response.json: s/doman/domain/
Change-Id: I43fe909213c07f13b7e740c0bfa84ed5cef68cd1
2018-02-26 06:58:44 +00:00
MaoyangLiu
a0e1131b0c Replace chinese quotes to English quotes
Change-Id: Ica91e88cbb4e51ef591bf748273a2ca3334aa071
2018-02-06 17:43:45 +08:00
Zuul
3d38fd2bbd Merge "Follow-up patch for api-ref documentation for rescue" 2018-02-03 16:35:40 +00:00
Shivanand Tendulker
8010b07076 Follow-up patch for api-ref documentation for rescue
This patch addresses outstanding comments for commit
9a6c62dd8e54bb07f4ca4da0b4c3c4e71ebf7971

Change-Id: I3072f36a57cfd4d4963d5aa0bd2a60888df4d587
Related-Bug: #1526449
2018-02-02 10:05:47 -05:00
Zuul
193606f0ce Merge "Update api-ref for port group create" 2018-02-02 14:48:04 +00:00
Zuul
fe5063a867 Merge "[api-ref] clarify what /v1/lookup returns" 2018-02-02 00:38:40 +00:00
Zuul
3ac9166298 Merge "Add api-ref and ironic state documentation for rescue" 2018-02-01 20:38:37 +00:00
Ruby Loo
2166974f28 [api-ref] clarify what /v1/lookup returns
Update the api-ref documentation for the /v1/lookup API, so that
it mentions the node fields that are returned. It does not return
the configdrive value (that is bleeped out in the response).

Change-Id: I24a47a2cfefc582bd0b5f1f0068e89a3091cf397
2018-01-31 15:48:47 -05:00
Mario Villaplana
9a6c62dd8e Add api-ref and ironic state documentation for rescue
This patch adds following:
  - Updates ironic state documentation with rescue related states
  - Updates api-ref with rescue interface fields introduced in
    API version 1.38

Co-Authored-By: Mario Villaplana <mario.villaplana@gmail.com>
Co-Authored-By: Aparna <aparnavtce@gmail.com>
Co-Authored-By: Shivanand Tendulker <stendulker@gmail.com>

Partial-Bug: 1526449

Change-Id: Ifcfa52ede62894b1990aaa640944be3431ddfe8f
2018-01-31 04:08:07 -05:00
Mark Goddard
00daa18fc9 Add documentation for node traits
Updates the install and admin guides with information on node traits.

Support for node traits was added in Bare Metal REST API version 1.37.

Change-Id: I86e86320df4eb81aa30e5708dde9c82f50ba4d50
Depends-On: https://review.openstack.org/#/c/532288/
Partial-Bug: #1722194
2018-01-30 15:50:55 +00:00
Kaifeng Wang
0386a4f966 Update api-ref for port group create
Update the facts that name and MAC address is not mandatory when
creating port groups.

Change-Id: I214cdab5789923341cdb2100b425958df6053d68
2018-01-25 16:41:55 +08:00
Mark Goddard
223e9b1faa Add node traits to API reference
The node traits API was added in API microversion 1.37.

Change-Id: I8c48f2e7662ae9641ec823dc3802d5979a7ea03e
Partial-Bug: #1722194
2018-01-25 01:36:54 +00:00
zhang.lei
c934ae5da2 Remove the deprecated "giturl" option
From openstackdocstheme 1.18.0, valid Git URLs can be retrieved by
openstackdocstheme[1], we do not need giturl option anymore.

[1] https://review.openstack.org/532163

Change-Id: I1725e25dd13bfe14c83f3f679092fc36fa6cb208
2018-01-15 03:45:33 +00:00
Zuul
2c13e4157d Merge "Add a provisioning target:adopt" 2018-01-08 16:11:53 +00:00
fpxie
e038b67cd5 Add Error Codes
Add error codes when creates a new node resource

Change-Id: Id36590746ce3fdbf147bbb342fddda96b40c68b7
2018-01-08 00:27:11 +00:00
fpxie
7490b6e743 Add a provisioning target:adopt
Change-Id: If6c8b18b41c1fe3f2868c4b144402d4a031ee957
2018-01-04 15:29:49 +08:00
Sam Betts
b642f28be4 Receive and store agent version on heartbeat
This patch enables receiving agent_version as part of heartbeat, and
stores this information on driver_internal_info. This is so that Ironic
can dynamically adjust which features and parameters it uses based on
which version of the agent is being used.

Change-Id: I400adba5d908b657751a83971811e8586f46c673
Partial-Bug: #1602265
2017-12-11 16:25:47 +00:00
Ruby Loo
c7e7d3076d update description for Change Node Power State
This updates the description of the
'PUT /v1/nodes/{node_ident}/states/power' request to mention that
Bare Metal API version 1.27 was when:
- the 'timeout' parameter was added
- the 'soft power off' and 'soft rebooting' values were made available
  for the 'target' parameter

Change-Id: I1c720a2dd15eab1246ad672b9d7f2b8708ceec0b
2017-11-14 17:47:01 -05:00
shuangyang.qian
ff0970f308 Make the api format correctly
make the format of the api:"Detach VIF from
a node" normally and add the Request header
of the parameters' table.

Change-Id: Ica77a99439d9819f629c7f64c2906e5aa2cb5ddc
2017-11-08 19:00:39 +08:00
Zuul
896462138c Merge "Add ability to provide configdrive when rebuilding" 2017-11-01 22:27:16 +00:00
Zuul
a710321f7d Merge "Update validating node information docs" 2017-10-24 14:06:08 +00:00
Nguyen Van Trung
b219699e9d Update validating node information docs
eg:
    +------------+--------+--------+
    | Interface  | Result | Reason |
    +------------+--------+--------+
    | boot       | True   |        |
    | console    | True   |        |
    | deploy     | True   |        |
    | inspect    | True   |        |
    | management | True   |        |
    | network    | True   |        |
    | power      | True   |        |
    | raid       | True   |        |
    | storage    | True   |        |
    +------------+--------+--------+

Change-Id: I7f93b866cf4b50047e8666c3c5c01a201f18ef4b
2017-10-23 13:29:08 +07:00
Mathieu Gagné
6a8b38a2ca Add ability to provide configdrive when rebuilding
Previously, the configdrive could only be set when setting
the node's provisioning state to "active". When rebuilding,
the old configdrive was used and therefore was never updated
with latest content.

This change introduces the API microversion 1.35 which will allow
configdrive to be provided when setting the node's provisioning state
to "rebuild".

Closes-bug: #1575935
Change-Id: I9a5529f9fa796c75621e9f4354886bf3032cc248
2017-10-19 13:07:03 -04:00
Ruby Loo
738eac1ba6 api-ref portgroup_id should be portgroup_ident
A portgroup can be identified by a UUID or a name, so we
should be consistent and use 'portgroup_ident' instead of
'portgroup_id' in the API ref. (Similar to how we use
'node_ident'.)

Change-Id: I5b2ddd7e47e02281d62ae90f0e7f4a32af802982
2017-09-19 17:19:49 -04:00
Sam Betts
bca44bcefc Switch API ref to use versionadded syntax throughout
Sphinx provides the versionadded syntax for indicating version related
changes in documentation, the OpenStack doc theme is designed to handle
this and render it nicely. This patch switches our inconsistent
references to API version related change in the API ref to use this
syntax so that it standardised through out the docs, and is more obvious
in the documentation itself.

Change-Id: Ied6f22deecebd71042d2230b81e057543db3d3f4
2017-09-05 17:27:24 +01:00
Hironori Shiina
05d85dd8bb Add storage interface to api-ref
This patch adds these storage interface fields to api-ref:
  - storage_interface of Node
  - default_storage_interface of Driver
  - enabled_storage_interfaces of Driver
These fields were introdeced with API version 1.33.

Change-Id: Iac73d7ae4976dfd437b9821a2221dd842be24b55
Partial-Bug: #1559691
2017-08-02 12:49:07 +00:00
Hironori Shiina
7317c17e4e Add API for volume resources to api-ref
This patch adds API for volume resources to api-ref.

Partial-Bug: 1526231
Change-Id: I986860cffd344f5cea9f8f5a2f845f77bf6e9e54
2017-08-02 12:46:36 +00:00
Mark Goddard
2e51f95263 Improve ports API reference
Currently there are a few missing fields and API microversion notes
in the ports API reference. This change resolves those issues. All
ports microversion notes have been changed to use the active voice.

Change-Id: If16c8e311e439e88fbbdd693c12e0f7992af5044
2017-07-20 09:13:17 +01:00
Mark Goddard
02fff930fb Expose ports' physical network attribute in API
In change Ib22753aa6ae0fedce7fb9ecf63f135fda0185c5b the port data model
was updated to include a physical_network field, but this was not
exposed to the user by the REST API. This change exposes the
physical_network field in the REST API.

The port CRUD notification object has been updated to include the
physical_network field.

The API reference and user guide have been updated to include
information about the ports' physical network field.

The API microversion has been bumped to 1.34. During a rolling upgrade
from Ocata when the API service is pinned, the port physical network
field is hidden from API responses, and API requests including the field
are rejected.

Change-Id: I7023a1d6618608c867c31396fa677d3016ca493e
Partial-Bug: #1666009
2017-07-19 17:29:20 +01:00
Sam Betts
5647bfc246 Move doc/source/dev to doc/source/contributor
Change-Id: I6a3d143cff31348c62d8825f29f7484bafb9c8f0
2017-07-06 12:59:24 +01:00
Sam Betts
02015a4be6 Move operator docs into into doc/source/admin
Change-Id: I13f90a0b183b7799b4c8b5c340052d96f717fa9f
2017-07-05 12:16:37 +01:00
Kyrylo Romanenko
ab29dccead Fix quotes in documentation and schema description
Fix example of RAID configuration by removing wrong quotes.
Add missing quote in RAID config schema description.

Closes-Bug: #1702129
Change-Id: I2012e3968a0fccec0df1f4de3f682ab97aa1b8ac
2017-07-03 19:32:26 +03:00
Ruby Loo
24006badee Remove remaining vendor passthru lookup/heartbeat
Vendor-passthru lookup and heartbeat was mostly removed (in
5eb4ba26ddbde97758511c9b61046e5a879ab66c). This removes the
remaining code and references to them.

Change-Id: I6b214503999ce1892f10f4507a6063b6e8d604bc
Related-Bug: #1640533
2017-05-17 15:03:39 -04:00
Luong Anh Tuan
51bf6b2148 Remove single quoted strings in json sample
Json standard does not allow single quoted strings. Thus I replace
" instead of '.

Change-Id: Ifbb9e1a62706dcfa539f12e38eec0f5ca8ae1422
2017-05-17 23:50:09 +07:00
Ruby Loo
bbb8d3d005 [api-ref] remove reference to old lookup/heartbeat
Vendor-passthru lookup and heartbeat have been removed (in
5eb4ba26ddbde97758511c9b61046e5a879ab66c). This removes references
to them.

Change-Id: I3565999f129cf88c2aa5f04bbf27eaa0da6dc588
Related-Bug: #1640533
2017-04-27 16:48:45 -04:00
Jim Rollenhagen
73328060cc Fix API doc URL in GET / response
The existing URL has a redirect to another URL[0], which has a message
that it has been moved to yet another URL[1]. Fix it so it's just one link.
Also use https while we're in here.

[0] https://docs.openstack.org/developer/ironic/webapi/v1.html
[1] https://docs.openstack.org/developer/ironic/dev/webapi.html

Change-Id: I900e0a7ad84dfcfeb551d4836bf156790706803c
2017-03-15 19:05:54 -04:00
wangkf
72abce14b0 Fix typos of filename in api-ref
Typo is fixed and port-list-response.json is updated.

Closes-Bug: 1672358

Change-Id: Iffe385d705e607966ac00455d56aaac85a1a1e69
2017-03-14 19:35:53 +08:00
Jenkins
2b10dd8bfc Merge "Update api-ref for dynamic drivers" 2017-02-10 13:01:20 +00:00