ironic

baremetal allocation create

Create a new baremetal allocation.

openstack baremetal allocation create
    [--resource-class RESOURCE_CLASS]
    [--trait TRAITS]
    [--candidate-node CANDIDATE_NODES]
    [--name NAME]
    [--uuid UUID]
    [--owner OWNER]
    [--extra <key=value>]
    [--wait [<time-out>]]
    [--node NODE]
--resource-class <RESOURCE_CLASS>

Resource class to request.

--trait <TRAITS>

A trait to request. Can be specified multiple times.

--candidate-node <CANDIDATE_NODES>

A candidate node for this allocation. Can be specified multiple times. If at least one is specified, only the provided candidate nodes are considered for the allocation.

--name <NAME>

Unique name of the allocation.

--uuid <UUID>

UUID of the allocation.

--owner <OWNER>

Owner of the allocation.

--extra <key=value>

Record arbitrary key/value metadata. Can be specified multiple times.

--wait <time-out>

Wait for the new allocation to become active. An error is returned if allocation fails and –wait is used. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely.

--node <NODE>

Backfill this allocation from the provided node that has already been deployed. Bypasses the normal allocation process.

This command is provided by the python-ironicclient plugin.

baremetal allocation delete

Unregister baremetal allocation(s).

openstack baremetal allocation delete <allocation> [<allocation> ...]
allocation

Allocations(s) to delete (name or UUID).

This command is provided by the python-ironicclient plugin.

baremetal allocation list

List baremetal allocations.

openstack baremetal allocation list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--limit <limit>]
    [--marker <allocation>]
    [--sort <key>[:<direction>]]
    [--node <node>]
    [--resource-class <resource_class>]
    [--state <state>]
    [--owner <owner>]
    [--long | --fields <field> [<field> ...]]
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

--limit <limit>

Maximum number of allocations to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service.

--marker <allocation>

Allocation UUID (for example, of the last allocation in the list from a previous request). Returns the list of allocations after this UUID.

--sort <key>[:<direction>]

Sort output by specified allocation fields and directions (asc or desc) (default: asc). Multiple fields and directions can be specified, separated by comma.

--node <node>

Only list allocations of this node (name or UUID).

--resource-class <resource_class>

Only list allocations with this resource class.

--state <state>

Only list allocations in this state.

--owner <owner>

Only list allocations with this owner.

--long

Show detailed information about the allocations.

--fields <field>

One or more allocation fields. Only these fields will be fetched from the server. Can not be used when ‘–long’ is specified.

This command is provided by the python-ironicclient plugin.

baremetal allocation set

Set baremetal allocation properties.

openstack baremetal allocation set
    [--name <name>]
    [--extra <key=value>]
    <allocation>
--name <name>

Set the name of the allocation

--extra <key=value>

Extra property to set on this allocation (repeat option to set multiple extra properties)

allocation

Name or UUID of the allocation

This command is provided by the python-ironicclient plugin.

baremetal allocation show

Show baremetal allocation details.

openstack baremetal allocation show
    [--fields <field> [<field> ...]]
    <id>
--fields <field>

One or more allocation fields. Only these fields will be fetched from the server.

id

UUID or name of the allocation

This command is provided by the python-ironicclient plugin.

baremetal allocation unset

Unset baremetal allocation properties.

openstack baremetal allocation unset
    [--name]
    [--extra <key>]
    <allocation>
--name

Unset the name of the allocation

--extra <key>

Extra property to unset on this baremetal allocation (repeat option to unset multiple extra property).

allocation

Name or UUID of the allocation

This command is provided by the python-ironicclient plugin.

baremetal chassis create

Create a new chassis.

openstack baremetal chassis create
    [--description <description>]
    [--extra <key=value>]
    [--uuid <uuid>]
--description <description>

Description for the chassis

--extra <key=value>

Record arbitrary key/value metadata. Can be specified multiple times.

--uuid <uuid>

Unique UUID of the chassis

This command is provided by the python-ironicclient plugin.

baremetal chassis delete

Delete a chassis.

openstack baremetal chassis delete <chassis> [<chassis> ...]
chassis

UUIDs of chassis to delete

This command is provided by the python-ironicclient plugin.

baremetal chassis list

List the chassis.

openstack baremetal chassis list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--fields <field> [<field> ...]]
    [--limit <limit>]
    [--long]
    [--marker <chassis>]
    [--sort <key>[:<direction>]]
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

--fields <field>

One or more chassis fields. Only these fields will be fetched from the server. Cannot be used when ‘–long’ is specified.

--limit <limit>

Maximum number of chassis to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service.

--long

Show detailed information about the chassis

--marker <chassis>

Chassis UUID (for example, of the last chassis in the list from a previous request). Returns the list of chassis after this UUID.

--sort <key>[:<direction>]

Sort output by specified chassis fields and directions (asc or desc) (default: asc). Multiple fields and directions can be specified, separated by comma.

This command is provided by the python-ironicclient plugin.

baremetal chassis set

Set chassis properties.

openstack baremetal chassis set
    [--description <description>]
    [--extra <key=value>]
    <chassis>
--description <description>

Set the description of the chassis

--extra <key=value>

Extra to set on this chassis (repeat option to set multiple extras)

chassis

UUID of the chassis

This command is provided by the python-ironicclient plugin.

baremetal chassis show

Show chassis details.

openstack baremetal chassis show
    [--fields <field> [<field> ...]]
    <chassis>
--fields <field>

One or more chassis fields. Only these fields will be fetched from the server.

chassis

UUID of the chassis

This command is provided by the python-ironicclient plugin.

baremetal chassis unset

Unset chassis properties.

openstack baremetal chassis unset
    [--description]
    [--extra <key>]
    <chassis>
--description

Clear the chassis description

--extra <key>

Extra to unset on this chassis (repeat option to unset multiple extras)

chassis

UUID of the chassis

This command is provided by the python-ironicclient plugin.

baremetal conductor list

List baremetal conductors

openstack baremetal conductor list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--limit <limit>]
    [--marker <conductor>]
    [--sort <key>[:<direction>]]
    [--long | --fields <field> [<field> ...]]
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

--limit <limit>

Maximum number of conductors to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service.

--marker <conductor>

Hostname of the conductor (for example, of the last conductor in the list from a previous request). Returns the list of conductors after this conductor.

--sort <key>[:<direction>]

Sort output by specified conductor fields and directions (asc or desc) (default: asc). Multiple fields and directions can be specified, separated by comma.

--long

Show detailed information about the conductors.

--fields <field>

One or more conductor fields. Only these fields will be fetched from the server. Can not be used when ‘–long’ is specified.

This command is provided by the python-ironicclient plugin.

baremetal conductor show

Show baremetal conductor details

openstack baremetal conductor show
    [--fields <field> [<field> ...]]
    <conductor>
--fields <field>

One or more conductor fields. Only these fields will be fetched from the server.

conductor

Hostname of the conductor

