summaryrefslogtreecommitdiff
path: root/api-ref
Commit message (Collapse)AuthorAgeFilesLines
* Follow-up to Include bios registry fields in bios APIIury Gregory Melo Ferreira2021-06-011-1/+1
| | | | | | | | This commit is a follow-up to Ie86ec57e428e2bb2efd099a839105e51a94824ab Story: #2008571 Task: #42546 Change-Id: I6fa4658180772ff9c4ff00f95b28cf8a1b5d4223
* Include bios registry fields in bios APIBob Fournier2021-05-275-5/+177
| | | | | | | | | | Provide the fields in the BIOS setting API - ``/v1/nodes/{node}/bios/{setting}``, and in the BIOS setting list API when details are requested - ``/v1/nodes/<node>/bios?detail=True``. Story: #2008571 Task: #42483 Change-Id: Ie86ec57e428e2bb2efd099a839105e51a94824ab
* Add missing bios_interface to api-ref for validate APIBob Fournier2021-05-212-0/+7
| | | | | | | Fixing another case of bios interface missing from the api-ref documentation, this one for the validate API. Change-Id: I8ae3212f04a8d150af8adde5f5f87e5a5451da14
* Add bios_interface to api-ref specBob Fournier2021-05-141-0/+2
| | | | | | | | This is a doc change to add bios_interface to the api reference. Its included in the detailed node list and node show but wasn't shown in the api-ref. Change-Id: I8735d10db1644f8a2c872c75c156c75c06b79c0c
* Bye-bye iSCSI deploy, you served us wellDmitry Tantsur2021-05-043-5/+5
| | | | | | | | | | | | The iSCSI deploy was very easy to start with, but it has since become apparently that it suffers from scalability and maintenance issues. It was deprecated in the Victoria cycle and can now be removed. Hide the guide to upgrade to hardware types since it's very outdated. I had to remove the iBMC diagram since my SVG-fu is not enough to fix it. Change-Id: I2cd6bf7b27fe0be2c08104b0cc37654b506b2e62
* API to force manual cleaning without booting IPADmitry Tantsur2021-03-162-0/+13
| | | | | | | | | | | | | | Adds a new argument disable_ramdisk to the manual cleaning API. Only steps that are marked with requires_ramdisk=False can be run in this mode. Cleaning prepare/tear down is not done. Some steps (like redfish BIOS) currently require IPA to detect a successful reboot. They are not marked with requires_ramdisk just yet. Change-Id: Icacac871603bd48536188813647bc669c574de2a Story: #2008491 Task: #41540
* Add 'deploy steps' parameter for provisioning APIAija Jauntēva2021-02-033-0/+32
| | | | | | Story: 2008043 Task: 40705 Change-Id: I3dc2d42b3edd2a9530595e752895e9d113f76ea8
* Complete the REST API POST documentationSteve Baker2020-12-168-38/+207
| | | | | | | | | | | This change adds missing POST request parameters and makes other minor corrections to the REST API documentation. Its possible that some of the parameters for /v1/nodes were never intended to be available for the POST call, but this docs change is to document what has been implemented, not the original intention. Change-Id: I1e35586d20bd3eda4d727931235340dd408c7508
* Rewrite DHCP-less documentationDmitry Tantsur2020-12-152-2/+7
| | | | | | | | | | | The current documentation is basically unreadable and contains a few factual errors. Rewrite it for simplicity and move to a separate file since at least 2 hardware types claim its support. The patch does not concern the current status of the feature, an easily revertable follow-up will be posted for that. Change-Id: I3404378333316b0736ce07610a1dbbd7847bac00
* Add 'agent_token' to heartbeat requestRuby Loo2020-09-102-0/+11
| | | | | | | | Updates the API ref to include the 'agent_token' value in a heartbeat request (from IPA). New since v1.62 (https://opendev.org/openstack/ironic/src/commit/9341ca4ef726826f4845635e6567a919f2ddc48c/ironic/api/controllers/v1/versions.py#L102). Change-Id: I5eea9704c1bf62561a5505227735159dad7a8e49
* Add api-ref for indicators APIIury Gregory Melo Ferreira2020-06-197-0/+298
| | | | | | Change-Id: Ie40f585b26efdd70b88f2e642698eb9e988e3d97 Story: 2007745 Task: 39923
* Merge "Fix pygments style"Zuul2020-05-211-1/+1
|\
| * Fix pygments stylegugug2020-05-211-1/+1
| | | | | | | | | | | | | | | | New theme of docs respects pygments_style. more info: http://lists.openstack.org/pipermail/openstack-discuss/2020-May/014971.html Change-Id: I5d87b0e4da19a51c47f02e5a88957ce1fea4c21d
* | Merge "Add `network_data` field to ironic node object"Zuul2020-05-196-0/+16
|\ \
| * | Add `network_data` field to ironic node objectIlya Etingof2020-05-056-0/+16
| |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | A new dictionary field `network_data` is added to the node object. This new field can be populated by the operator with node static network configuration. Ironic API now performs formal JSON document validation of node `network_data` field content against user-supplied JSON schema at driver validation step. As of this commit, the new `network_data` field is not actually used by ironic, otherwise it should be perfectly functional. In the following commits, network static configuration will be taken from this field and handed over to ironic ramdisk bootstrapping utilities. Change-Id: I868b3b56a17f59e5aa1494b2e0ebc9c4e34ef173 Story: 2006691 Task: 36991
* | Switch to newer openstackdocstheme and reno versionsAndreas Jaeger2020-05-181-3/+3
|/ | | | | | | | | | | | | | | | | | | Switch to openstackdocstheme 2.2.0 and reno 3.1.0 versions. Using these versions will allow especially: * Linking from HTML to PDF document * parallelizing building of documents Update Sphinx version as well. openstackdocstheme renames some variables, so follow the renames before the next release removes them. A couple of variables are also not needed anymore, remove them. Set openstackdocs_pdf_link to link to PDF file. Set openstackdocs_auto_name to use 'project' as name. Depends-On: https://review.opendev.org/728938 Change-Id: I76a21521eeb432c3f4089048a4635719ba6d785c
* Add node lessee fieldTzu-Mainn Chen2020-04-076-0/+30
| | | | | | | | | | | | This change adds a `lessee` field to nodes, and exposes it to policy. It also updates the non-admin node list API to match for both owner and lessee; and updates the allocation conductor to match owner allocations with nodes with the appropriate lessee. Change-Id: Ib31b49c7143ec8fd6cb486fc24038215b197c418 Story: 2006506 Task: 37930
* Cleanup docs buildingAndreas Jaeger2020-02-291-21/+5
| | | | | | | | | | * Remove doc/source/install/conf.py, it's unused. * Remove settings that are provided by openstackdocstheme from conf.py files. Switch to newer openstackdocstheme for this. * Remove unused deps from tox.ini: releasenotes and api-refonly need doc/requirements but not requirements. Change-Id: Iab5ad6cde40c3342770c0112155fe5e1d262d1e8
* Support node retirementArne Wiebalck2020-01-286-0/+29
| | | | | | | | | | | | | | | This change adds support for node retirement: nodes can have additional properties 'retired' and 'retired_reason' which change the way the nodes (can) traverse the FSM and which operations are allowed. In particular: - retired nodes cannot move from manageable to available; - upon instance deletion, retired nodes move to manageable (rather than available). Story: #2005425 Task: #38142 Change-Id: I8113a44c28f62bf83f8e213aeb6704f96055d52b
* Fix API docs for target_power_state responseZane Bitter2020-01-141-2/+1
| | | | | | | | | | | | | The API docs stated that the values of target_power_state in a Node State Summary are the same as the valid input values in a Change Node Power State request (i.e. they include "rebooting", "soft rebooting", and "soft power off"). However, in actuality these are all compressed to either "power on" or "power off" by the _calculate_target_state() function. Change-Id: I8c8b8c707102275a48233fc853acfb65f556946e Story: #2007089 Task: 38115
* Add a missing versionadded for configdrive[vendor_data]Dmitry Tantsur2020-01-071-0/+3
| | | | Change-Id: Ibfbb2f8f7a5f33e678a472a70b4b46aa1d7704e4
* Add owner to allocations and create relevant policiesTzu-Mainn Chen2019-12-106-1/+21
| | | | | | | | | | Add an owner to allocations. Depending on policy, a non-admin can then create an allocation and have the owner set to their project. Allocation processing then respects the owner. Change-Id: I2965a4a601b9fa2c0212097da37b104a3e5514df Story: #2006506 Task: #37540
* Allow vendor_data to be included in a configdrive dictSteve Baker2019-10-311-0/+1
| | | | | | | | | | | | | | | | | configdrive can contain a vendor_data2.json file containing key/value pairs injected by nova's vendordata mechanism[1]. This change lets Ironic accept a vendor_data key when configdrive is provided as json, allowing parity with nova. This change requires an openstacksdk release 0.37.0 [1] https://www.madebymikal.com/nova-vendordata-deployment-an-excessively-detailed-guide/ Change-Id: Id990b970619a113c5d5ead47fb550870d91b5e04 Task: 36756 Story: 2006597 Blueprint: nova-less-deploy
* Merge "Add api-ref for allocation update"Zuul2019-06-073-0/+89
|\
| * Add api-ref for allocation updateMadhuri Kumari2019-06-063-0/+89
| | | | | | | | | | | | Change-Id: I3a8cfa3d959c6906968bca7006583f45446758e5 Story: 2005126 Task: 29796
* | Allocation API: backfilling allocationsDmitry Tantsur2019-05-212-2/+25
|/ | | | | | | | | This feature addresses the case of moving the already deployed nodes under the allocation API. Change-Id: I29d0bd3663e0d1b27727a700c0f0e0fb6ceac1d9 Story: #2005014 Task: #29491
* Deploy Templates: API referenceMark Goddard2019-03-1211-1/+444
| | | | | | Change-Id: I14716e6023dd09096e17e60c7d02230ecb3e7150 Story: 1722275 Task: 28680
* Allow building configdrive from JSON in the APIDmitry Tantsur2019-03-052-4/+16
| | | | | | | | | | | | | | Extend the API with the ability to build config drives from meta_data, network_data and user_data, where meta_data and network_data are JSON objects, and user_data is either a JSON object, a JSON array or raw contents as a string. This change uses openstacksdk (which is already an indirect dependency) for building config drives. Change-Id: Ie1f399a4cb6d4fe5afec79341d3bccc0f81204b2 Story: #2005083 Task: #29663
* Merge "Adding bios_interface reference to api docs"Zuul2019-03-014-0/+29
|\
| * Adding bios_interface reference to api docsRiccardo Pittau2019-02-254-0/+29
| | | | | | | | | | | | | | | | As per title, this patch adds default_boot_interface and enabled_boot_interfaces references, definitions and examples to the api-ref documentation. Change-Id: I35d4829c32cc48d5734c269c0a83ad9b4fbdd660
* | Allocation API: fix minor issues in the API referenceDmitry Tantsur2019-02-263-6/+6
| | | | | | | | | | | | | | Follow-up to commit acc4c402de42be0b1fb179d13dcf86a4ca384206. Change-Id: Ie519caf791b6444afdc5a8665b1fbd719f916388 Story: #2004341
* | Allocation API: reference documentationDmitry Tantsur2019-02-2617-13/+561
|/ | | | | | Change-Id: I48f20f0b96931a17c477b9687b0ee963cb7b8879 Story: #2004341 Task: #29574
* Merge "Expose is_smartnic in port API"Zuul2019-02-1211-1/+53
|\
| * Expose is_smartnic in port APIHamdy Khader2019-02-1011-1/+53
| | | | | | | | | | | | | | | | | | | | | | | | | | Changes are made to support ironic handling is_smarting port attribute that was added in this change Ic2ffbd6f1035907ea5a18bda6d2b21e617194195 This change expose is_smartnic port field in REST API, updated API reference to include is_smartnic field and relevent documentations. API version updated to 1.53. Story: #2003346 Change-Id: I89ce54a0c034f2a5f82ff961ab06cfcc6d853bd4
* | Expose conductors: api-refKaifeng Wang2019-02-1210-1/+262
|/ | | | | | | | | | This patch updates API reference to contain the changes made by the feature of exposing conductors. Story: 1724474 Task: 28064 Change-Id: I47dbea2cda1cc0ad73786fe3fe9b80850e1cf289
* Add description field to node: api-refKaifeng Wang2019-02-015-4/+48
| | | | | | | | | | Update api-ref to include the description field. Also updated a few missing owner field. Change-Id: I81c5bf1be18ac4109f0e5ef66193ff66f484d107 Story: 2003089 Task: 23178
* Merge "Add "owner" information field"Zuul2018-12-116-0/+24
|\
| * Add "owner" information fieldJulia Kreger2018-12-106-0/+24
| | | | | | | | | | | | | | | | | | | | | | | | Adds "owner" field on the node object and exposes it for updates via the API. Additionally, fixed a couple minor items related to the prior where we missed updating version numbers in rebases. Change-Id: Iaaf3db97d21de9b11236cf2d18ffcc3f73f6e50c Story: #2001814 Task: #12550
* | Merge "Introduce configuration option [ipmi]ipmi_disable_timeout"12.0.0Zuul2018-12-111-1/+1
|\ \
| * | Introduce configuration option [ipmi]ipmi_disable_timeoutKaifeng Wang2018-12-101-1/+1
| |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Some type of BMCs don't support an IPMI option that disable the behavior of boot device timeout, which makes them never get booted from PXE. This patch extends the fix [1] by adding a configuration option, which provides the default ipmi behavior. [1] https://review.openstack.org/#/c/616053 Additionally revising the variable/setting names based upon review feedback and discussion that took place during the 20181210 weekly ironic team meeting. Change-Id: Ie049bbaf45aeab54c1272d1d561c5a6ca00dc34a Story: 2002977 Task: 22985
* | api-ref: update node.resource_class descriptionMatt Riedemann2018-12-071-2/+2
|/ | | | | | | | | | The future of scheduling with custom resource classes is now! Actually it has been for a couple of years. This drops the "future" part of the parameter description and links to the docs on configuring nova flavors with custom resource classes for scheduling with the placement service. Change-Id: Id904acdf305096738604eacb225136f1f9c03338
* Merge "Add ipmi_disable_timeout to avoid problematic IPMI command"Zuul2018-12-041-0/+1
|\
| * Add ipmi_disable_timeout to avoid problematic IPMI commandTony Breeds2018-11-281-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | The IPMI driver unconditionally instructed the BMC not automatically clear boot flag valid bit if Chassis Control command not received within 60-second timeout (countdown restarts when a Chassis Control command is received). Some BMCs do not support setting this. Sending the command aborts the node boot. A new driver option ``ipmi_disable_timeout`` is added to bypass sending this command. Change-Id: I1dda3cf3e4b7b888ed9d8931c8ede3a918dd01f4 Story: 2004266
* | Merge "Fix Chinese quotes"Zuul2018-11-281-1/+1
|\ \
| * | Fix Chinese quoteszhangdebo2018-11-281-1/+1
| |/ | | | | | | Change-Id: I678a7aff4685b8d807570a6bc69bebfaa2960c4e
* | Support for protecting nodes from undeploying and rebuildingDmitry Tantsur2018-11-276-1/+37
|/ | | | | | | | | | | | | | | | | When handling the "pet" case, some nodes may be critical for the deployment. For example, in an OpenStack installer like TripleO you may want to make sure your controllers are not removed by an incorrect operation. This changes introduces a new field "protected" on nodes. When it is set to True, the "deleted" and "rebuild" provisioning actions fail with HTTP 403. Deleting such nodes is also not possible. Also adds "protected_reason" for the operators to specify the reason a node is protected. Story: #2003869 Task: #26706 Change-Id: I1950bf6dd65b6596cae69d431ef288e578a89d6e
* Add api-ref for conductor groupJim Rollenhagen2018-10-236-2/+50
| | | | | | This was missed in the original feature; add it in. Change-Id: I7bad95be09be90a9d804cf95cde4226ffd98bb46
* Add documentation for BIOS settingsYolanda Robla2018-07-276-0/+157
| | | | | | | Update api-ref documentation, to add the BIOS settings. Change-Id: Ic592b5fa39f0d19d5676906ecd5c8fcbebf8e25f
* Deploy steps - API & notificationsMark Goddard2018-07-116-1/+19
| | | | | | | | | | Adds a 'deploy_step' field to the nodes API. Co-Authored-By: Ruby Loo <rloo@oath.com> Change-Id: I1baeeaaa6ed521e4189958fd7624cd6c5de96707 Story: #1753128 Task: #22592
* Fix list node vifs api errorDongcan Ye2018-07-031-2/+8
| | | | | | The node_ident param should in Request, this patch fix it. Change-Id: Id70533ff75e0f7b7930725fd74428c390321b98d