ironic.api.controllers.v1.node.
BootDeviceController
[source]¶Bases: pecan.rest.RestController
get
(node_ident)[source]¶Get the current boot device for a node.
Parameters: | node_ident – the UUID or logical name of a node. | ||||
---|---|---|---|---|---|
Returns: | a json object containing:
|
put
(node_ident, boot_device, persistent=False)[source]¶Set the boot device for a node.
Set the boot device to use on next reboot of the node.
Parameters: |
|
---|
ironic.api.controllers.v1.node.
ConsoleInfo
(**kw)[source]¶Bases: ironic.api.controllers.base.APIBase
API representation of the console information for a node.
ironic.api.controllers.v1.node.
InjectNmiController
[source]¶Bases: pecan.rest.RestController
put
(node_ident)[source]¶Inject NMI for a node.
Inject NMI (Non Maskable Interrupt) for a node immediately.
Parameters: | node_ident – the UUID or logical name of a node. |
---|---|
Raises: | NotFound if requested version of the API doesn’t support inject nmi. |
Raises: | HTTPForbidden if the policy is not authorized. |
Raises: | NodeNotFound if the node is not found. |
Raises: | NodeLocked if the node is locked by another conductor. |
Raises: | UnsupportedDriverExtension if the node’s driver doesn’t support management or management.inject_nmi. |
Raises: | InvalidParameterValue when the wrong driver info is specified or an invalid boot device is specified. |
Raises: | MissingParameterValue if missing supplied info. |
ironic.api.controllers.v1.node.
Node
(**kwargs)[source]¶Bases: ironic.api.controllers.base.APIBase
API representation of a bare metal node.
This class enforces type checking and value constraints, and converts between the internal object model and the API representation of a node.
ironic.api.controllers.v1.node.
NodeCollection
(**kwargs)[source]¶Bases: ironic.api.controllers.v1.collection.Collection
API representation of a collection of nodes.
ironic.api.controllers.v1.node.
NodeConsoleController
[source]¶Bases: pecan.rest.RestController
ironic.api.controllers.v1.node.
NodeMaintenanceController
[source]¶Bases: pecan.rest.RestController
ironic.api.controllers.v1.node.
NodeManagementController
[source]¶Bases: pecan.rest.RestController
ironic.api.controllers.v1.node.
NodeStates
(**kw)[source]¶Bases: ironic.api.controllers.base.APIBase
API representation of the states of a node.
ironic.api.controllers.v1.node.
NodeStatesController
[source]¶Bases: pecan.rest.RestController
get
(node_ident)[source]¶List the states of the node.
Parameters: | node_ident – the UUID or logical_name of a node. |
---|
power
(node_ident, target, timeout=None)[source]¶Set the power state of the node.
Parameters: |
|
---|---|
Raises: | ClientSideError (HTTP 409) if a power operation is already in progress. |
Raises: | InvalidStateRequested (HTTP 400) if the requested target state is not valid or if the node is in CLEANING state. |
Raises: | NotAcceptable (HTTP 406) for soft reboot, soft power off or timeout parameter, if requested version of the API is less than 1.27. |
Raises: | Invalid (HTTP 400) if timeout value is less than 1. |
provision
(node_ident, target, configdrive=None, clean_steps=None, rescue_password=None)[source]¶Asynchronous trigger the provisioning of the node.
This will set the target provision state of the node, and a background task will begin which actually applies the state change. This call will return a 202 (Accepted) indicating the request was accepted and is in progress; the client should continue to GET the status of this node to observe the status of the requested action.
Parameters: |
|
---|---|
Raises: | NodeLocked (HTTP 409) if the node is currently locked. |
Raises: | ClientSideError (HTTP 409) if the node is already being provisioned. |
Raises: | InvalidParameterValue (HTTP 400), if validation of clean_steps or power driver interface fails. |
Raises: | InvalidStateRequested (HTTP 400) if the requested transition is not possible from the current state. |
Raises: | NodeInMaintenance (HTTP 400), if operation cannot be performed because the node is in maintenance mode. |
Raises: | NoFreeConductorWorker (HTTP 503) if no workers are available. |
Raises: | NotAcceptable (HTTP 406) if the API version specified does not allow the requested state transition. |
raid
(node_ident, target_raid_config)[source]¶Set the target raid config of the node.
Parameters: |
|
---|---|
Raises: | UnsupportedDriverExtension, if the node’s driver doesn’t support RAID configuration. |
Raises: | InvalidParameterValue, if validation of target raid config fails. |
Raises: | NotAcceptable, if requested version of the API is less than 1.12. |
ironic.api.controllers.v1.node.
NodeTraitsController
(node_ident)[source]¶Bases: pecan.rest.RestController
delete
(trait=None)[source]¶Remove one or all traits from a node.
Parameters: | trait – String value; trait to remove from a node, or None. If None, all traits are removed. |
---|
put
(trait=None, traits=None)[source]¶Add a trait to a node.
Parameters: |
|
---|
ironic.api.controllers.v1.node.
NodeVIFController
(node_ident)[source]¶Bases: pecan.rest.RestController
ironic.api.controllers.v1.node.
NodeVendorPassthruController
[source]¶Bases: pecan.rest.RestController
REST controller for VendorPassthru.
This controller allow vendors to expose a custom functionality in the Ironic API. Ironic will merely relay the message from here to the appropriate driver, no introspection will be made in the message body.
ironic.api.controllers.v1.node.
NodesController
[source]¶Bases: pecan.rest.RestController
REST controller for Nodes.
detail
(chassis_uuid=None, instance_uuid=None, associated=None, maintenance=None, provision_state=None, marker=None, limit=None, sort_key='id', sort_dir='asc', driver=None, resource_class=None, fault=None, conductor_group=None)[source]¶Retrieve a list of nodes with detail.
Parameters: |
|
---|
get_all
(chassis_uuid=None, instance_uuid=None, associated=None, maintenance=None, provision_state=None, marker=None, limit=None, sort_key='id', sort_dir='asc', driver=None, fields=None, resource_class=None, fault=None, conductor_group=None, detail=None)[source]¶Retrieve a list of nodes.
Parameters: |
|
---|
get_one
(node_ident, fields=None)[source]¶Retrieve information about the given node.
Parameters: |
|
---|
patch
(node_ident, reset_interfaces=None, patch=None)[source]¶Update an existing node.
Parameters: |
|
---|
ironic.api.controllers.v1.node.
Traits
(**kw)[source]¶Bases: ironic.api.controllers.base.APIBase
API representation of the traits for a node.
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.