This command is provided by the python-ironicclient plugin.

baremetal create

Create resources from files

openstack baremetal create <file> [<file> ...]
file

File (.yaml or .json) containing descriptions of the resources to create. Can be specified multiple times.

This command is provided by the python-ironicclient plugin.

baremetal deploy template create

Create a new deploy template

openstack baremetal deploy template create
    [--uuid <uuid>]
    [--extra <key=value>]
    --steps <steps>
    <name>
--uuid <uuid>

UUID of the deploy template.

--extra <key=value>

Record arbitrary key/value metadata. Can be specified multiple times.

--steps <steps>

The deploy steps. May be the path to a YAML file containing the deploy steps; OR ‘-’, with the deploy steps being read from standard input; OR a JSON string. The value should be a list of deploy-step dictionaries; each dictionary should have keys ‘interface’, ‘step’, ‘args’ and ‘priority’.

name

Unique name for this deploy template. Must be a valid trait name

This command is provided by the python-ironicclient plugin.

baremetal deploy template delete

Delete deploy template(s).

openstack baremetal deploy template delete <template> [<template> ...]
template

Name(s) or UUID(s) of the deploy template(s) to delete.

This command is provided by the python-ironicclient plugin.

baremetal deploy template list

List baremetal deploy templates.

openstack baremetal deploy template list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--limit <limit>]
    [--marker <template>]
    [--sort <key>[:<direction>]]
    [--long | --fields <field> [<field> ...]]
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

--limit <limit>

Maximum number of deploy templates to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service.

--marker <template>

DeployTemplate UUID (for example, of the last deploy template in the list from a previous request). Returns the list of deploy templates after this UUID.

--sort <key>[:<direction>]

Sort output by specified deploy template fields and directions (asc or desc) (default: asc). Multiple fields and directions can be specified, separated by comma.

--long

Show detailed information about deploy templates.

--fields <field>

One or more deploy template fields. Only these fields will be fetched from the server. Can not be used when ‘–long’ is specified.

This command is provided by the python-ironicclient plugin.

baremetal deploy template set

Set baremetal deploy template properties.

openstack baremetal deploy template set
    [--name <name>]
    [--steps <steps>]
    [--extra <key=value>]
    <template>
--name <name>

Set unique name of the deploy template. Must be a valid trait name.

--steps <steps>

The deploy steps. May be the path to a YAML file containing the deploy steps; OR ‘-’, with the deploy steps being read from standard input; OR a JSON string. The value should be a list of deploy-step dictionaries; each dictionary should have keys ‘interface’, ‘step’, ‘args’ and ‘priority’.

--extra <key=value>

Extra to set on this baremetal deploy template (repeat option to set multiple extras).

template

Name or UUID of the deploy template

This command is provided by the python-ironicclient plugin.

baremetal deploy template show

Show baremetal deploy template details.

openstack baremetal deploy template show
    [--fields <field> [<field> ...]]
    <template>
--fields <field>

One or more deploy template fields. Only these fields will be fetched from the server.

template

Name or UUID of the deploy template.

This command is provided by the python-ironicclient plugin.

baremetal deploy template unset

Unset baremetal deploy template properties.

openstack baremetal deploy template unset [--extra <key>] <template>
--extra <key>

Extra to unset on this baremetal deploy template (repeat option to unset multiple extras).

template

Name or UUID of the deploy template

This command is provided by the python-ironicclient plugin.

baremetal driver list

List the enabled drivers.

openstack baremetal driver list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--type <type>]
    [--long | --fields <field> [<field> ...]]
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

--type <type>

Type of driver (“classic” or “dynamic”). The default is to list all of them.

--long

Show detailed information about the drivers.

--fields <field>

One or more node fields. Only these fields will be fetched from the server. Can not be used when ‘–long’ is specified.

This command is provided by the python-ironicclient plugin.

baremetal driver passthru call

Call a vendor passthru method for a driver.

openstack baremetal driver passthru call
    [--arg <key=value>]
    [--http-method <http-method>]
    <driver>
    <method>
--arg <key=value>

Argument to pass to the passthru method (repeat option to specify multiple arguments).

--http-method <http-method>

The HTTP method to use in the passthru request. One of DELETE, GET, PATCH, POST, PUT. Defaults to ‘POST’.

driver

Name of the driver.

method

Vendor passthru method to be called.

This command is provided by the python-ironicclient plugin.

baremetal driver passthru list

List available vendor passthru methods for a driver.

openstack baremetal driver passthru list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    <driver>
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

driver

Name of the driver.

This command is provided by the python-ironicclient plugin.

baremetal driver property list

List the driver properties.

openstack baremetal driver property list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    <driver>
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

driver

Name of the driver.

This command is provided by the python-ironicclient plugin.

baremetal driver raid property list

List a driver’s RAID logical disk properties.

openstack baremetal driver raid property list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    <driver>
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

driver

Name of the driver.

This command is provided by the python-ironicclient plugin.

baremetal driver show

Show information about a driver.

openstack baremetal driver show
    [--fields <field> [<field> ...]]
    <driver>
--fields <field>

One or more node fields. Only these fields will be fetched from the server.

driver

Name of the driver.

This command is provided by the python-ironicclient plugin.

baremetal node abort

Set provision state of baremetal node to ‘abort’

openstack baremetal node abort <node> [<node> ...]
node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node add trait

Add traits to a node.

openstack baremetal node add trait <node> <trait> [<trait> ...]
node

Name or UUID of the node

trait

Trait(s) to add

This command is provided by the python-ironicclient plugin.

baremetal node adopt

Set provision state of baremetal node to ‘adopt’

openstack baremetal node adopt
    [--wait [<time-out>]]
    <node>
    [<node> ...]
--wait <time-out>

Wait for a node to reach the desired state, active. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely.

node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node bios setting list

List a node’s BIOS settings.

openstack baremetal node bios setting list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--long | --fields <field> [<field> ...]]
    <node>
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

--long

Show detailed information about the BIOS settings.

--fields <field>

One or more node fields. Only these fields will be fetched from the server. Can not be used when ‘–long’ is specified.

node

Name or UUID of the node

This command is provided by the python-ironicclient plugin.

baremetal node bios setting show

Show a specific BIOS setting for a node.

openstack baremetal node bios setting show <node> <setting name>
node

Name or UUID of the node

setting name

Setting name to show

This command is provided by the python-ironicclient plugin.

baremetal node boot device set

Set the boot device for a node

openstack baremetal node boot device set
    [--persistent]
    <node>
    [<node> ...]
    <device>
--persistent

Make changes persistent for all future boots

node

Names or UUID’s of the nodes

device

One of bios, cdrom, disk, pxe, safe, wanboot

This command is provided by the python-ironicclient plugin.

baremetal node boot device show

Show the boot device information for a node

openstack baremetal node boot device show [--supported] <node>
--supported

Show the supported boot devices

node

Name or UUID of the node

This command is provided by the python-ironicclient plugin.

baremetal node boot mode set

Set the boot mode for the next baremetal node deployment

openstack baremetal node boot mode set <node> [<node> ...] <boot_mode>
node

Names or UUID’s of the nodes.

boot_mode

The boot mode to set for node (uefi/bios)

This command is provided by the python-ironicclient plugin.

baremetal node children list

Get a list of nodes associated as children.

openstack baremetal node children list <node>
node

Name or UUID of the node.

This command is provided by the python-ironicclient plugin.

baremetal node clean

Set provision state of baremetal node to ‘clean’

openstack baremetal node clean
    [--wait [<time-out>]]
    --clean-steps <clean-steps>
    <node>
    [<node> ...]
--wait <time-out>

Wait for a node to reach the desired state, manageable. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely.

--clean-steps <clean-steps>

The clean steps. May be the path to a YAML file containing the clean steps; OR ‘-’, with the clean steps being read from standard input; OR a JSON string. The value should be a list of clean-step dictionaries; each dictionary should have keys ‘interface’ and ‘step’, and optional key ‘args’.

node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node console disable

Disable console access for a node

openstack baremetal node console disable <node> [<node> ...]
node

Names or UUID’s of the nodes

This command is provided by the python-ironicclient plugin.

baremetal node console enable

Enable console access for a node

openstack baremetal node console enable <node> [<node> ...]
node

Names or UUID’s of the nodes

This command is provided by the python-ironicclient plugin.

baremetal node console show

Show console information for a node

openstack baremetal node console show <node>
node

Name or UUID of the node

This command is provided by the python-ironicclient plugin.

baremetal node create

Register a new node with the baremetal service

openstack baremetal node create
    [--chassis-uuid <chassis>]
    --driver <driver>
    [--driver-info <key=value>]
    [--property <key=value>]
    [--extra <key=value>]
    [--uuid <uuid>]
    [--name <name>]
    [--bios-interface <bios_interface>]
    [--boot-interface <boot_interface>]
    [--console-interface <console_interface>]
    [--deploy-interface <deploy_interface>]
    [--inspect-interface <inspect_interface>]
    [--management-interface <management_interface>]
    [--network-data <network data>]
    [--network-interface <network_interface>]
    [--power-interface <power_interface>]
    [--raid-interface <raid_interface>]
    [--rescue-interface <rescue_interface>]
    [--storage-interface <storage_interface>]
    [--vendor-interface <vendor_interface>]
    [--resource-class <resource_class>]
    [--conductor-group <conductor_group>]
    [--automated-clean | --no-automated-clean]
    [--owner <owner>]
    [--lessee <lessee>]
    [--description <description>]
    [--shard <shard>]
    [--parent-node <parent_node>]
    [--firmware-interface <firmware_interface>]
--chassis-uuid <chassis>

UUID of the chassis that this node belongs to.

--driver <driver>

Driver used to control the node [REQUIRED].

--driver-info <key=value>

Key/value pair used by the driver, such as out-of-band management credentials. Can be specified multiple times.

--property <key=value>

Key/value pair describing the physical characteristics of the node. This is exported to Nova and used by the scheduler. Can be specified multiple times.

--extra <key=value>

Record arbitrary key/value metadata. Can be specified multiple times.

--uuid <uuid>

Unique UUID for the node.

--name <name>

Unique name for the node.

--bios-interface <bios_interface>

BIOS interface used by the node’s driver. This is only applicable when the specified –driver is a hardware type.

--boot-interface <boot_interface>

Boot interface used by the node’s driver. This is only applicable when the specified –driver is a hardware type.

--console-interface <console_interface>

Console interface used by the node’s driver. This is only applicable when the specified –driver is a hardware type.

--deploy-interface <deploy_interface>

Deploy interface used by the node’s driver. This is only applicable when the specified –driver is a hardware type.

--inspect-interface <inspect_interface>

Inspect interface used by the node’s driver. This is only applicable when the specified –driver is a hardware type.

--management-interface <management_interface>

Management interface used by the node’s driver. This is only applicable when the specified –driver is a hardware type.

--network-data <network data>

JSON string or a YAML file or ‘-’ for stdin to read static network configuration for the baremetal node associated with this ironic node. Format of this file should comply with Nova network data metadata (network_data.json). Depending on ironic boot interface capabilities being used, network configuration may or may not been served to the node for offline network configuration.

--network-interface <network_interface>

Network interface used for switching node to cleaning/provisioning networks.

--power-interface <power_interface>

Power interface used by the node’s driver. This is only applicable when the specified –driver is a hardware type.

--raid-interface <raid_interface>

RAID interface used by the node’s driver. This is only applicable when the specified –driver is a hardware type.

--rescue-interface <rescue_interface>

Rescue interface used by the node’s driver. This is only applicable when the specified –driver is a hardware type.

--storage-interface <storage_interface>

Storage interface used by the node’s driver.

--vendor-interface <vendor_interface>

Vendor interface used by the node’s driver. This is only applicable when the specified –driver is a hardware type.

--resource-class <resource_class>

Resource class for mapping nodes to Nova flavors

--conductor-group <conductor_group>

Conductor group the node will belong to

--automated-clean

Enable automated cleaning for the node

--no-automated-clean

Explicitly disable automated cleaning for the node

--owner <owner>

Owner of the node.

--lessee <lessee>

Lessee of the node.

--description <description>

Description for the node.

--shard <shard>

Shard for the node.

--parent-node <parent_node>

Parent node for the node being created.

--firmware-interface <firmware_interface>

Firmware interface used by the node’s driver. This is only applicable when the specified –driver is a hardware type.

This command is provided by the python-ironicclient plugin.

baremetal node delete

Unregister baremetal node(s)

openstack baremetal node delete <node> [<node> ...]
node

Node(s) to delete (name or UUID)

This command is provided by the python-ironicclient plugin.

baremetal node deploy

Set provision state of baremetal node to ‘deploy’

openstack baremetal node deploy
    [--wait [<time-out>]]
    [--config-drive <config-drive>]
    [--deploy-steps <deploy-steps>]
    <node>
    [<node> ...]
--wait <time-out>

Wait for a node to reach the desired state, active. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely.

--config-drive <config-drive>

A gzipped, base64-encoded configuration drive string OR the path to the configuration drive file OR the path to a directory containing the config drive files OR a JSON object to build config drive from OR the path to the JSON file. In case it’s a directory, a config drive will be generated from it. In case it’s a JSON object with optional keys meta_data, user_data and network_data or a JSON file, a config drive will be generated on the server side (see the bare metal API reference for more details).

--deploy-steps <deploy-steps>

The deploy steps. May be the path to a YAML file containing the deploy steps; OR ‘-’, with the deploy steps being read from standard input; OR a JSON string. The value should be a list of deploy-step dictionaries; each dictionary should have keys ‘interface’ and ‘step’, and optional key ‘args’.

node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node firmware list

List all Firmware Components of a node

openstack baremetal node firmware list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    <node>
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

node

Name or UUID of the node

This command is provided by the python-ironicclient plugin.

baremetal node history get

Get history event for a baremetal node.

openstack baremetal node history get <node> <event>
node

Name or UUID of the node.

event

UUID of the event.

This command is provided by the python-ironicclient plugin.

baremetal node history list

Get history events for a baremetal node.

openstack baremetal node history list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--long]
    <node>
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

--long

Show detailed information about the node history events.

node

Name or UUID of the node.

This command is provided by the python-ironicclient plugin.

baremetal node inject nmi

Inject NMI to baremetal node

openstack baremetal node inject nmi <node> [<node> ...]
node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node inspect

Set provision state of baremetal node to ‘inspect’

openstack baremetal node inspect
    [--wait [<time-out>]]
    <node>
    [<node> ...]
--wait <time-out>

Wait for a node to reach the desired state, manageable. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely.

node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node inventory save

Get hardware inventory of a node (in JSON format) or save it to file.

openstack baremetal node inventory save [--file <filename>] <node>
--file <filename>

Save inspection data to file with name (default: stdout).

node

Name or UUID of the node

This command is provided by the python-ironicclient plugin.

baremetal node list

List baremetal nodes

openstack baremetal node list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--limit <limit>]
    [--marker <node>]
    [--sort <key>[:<direction>]]
    [--maintenance | --no-maintenance]
    [--retired | --no-retired]
    [--fault <fault>]
    [--associated | --unassociated]
    [--provision-state <provision state>]
    [--driver <driver>]
    [--resource-class <resource class>]
    [--conductor-group <conductor_group>]
    [--conductor <conductor>]
    [--chassis <chassis UUID>]
    [--owner <owner>]
    [--lessee <lessee>]
    [--description-contains <description_contains>]
    [--sharded | --unsharded]
    [--shards <shards> [<shards> ...]]
    [--long | --fields <field> [<field> ...]]
    [--include-children | --parent-node <parent_node>]
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

--limit <limit>

Maximum number of nodes to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service.

--marker <node>

Node UUID (for example, of the last node in the list from a previous request). Returns the list of nodes after this UUID.

--sort <key>[:<direction>]

Sort output by specified node fields and directions (asc or desc) (default: asc). Multiple fields and directions can be specified, separated by comma.

--maintenance

Limit list to nodes in maintenance mode

--no-maintenance

Limit list to nodes not in maintenance mode

--retired

Limit list to retired nodes.

--no-retired

Limit list to not retired nodes.

--fault <fault>

List nodes in specified fault.

--associated

List only nodes associated with an instance.

--unassociated

List only nodes not associated with an instance.

--provision-state <provision state>

List nodes in specified provision state.

--driver <driver>

Limit list to nodes with driver <driver>

--resource-class <resource class>

Limit list to nodes with resource class <resource class>

--conductor-group <conductor_group>

Limit list to nodes with conductor group <conductor group>

--conductor <conductor>

Limit list to nodes with conductor <conductor>

--chassis <chassis UUID>

Limit list to nodes of this chassis

--owner <owner>

Limit list to nodes with owner <owner>

--lessee <lessee>

Limit list to nodes with lessee <lessee>

--description-contains <description_contains>

Limit list to nodes with description contains <description_contains>

--sharded

List only nodes that are sharded.

--unsharded

List only nodes that are not sharded.

--shards <shards>

List only nodes that are in shards <shards>.

--long

Show detailed information about the nodes.

--fields <field>

One or more node fields. Only these fields will be fetched from the server. Can not be used when ‘–long’ is specified.

--include-children

Include children in the node list.

--parent-node <parent_node>

List only nodes associated with a parent node.

This command is provided by the python-ironicclient plugin.

baremetal node maintenance set

Set baremetal node to maintenance mode

openstack baremetal node maintenance set
    [--reason <reason>]
    <node>
    [<node> ...]
--reason <reason>

Reason for setting maintenance mode.

node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node maintenance unset

Unset baremetal node from maintenance mode

openstack baremetal node maintenance unset <node> [<node> ...]
node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node manage

Set provision state of baremetal node to ‘manage’

openstack baremetal node manage
    [--wait [<time-out>]]
    <node>
    [<node> ...]
--wait <time-out>

Wait for a node to reach the desired state, manageable. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely.

node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node passthru call

Call a vendor passthru method for a node

openstack baremetal node passthru call
    [--arg <key=value>]
    [--http-method <http-method>]
    <node>
    <method>
--arg <key=value>

Argument to pass to the passthru method (repeat option to specify multiple arguments)

--http-method <http-method>

The HTTP method to use in the passthru request. One of DELETE, GET, PATCH, POST, PUT. Defaults to POST.

node

Name or UUID of the node

method

Vendor passthru method to be executed

This command is provided by the python-ironicclient plugin.

baremetal node passthru list

List vendor passthru methods for a node

openstack baremetal node passthru list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    <node>
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

node

Name or UUID of the node

This command is provided by the python-ironicclient plugin.

baremetal node power off

Power off a node

openstack baremetal node power off
    [--power-timeout <power-timeout>]
    [--soft]
    <node>
    [<node> ...]
--power-timeout <power-timeout>

Timeout (in seconds, positive integer) to wait for the target power state before erroring out.

--soft

Request graceful power-off.

node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node power on

Power on a node

openstack baremetal node power on
    [--power-timeout <power-timeout>]
    <node>
    [<node> ...]
--power-timeout <power-timeout>

Timeout (in seconds, positive integer) to wait for the target power state before erroring out.

node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node provide

Set provision state of baremetal node to ‘provide’

openstack baremetal node provide
    [--wait [<time-out>]]
    <node>
    [<node> ...]
--wait <time-out>

Wait for a node to reach the desired state, available. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely.

node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node reboot

Reboot baremetal node

openstack baremetal node reboot
    [--soft]
    [--power-timeout <power-timeout>]
    <node>
    [<node> ...]
--soft

Request Graceful reboot.

--power-timeout <power-timeout>

Timeout (in seconds, positive integer) to wait for the target power state before erroring out.

node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node rebuild

Set provision state of baremetal node to ‘rebuild’

openstack baremetal node rebuild
    [--wait [<time-out>]]
    [--config-drive <config-drive>]
    [--deploy-steps <deploy-steps>]
    <node>
    [<node> ...]
--wait <time-out>

Wait for a node to reach the desired state, active. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely.

--config-drive <config-drive>

A gzipped, base64-encoded configuration drive string OR the path to the configuration drive file OR the path to a directory containing the config drive files OR a JSON object to build config drive from OR the path to the JSON file. In case it’s a directory, a config drive will be generated from it. In case it’s a JSON object with optional keys meta_data, user_data and network_data or a JSON file, a config drive will be generated on the server side (see the bare metal API reference for more details).

--deploy-steps <deploy-steps>

The deploy steps in JSON format. May be the path to a file containing the deploy steps; OR ‘-’, with the deploy steps being read from standard input; OR a string. The value should be a list of deploy-step dictionaries; each dictionary should have keys ‘interface’, ‘step’, ‘priority’ and optional key ‘args’.

node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node remove trait

Remove trait(s) from a node.

openstack baremetal node remove trait [--all] <node> [<trait> ...]
--all

Remove all traits

node

Name or UUID of the node

trait

Trait(s) to remove

This command is provided by the python-ironicclient plugin.

baremetal node rescue

Set provision state of baremetal node to ‘rescue’

openstack baremetal node rescue
    [--wait [<time-out>]]
    --rescue-password <rescue-password>
    <node>
    [<node> ...]
--wait <time-out>

Wait for a node to reach the desired state, rescue. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely.

--rescue-password <rescue-password>

The password that will be used to login to the rescue ramdisk. The value should be a non-empty string.

node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node secure boot off

Turn secure boot off

openstack baremetal node secure boot off <node> [<node> ...]
node

Name or UUID of the node

This command is provided by the python-ironicclient plugin.

baremetal node secure boot on

Turn secure boot on

openstack baremetal node secure boot on <node> [<node> ...]
node

Name or UUID of the node

This command is provided by the python-ironicclient plugin.

baremetal node set

Set baremetal properties

openstack baremetal node set
    [--instance-uuid <uuid>]
    [--name <name>]
    [--chassis-uuid <chassis UUID>]
    [--driver <driver>]
    [--bios-interface <bios_interface> | --reset-bios-interface]
    [--boot-interface <boot_interface> | --reset-boot-interface]
    [--console-interface <console_interface> | --reset-console-interface]
    [--deploy-interface <deploy_interface> | --reset-deploy-interface]
    [--firmware-interface <firmware_interface> | --reset-firmware-interface]
    [--inspect-interface <inspect_interface> | --reset-inspect-interface]
    [--management-interface <management_interface> | --reset-management-interface]
    [--network-interface <network_interface> | --reset-network-interface]
    [--network-data <network data>]
    [--power-interface <power_interface> | --reset-power-interface]
    [--raid-interface <raid_interface> | --reset-raid-interface]
    [--rescue-interface <rescue_interface> | --reset-rescue-interface]
    [--storage-interface <storage_interface> | --reset-storage-interface]
    [--vendor-interface <vendor_interface> | --reset-vendor-interface]
    [--reset-interfaces]
    [--resource-class <resource_class>]
    [--conductor-group <conductor_group>]
    [--automated-clean | --no-automated-clean]
    [--protected]
    [--protected-reason <protected_reason>]
    [--retired]
    [--retired-reason <retired_reason>]
    [--target-raid-config <target_raid_config>]
    [--property <key=value>]
    [--extra <key=value>]
    [--driver-info <key=value>]
    [--instance-info <key=value>]
    [--owner <owner>]
    [--lessee <lessee>]
    [--description <description>]
    [--shard <shard>]
    [--parent-node <parent_node>]
    <node>
    [<node> ...]
--instance-uuid <uuid>

Set instance UUID of node to <uuid>

--name <name>

Set the name of the node

--chassis-uuid <chassis UUID>

Set the chassis for the node

--driver <driver>

Set the driver for the node

--bios-interface <bios_interface>

Set the BIOS interface for the node

--reset-bios-interface

Reset the BIOS interface to its hardware type default

--boot-interface <boot_interface>

Set the boot interface for the node

--reset-boot-interface

Reset the boot interface to its hardware type default

--console-interface <console_interface>

Set the console interface for the node

--reset-console-interface

Reset the console interface to its hardware type default

--deploy-interface <deploy_interface>

Set the deploy interface for the node

--reset-deploy-interface

Reset the deploy interface to its hardware type default

--firmware-interface <firmware_interface>

Set the firmware interface for the node

--reset-firmware-interface

Reset the firmware interface for its hardware type default

--inspect-interface <inspect_interface>

Set the inspect interface for the node

--reset-inspect-interface

Reset the inspect interface to its hardware type default

--management-interface <management_interface>

Set the management interface for the node

--reset-management-interface

Reset the management interface to its hardware type default

--network-interface <network_interface>

Set the network interface for the node

--reset-network-interface

Reset the network interface to its hardware type default

--network-data <network data>

JSON string or a YAML file or ‘-’ for stdin to read static network configuration for the baremetal node associated with this ironic node. Format of this file should comply with Nova network data metadata (network_data.json). Depending on ironic boot interface capabilities being used, network configuration may or may not been served to the node for offline network configuration.

--power-interface <power_interface>

Set the power interface for the node

--reset-power-interface

Reset the power interface to its hardware type default

--raid-interface <raid_interface>

Set the RAID interface for the node

--reset-raid-interface

Reset the RAID interface to its hardware type default

--rescue-interface <rescue_interface>

Set the rescue interface for the node

--reset-rescue-interface

Reset the rescue interface to its hardware type default

--storage-interface <storage_interface>

Set the storage interface for the node

--reset-storage-interface

Reset the storage interface to its hardware type default

--vendor-interface <vendor_interface>

Set the vendor interface for the node

--reset-vendor-interface

Reset the vendor interface to its hardware type default

--reset-interfaces

Reset all interfaces not specified explicitly to their default implementations. Only valid with –driver.

--resource-class <resource_class>

Set the resource class for the node

--conductor-group <conductor_group>

Set the conductor group for the node

--automated-clean

Enable automated cleaning for the node

--no-automated-clean

Explicitly disable automated cleaning for the node

--protected

Mark the node as protected

--protected-reason <protected_reason>

Set the reason of marking the node as protected

--retired

Mark the node as retired

--retired-reason <retired_reason>

Set the reason of marking the node as retired

--target-raid-config <target_raid_config>

Set the target RAID configuration (JSON) for the node. This can be one of: 1. a file containing YAML data of the RAID configuration; 2. “-” to read the contents from standard input; or 3. a valid JSON string.

--property <key=value>

Property to set on this baremetal node (repeat option to set multiple properties)

--extra <key=value>

Extra to set on this baremetal node (repeat option to set multiple extras)

--driver-info <key=value>

Driver information to set on this baremetal node (repeat option to set multiple driver infos)

--instance-info <key=value>

Instance information to set on this baremetal node (repeat option to set multiple instance infos)

--owner <owner>

Set the owner for the node

--lessee <lessee>

Set the lessee for the node

--description <description>

Set the description for the node

--shard <shard>

Set the shard for the node

--parent-node <parent_node>

Set the parent node for the node

node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node show

Show baremetal node details

openstack baremetal node show
    [--instance]
    [--fields <field> [<field> ...]]
    <node>
--instance

<node> is an instance UUID.

--fields <field>

One or more node fields. Only these fields will be fetched from the server.

node

Name or UUID of the node (or instance UUID if –instance is specified)

This command is provided by the python-ironicclient plugin.

baremetal node trait list

List a node’s traits.

openstack baremetal node trait list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    <node>
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

node

Name or UUID of the node

This command is provided by the python-ironicclient plugin.

baremetal node undeploy

Set provision state of baremetal node to ‘deleted’

openstack baremetal node undeploy
    [--wait [<time-out>]]
    <node>
    [<node> ...]
--wait <time-out>

Wait for a node to reach the desired state, available. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely.

node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node unhold

Set provision state of baremetal node to ‘unhold’

openstack baremetal node unhold <node> [<node> ...]
node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node unrescue

Set provision state of baremetal node to ‘unrescue’

openstack baremetal node unrescue
    [--wait [<time-out>]]
    <node>
    [<node> ...]
--wait <time-out>

Wait for a node to reach the desired state, active. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely.

node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node unset

Unset baremetal properties

openstack baremetal node unset
    [--instance-uuid]
    [--name]
    [--resource-class]
    [--target-raid-config]
    [--property <key>]
    [--extra <key>]
    [--driver-info <key>]
    [--instance-info <key>]
    [--chassis-uuid]
    [--bios-interface]
    [--boot-interface]
    [--console-interface]
    [--deploy-interface]
    [--firmware-interface]
    [--inspect-interface]
    [--network-data]
    [--management-interface]
    [--network-interface]
    [--power-interface]
    [--raid-interface]
    [--rescue-interface]
    [--storage-interface]
    [--vendor-interface]
    [--conductor-group]
    [--automated-clean]
    [--protected]
    [--protected-reason]
    [--retired]
    [--retired-reason]
    [--owner]
    [--lessee]
    [--description]
    [--shard]
    [--parent-node]
    <node>
    [<node> ...]
--instance-uuid

Unset instance UUID on this baremetal node

--name

Unset the name of the node

--resource-class

Unset the resource class of the node

--target-raid-config

Unset the target RAID configuration of the node

--property <key>

Property to unset on this baremetal node (repeat option to unset multiple properties)

--extra <key>

Extra to unset on this baremetal node (repeat option to unset multiple extras)

--driver-info <key>

Driver information to unset on this baremetal node (repeat option to unset multiple items in driver information)

--instance-info <key>

Instance information to unset on this baremetal node (repeat option to unset multiple instance information)

--chassis-uuid

Unset chassis UUID on this baremetal node

--bios-interface

Unset BIOS interface on this baremetal node

--boot-interface

Unset boot interface on this baremetal node

--console-interface

Unset console interface on this baremetal node

--deploy-interface

Unset deploy interface on this baremetal node

--firmware-interface

Unset firmware interface on this baremetal node

--inspect-interface

Unset inspect interface on this baremetal node

--network-data

Unset network data on this baremetal port.

--management-interface

Unset management interface on this baremetal node

--network-interface

Unset network interface on this baremetal node

--power-interface

Unset power interface on this baremetal node

--raid-interface

Unset RAID interface on this baremetal node

--rescue-interface

Unset rescue interface on this baremetal node

--storage-interface

Unset storage interface on this baremetal node

--vendor-interface

Unset vendor interface on this baremetal node

--conductor-group

Unset conductor group for this baremetal node (the default group will be used)

--automated-clean

Unset automated clean option on this baremetal node (the value from configuration will be used)

--protected

Unset the protected flag on the node

--protected-reason

Unset the protected reason (gets unset automatically when protected is unset)

--retired

Unset the retired flag on the node

--retired-reason

Unset the retired reason (gets unset automatically when retired is unset)

--owner

Unset the owner field of the node

--lessee

Unset the lessee field of the node

--description

Unset the description field of the node

--shard

Unset the shard field of the node

--parent-node

Unset the parent node field of the node

node

Names or UUID’s of the nodes.

This command is provided by the python-ironicclient plugin.

baremetal node validate

Validate a node’s driver interfaces

openstack baremetal node validate
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    <node>
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

node

Name or UUID of the node

This command is provided by the python-ironicclient plugin.

baremetal node vif attach

Attach VIF to a given node

openstack baremetal node vif attach
    [--port-uuid <port-uuid>]
    [--vif-info <key=value>]
    <node>
    <vif-id>
--port-uuid <port-uuid>

UUID of the baremetal port to attach the VIF to.

--vif-info <key=value>

Record arbitrary key/value metadata. Can be specified multiple times. The mandatory ‘id’ parameter cannot be specified as a key.

node

Name or UUID of the node

vif-id

Name or UUID of the VIF to attach to a node.

This command is provided by the python-ironicclient plugin.

baremetal node vif detach

Detach VIF from a given node

openstack baremetal node vif detach <node> <vif-id>
node

Name or UUID of the node

vif-id

Name or UUID of the VIF to detach from a node.

This command is provided by the python-ironicclient plugin.

baremetal node vif list

Show attached VIFs for a node

openstack baremetal node vif list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    <node>
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

node

Name or UUID of the node

This command is provided by the python-ironicclient plugin.

baremetal port create

Create a new port

openstack baremetal port create
    --node <uuid>
    [--uuid <uuid>]
    [--extra <key=value>]
    [--local-link-connection <key=value>]
    [-l <key=value>]
    [--pxe-enabled <boolean>]
    [--port-group <uuid>]
    [--physical-network <physical network>]
    [--is-smartnic]
    <address>
--node <uuid>

UUID of the node that this port belongs to.

--uuid <uuid>

UUID of the port.

--extra <key=value>

Record arbitrary key/value metadata. Argument can be specified multiple times.

Key/value metadata describing Local link connection information. Valid keys are ‘switch_info’, ‘switch_id’, ‘port_id’ and ‘hostname’. The keys ‘switch_id’ and ‘port_id’ are required. In case of a Smart NIC port, the required keys are ‘port_id’ and ‘hostname’. Argument can be specified multiple times.

-l <key=value>

DEPRECATED. Please use –local-link-connection instead. Key/value metadata describing Local link connection information. Valid keys are ‘switch_info’, ‘switch_id’, and ‘port_id’. The keys ‘switch_id’ and ‘port_id’ are required. Can be specified multiple times.

--pxe-enabled <boolean>

Indicates whether this Port should be used when PXE booting this Node.

--port-group <uuid>

UUID of the port group that this port belongs to.

--physical-network <physical network>

Name of the physical network to which this port is connected.

--is-smartnic

Indicates whether this Port is a Smart NIC port

address

MAC address for this port.

This command is provided by the python-ironicclient plugin.

baremetal port delete

Delete port(s).

openstack baremetal port delete <port> [<port> ...]
port

UUID(s) of the port(s) to delete.

This command is provided by the python-ironicclient plugin.

baremetal port group create

Create a new baremetal port group.

openstack baremetal port group create
    --node <uuid>
    [--address <mac-address>]
    [--name NAME]
    [--uuid UUID]
    [--extra <key=value>]
    [--mode MODE]
    [--property <key=value>]
    [--support-standalone-ports | --unsupport-standalone-ports]
--node <uuid>

UUID of the node that this port group belongs to.

--address <mac-address>

MAC address for this port group.

--name <NAME>

Name of the port group.

--uuid <UUID>

UUID of the port group.

--extra <key=value>

Record arbitrary key/value metadata. Can be specified multiple times.

--mode <MODE>

Mode of the port group. For possible values, refer to https://www.kernel.org/doc/Documentation/networking/bonding.txt.

--property <key=value>

Key/value property related to this port group’s configuration. Can be specified multiple times.

--support-standalone-ports

Ports that are members of this port group can be used as stand-alone ports. (default)

--unsupport-standalone-ports

Ports that are members of this port group cannot be used as stand-alone ports.

This command is provided by the python-ironicclient plugin.

baremetal port group delete

Unregister baremetal port group(s).

openstack baremetal port group delete <port group> [<port group> ...]
port group

Port group(s) to delete (name or UUID).

This command is provided by the python-ironicclient plugin.

baremetal port group list

List baremetal port groups.

openstack baremetal port group list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--limit <limit>]
    [--marker <port group>]
    [--sort <key>[:<direction>]]
    [--address <mac-address>]
    [--node <node>]
    [--long | --fields <field> [<field> ...]]
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

--limit <limit>

Maximum number of port groups to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service.

--marker <port group>

Port group UUID (for example, of the last port group in the list from a previous request). Returns the list of port groups after this UUID.

--sort <key>[:<direction>]

Sort output by specified port group fields and directions (asc or desc) (default: asc). Multiple fields and directions can be specified, separated by comma.

--address <mac-address>

Only show information for the port group with this MAC address.

--node <node>

Only list port groups of this node (name or UUID).

--long

Show detailed information about the port groups.

--fields <field>

One or more port group fields. Only these fields will be fetched from the server. Can not be used when ‘–long’ is specified.

This command is provided by the python-ironicclient plugin.

baremetal port group set

Set baremetal port group properties.

openstack baremetal port group set
    [--node <uuid>]
    [--address <mac-address>]
    [--name <name>]
    [--extra <key=value>]
    [--mode MODE]
    [--property <key=value>]
    [--support-standalone-ports | --unsupport-standalone-ports]
    <port
    group>
--node <uuid>

Update UUID of the node that this port group belongs to.

--address <mac-address>

MAC address for this port group.

--name <name>

Name of the port group.

--extra <key=value>

Extra to set on this baremetal port group (repeat option to set multiple extras).

--mode <MODE>

Mode of the port group. For possible values, refer to https://www.kernel.org/doc/Documentation/networking/bonding.txt.

--property <key=value>

Key/value property related to this port group’s configuration (repeat option to set multiple properties).

--support-standalone-ports

Ports that are members of this port group can be used as stand-alone ports.

--unsupport-standalone-ports

Ports that are members of this port group cannot be used as stand-alone ports.

port group

Name or UUID of the port group.

This command is provided by the python-ironicclient plugin.

baremetal port group show

Show baremetal port group details.

openstack baremetal port group show
    [--address]
    [--fields <field> [<field> ...]]
    <id>
--address

<id> is the MAC address (instead of UUID or name) of the port group.

--fields <field>

One or more port group fields. Only these fields will be fetched from the server.

id

UUID or name of the port group (or MAC address if –address is specified).

This command is provided by the python-ironicclient plugin.

baremetal port group unset

Unset baremetal port group properties.

openstack baremetal port group unset
    [--name]
    [--address]
    [--extra <key>]
    [--property <key>]
    <port
    group>
--name

Unset the name of the port group.

--address

Unset the address of the port group.

--extra <key>

Extra to unset on this baremetal port group (repeat option to unset multiple extras).

--property <key>

Property to unset on this baremetal port group (repeat option to unset multiple properties).

port group

Name or UUID of the port group.

This command is provided by the python-ironicclient plugin.

baremetal port list

List baremetal ports.

openstack baremetal port list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--address <mac-address>]
    [--node <node>]
    [--port-group <port group>]
    [--limit <limit>]
    [--marker <port>]
    [--sort <key>[:<direction>]]
    [--long | --fields <field> [<field> ...]]
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

--address <mac-address>

Only show information for the port with this MAC address.

--node <node>

Only list ports of this node (name or UUID).

--port-group <port group>

Only list ports of this port group (name or UUID).

--limit <limit>

Maximum number of ports to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service.

--marker <port>

Port UUID (for example, of the last port in the list from a previous request). Returns the list of ports after this UUID.

--sort <key>[:<direction>]

Sort output by specified port fields and directions (asc or desc) (default: asc). Multiple fields and directions can be specified, separated by comma.

--long

Show detailed information about ports.

--fields <field>

One or more port fields. Only these fields will be fetched from the server. Can not be used when ‘–long’ is specified.

This command is provided by the python-ironicclient plugin.

baremetal port set

Set baremetal port properties.

openstack baremetal port set
    [--node <uuid>]
    [--address <address>]
    [--extra <key=value>]
    [--port-group <uuid>]
    [--local-link-connection <key=value>]
    [--pxe-enabled | --pxe-disabled]
    [--physical-network <physical network>]
    [--is-smartnic]
    <port>
--node <uuid>

Set UUID of the node that this port belongs to

--address <address>

Set MAC address for this port

--extra <key=value>

Extra to set on this baremetal port (repeat option to set multiple extras)

--port-group <uuid>

Set UUID of the port group that this port belongs to.

Key/value metadata describing local link connection information. Valid keys are ‘switch_info’, ‘switch_id’, ‘port_id’ and ‘hostname’. The keys ‘switch_id’ and ‘port_id’ are required. In case of a Smart NIC port, the required keys are ‘port_id’ and ‘hostname’. Argument can be specified multiple times.

--pxe-enabled

Indicates that this port should be used when PXE booting this node (default)

--pxe-disabled

Indicates that this port should not be used when PXE booting this node

--physical-network <physical network>

Set the name of the physical network to which this port is connected.

--is-smartnic

Set port to be Smart NIC port

port

UUID of the port

This command is provided by the python-ironicclient plugin.

baremetal port show

Show baremetal port details.

openstack baremetal port show
    [--address]
    [--fields <field> [<field> ...]]
    <id>
--address

<id> is the MAC address (instead of the UUID) of the port.

--fields <field>

One or more port fields. Only these fields will be fetched from the server.

id

UUID of the port (or MAC address if –address is specified).

This command is provided by the python-ironicclient plugin.

baremetal port unset

Unset baremetal port properties.

openstack baremetal port unset
    [--extra <key>]
    [--port-group]
    [--physical-network]
    [--is-smartnic]
    <port>
--extra <key>

Extra to unset on this baremetal port (repeat option to unset multiple extras)

--port-group

Remove port from the port group

--physical-network

Unset the physical network on this baremetal port.

--is-smartnic

Set Port as not Smart NIC port

port

UUID of the port.

This command is provided by the python-ironicclient plugin.

baremetal volume connector create

Create a new baremetal volume connector.

openstack baremetal volume connector create
    --node <uuid>
    --type <type>
    --connector-id <connector
    id>
    [--uuid <uuid>]
    [--extra <key=value>]
--node <uuid>

UUID of the node that this volume connector belongs to.

--type <type>

Type of the volume connector. Can be ‘iqn’, ‘ip’, ‘mac’, ‘wwnn’, ‘wwpn’, ‘port’, ‘portgroup’.

--connector-id <connector id>

ID of the volume connector in the specified type. For example, the iSCSI initiator IQN for the node if the type is ‘iqn’.

--uuid <uuid>

UUID of the volume connector.

--extra <key=value>

Record arbitrary key/value metadata. Can be specified multiple times.

This command is provided by the python-ironicclient plugin.

baremetal volume connector delete

Unregister baremetal volume connector(s).

openstack baremetal volume connector delete
    <volume
    connector>
    [<volume connector> ...]
volume connector

UUID(s) of the volume connector(s) to delete.

This command is provided by the python-ironicclient plugin.

baremetal volume connector list

List baremetal volume connectors.

openstack baremetal volume connector list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--node <node>]
    [--limit <limit>]
    [--marker <volume connector>]
    [--sort <key>[:<direction>]]
    [--long | --fields <field> [<field> ...]]
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

--node <node>

Only list volume connectors of this node (name or UUID).

--limit <limit>

Maximum number of volume connectors to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service.

--marker <volume connector>

Volume connector UUID (for example, of the last volume connector in the list from a previous request). Returns the list of volume connectors after this UUID.

--sort <key>[:<direction>]

Sort output by specified volume connector fields and directions (asc or desc) (default:asc). Multiple fields and directions can be specified, separated by comma.

--long

Show detailed information about volume connectors.

--fields <field>

One or more volume connector fields. Only these fields will be fetched from the server. Can not be used when ‘–long’ is specified.

This command is provided by the python-ironicclient plugin.

baremetal volume connector set

Set baremetal volume connector properties.

openstack baremetal volume connector set
    [--node <uuid>]
    [--type <type>]
    [--connector-id <connector id>]
    [--extra <key=value>]
    <volume
    connector>
--node <uuid>

UUID of the node that this volume connector belongs to.

--type <type>

Type of the volume connector. Can be ‘iqn’, ‘ip’, ‘mac’, ‘wwnn’, ‘wwpn’, ‘port’, ‘portgroup’.

--connector-id <connector id>

ID of the volume connector in the specified type.

--extra <key=value>

Record arbitrary key/value metadata. Can be specified multiple times.

volume connector

UUID of the volume connector.

This command is provided by the python-ironicclient plugin.

baremetal volume connector show

Show baremetal volume connector details.

openstack baremetal volume connector show
    [--fields <field> [<field> ...]]
    <id>
--fields <field>

One or more volume connector fields. Only these fields will be fetched from the server.

id

UUID of the volume connector.

This command is provided by the python-ironicclient plugin.

baremetal volume connector unset

Unset baremetal volume connector properties.

openstack baremetal volume connector unset
    [--extra <key>]
    <volume
    connector>
--extra <key>

Extra to unset (repeat option to unset multiple extras)

volume connector

UUID of the volume connector.

This command is provided by the python-ironicclient plugin.

baremetal volume target create

Create a new baremetal volume target.

openstack baremetal volume target create
    --node <uuid>
    --type <volume
    type>
    [--property <key=value>]
    --boot-index <boot
    index>
    --volume-id <volume
    id>
    [--uuid <uuid>]
    [--extra <key=value>]
--node <uuid>

UUID of the node that this volume target belongs to.

--type <volume type>

Type of the volume target, e.g. ‘iscsi’, ‘fibre_channel’.

--property <key=value>

Key/value property related to the type of this volume target. Can be specified multiple times.

--boot-index <boot index>

Boot index of the volume target.

--volume-id <volume id>

ID of the volume associated with this target.

--uuid <uuid>

UUID of the volume target.

--extra <key=value>

Record arbitrary key/value metadata. Can be specified multiple times.

This command is provided by the python-ironicclient plugin.

baremetal volume target delete

Unregister baremetal volume target(s).

openstack baremetal volume target delete
    <volume
    target>
    [<volume target> ...]
volume target

UUID(s) of the volume target(s) to delete.

This command is provided by the python-ironicclient plugin.

baremetal volume target list

List baremetal volume targets.

openstack baremetal volume target list
    [--sort-column SORT_COLUMN]
    [--sort-ascending | --sort-descending]
    [--node <node>]
    [--limit <limit>]
    [--marker <volume target>]
    [--sort <key>[:<direction>]]
    [--long | --fields <field> [<field> ...]]
--sort-column SORT_COLUMN

specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

sort the column(s) in ascending order

--sort-descending

sort the column(s) in descending order

--node <node>

Only list volume targets of this node (name or UUID).

--limit <limit>

Maximum number of volume targets to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service.

--marker <volume target>

Volume target UUID (for example, of the last volume target in the list from a previous request). Returns the list of volume targets after this UUID.

--sort <key>[:<direction>]

Sort output by specified volume target fields and directions (asc or desc) (default:asc). Multiple fields and directions can be specified, separated by comma.

--long

Show detailed information about volume targets.

--fields <field>

One or more volume target fields. Only these fields will be fetched from the server. Can not be used when ‘–long’ is specified.

This command is provided by the python-ironicclient plugin.

baremetal volume target set

Set baremetal volume target properties.

openstack baremetal volume target set
    [--node <uuid>]
    [--type <volume type>]
    [--property <key=value>]
    [--boot-index <boot index>]
    [--volume-id <volume id>]
    [--extra <key=value>]
    <volume
    target>
--node <uuid>

UUID of the node that this volume target belongs to.

--type <volume type>

Type of the volume target, e.g. ‘iscsi’, ‘fibre_channel’.

--property <key=value>

Key/value property related to the type of this volume target. Can be specified multiple times.

--boot-index <boot index>

Boot index of the volume target.

--volume-id <volume id>

ID of the volume associated with this target.

--extra <key=value>

Record arbitrary key/value metadata. Can be specified multiple times.

volume target

UUID of the volume target.

This command is provided by the python-ironicclient plugin.

baremetal volume target show

Show baremetal volume target details.

openstack baremetal volume target show
    [--fields <field> [<field> ...]]
    <id>
--fields <field>

One or more volume target fields. Only these fields will be fetched from the server.

id

UUID of the volume target.

This command is provided by the python-ironicclient plugin.

baremetal volume target unset

Unset baremetal volume target properties.

openstack baremetal volume target unset
    [--extra <key>]
    [--property <key>]
    <volume
    target>
--extra <key>

Extra to unset (repeat option to unset multiple extras)

--property <key>

Property to unset on this baremetal volume target (repeat option to unset multiple properties).

volume target

UUID of the volume target.

This command is provided by the python-ironicclient plugin.