Chapter 11. baremetal


This chapter describes the commands under the baremetal command.

11.1. baremetal node power on

Usage:

openstack baremetal node power on [-h]

                                       [--power-timeout <power-timeout>]
                                       <node>

Power on a node

Expand
Table 11.1. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--power-timeout <power-timeout>

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

This command is provided by the python-ironicclient plugin.

11.2. baremetal node provide

Usage:

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

Set provision state of baremetal node to 'provide'

Expand
Table 11.3. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.4. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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.

This command is provided by the python-ironicclient plugin.

11.3. baremetal node reboot

Usage:

openstack baremetal node reboot [-h] [--soft]

                                     [--power-timeout <power-timeout>]
                                     <node>

Reboot baremetal node

Expand
Table 11.5. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.6. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--soft

Request graceful reboot.

--power-timeout <power-timeout>

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

This command is provided by the python-ironicclient plugin.

11.4. baremetal node rebuild

Usage:

openstack baremetal node rebuild [-h] [--wait [<time-out>]]

                                      [--config-drive <config-drive>]
                                      <node>

Set provision state of baremetal node to 'rebuild'

Expand
Table 11.7. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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. In case it’s a directory, a config drive will be generated from it.

This command is provided by the python-ironicclient plugin.

11.5. baremetal node remove trait

Usage:

openstack baremetal node remove trait [-h] [--all]

                                           <node> [<trait> [<trait> ...]]

Remove trait(s) from a node.

Expand
Table 11.9. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

<trait>

Trait(s) to remove

Expand
Table 11.10. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--all

Remove all traits

This command is provided by the python-ironicclient plugin.

11.6. baremetal node rescue

Usage:

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

                                     --rescue-password <rescue-password>
                                     <node>

Set provision state of baremetal node to 'rescue'

Expand
Table 11.11. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.12. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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.

This command is provided by the python-ironicclient plugin.

11.7. baremetal node set

Usage:

openstack baremetal node set [-h] [--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]
                                  [--inspect-interface <inspect_interface> | --reset-inspect-interface]
                                  [--management-interface <management_interface> | --reset-management-interface]
                                  [--network-interface <network_interface> | --reset-network-interface]
                                  [--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>]
                                  [--target-raid-config <target_raid_config>]
                                  [--property <key=value>]
                                  [--extra <key=value>]
                                  [--driver-info <key=value>]
                                  [--instance-info <key=value>]
                                  <node>

Set baremetal properties

Expand
Table 11.13. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.14. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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

--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

--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

--target-raid-config <target_raid_config>

Set the target RAID configuration (JSON) for the node. This can be one of: 1. a file containing JSON 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)

This command is provided by the python-ironicclient plugin.

11.8. baremetal node show

Usage:

openstack baremetal node show [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   [--instance]
                                   [--fields <field> [<field> ...]]
                                   <node>

Show baremetal node details

Expand
Table 11.15. Positional Arguments
ValueSummary

<node>

Name or uuid of the node (or instance uuid if

--instance is specified)

 
Expand
Table 11.16. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--instance

<node> is an instance uuid.

--fields <field> [<field> …​]

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

Expand
Table 11.17. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 11.18. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.19. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.20. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.9. baremetal node trait list

Usage:

openstack baremetal node trait list [-h]

                                         [-f {csv,json,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent]
                                         [--quote {all,minimal,none,nonnumeric}]
                                         [--sort-column SORT_COLUMN]
                                         <node>

List a node’s traits.

Expand
Table 11.21. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

Expand
Table 11.22. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 11.23. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--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

Expand
Table 11.24. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.25. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.26. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

11.10. baremetal node undeploy

Usage:

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

Set provision state of baremetal node to 'deleted'

Expand
Table 11.27. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.28. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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.

This command is provided by the python-ironicclient plugin.

11.11. baremetal node unrescue

Usage:

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

Set provision state of baremetal node to 'unrescue'

Expand
Table 11.29. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.30. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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.

This command is provided by the python-ironicclient plugin.

11.12. baremetal node unset

Usage:

openstack baremetal node unset [-h] [--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]
                                    [--inspect-interface]
                                    [--management-interface]
                                    [--network-interface]
                                    [--power-interface] [--raid-interface]
                                    [--rescue-interface]
                                    [--storage-interface]
                                    [--vendor-interface] [--conductor-group]
                                    <node>

Unset baremetal properties

Expand
Table 11.31. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.32. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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 driver informations)

--instance-info <key>

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

--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

--inspect-interface

Unset inspect interface on this baremetal node

--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)

This command is provided by the python-ironicclient plugin.

11.13. baremetal node validate

Usage:

openstack baremetal node validate [-h] [-f {csv,json,table,value,yaml}]

                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent]
                                       [--quote {all,minimal,none,nonnumeric}]
                                       [--sort-column SORT_COLUMN]
                                       <node>

Validate a node’s driver interfaces

Expand
Table 11.33. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

Expand
Table 11.34. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 11.35. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--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

Expand
Table 11.36. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.37. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.38. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

11.14. baremetal node vif attach

Usage:

openstack baremetal node vif attach [-h] [--vif-info <key=value>]

                                         <node> <vif-id>

Attach VIF to a given node

Expand
Table 11.39. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

<vif-id>

Name or uuid of the vif to attach to a node.

Expand
Table 11.40. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--vif-info <key=value>

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

This command is provided by the python-ironicclient plugin.

11.15. baremetal node vif detach

Usage:

openstack baremetal node vif detach [-h] <node> <vif-id>

Detach VIF from a given node

Expand
Table 11.41. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

<vif-id>

Name or uuid of the vif to detach from a node.

Expand
Table 11.42. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

11.16. baremetal node vif list

Usage:

openstack baremetal node vif list [-h] [-f {csv,json,table,value,yaml}]

                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent]
                                       [--quote {all,minimal,none,nonnumeric}]
                                       [--sort-column SORT_COLUMN]
                                       <node>

Show attached VIFs for a node

Expand
Table 11.43. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

Expand
Table 11.44. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 11.45. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--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

Expand
Table 11.46. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.47. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.48. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

11.17. baremetal port create

Usage:

openstack baremetal port create [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX] --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>]
                                     <address>

Create a new port

Expand
Table 11.49. Positional Arguments
ValueSummary

<address>

Mac address for this port.

Expand
Table 11.50. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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. can be specified multiple times.

--local-link-connection <key=value>

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.

-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.

Expand
Table 11.51. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 11.52. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.53. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.54. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.18. baremetal port delete

Usage:

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

Delete port(s).

Expand
Table 11.55. Positional Arguments
ValueSummary

<port>

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

Expand
Table 11.56. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

11.19. baremetal port group create

Usage:

openstack baremetal port group create [-h]

                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--noindent] [--prefix PREFIX]
                                           --node <uuid>
                                           [--address <mac-address>]
                                           [--name NAME] [--uuid UUID]
                                           [--extra <key=value>]
                                           [--mode MODE]
                                           [--property <key=value>]
                                           [--support-standalone-ports | --unsupport-standalone-ports]

Create a new baremetal port group.

Expand
Table 11.57. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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/bo nding.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.

Expand
Table 11.58. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 11.59. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.60. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.61. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.20. baremetal port group delete

Usage:

openstack baremetal port group delete [-h]

                                           <port group> [<port group> ...]

Unregister baremetal port group(s).

Expand
Table 11.62. Positional Arguments
ValueSummary

<port group>

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

Expand
Table 11.63. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

11.21. baremetal port group list

Usage:

openstack baremetal port group list [-h]

                                         [-f {csv,json,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent]
                                         [--quote {all,minimal,none,nonnumeric}]
                                         [--sort-column SORT_COLUMN]
                                         [--limit <limit>]
                                         [--marker <port group>]
                                         [--sort <key>[:<direction>]]
                                         [--address <mac-address>]
                                         [--node <node>]
                                         [--long | --fields <field> [<field> ...]]

List baremetal port groups.

Expand
Table 11.64. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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> [<field> …​]

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

Expand
Table 11.65. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--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

Expand
Table 11.66. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.67. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.68. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

11.22. baremetal port group set

Usage:

openstack baremetal port group set [-h] [--node <uuid>]

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

Set baremetal port group properties.

Expand
Table 11.69. Positional Arguments
ValueSummary

<port group>

Name or uuid of the port group.

Expand
Table 11.70. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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/bo nding.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.

This command is provided by the python-ironicclient plugin.

11.23. baremetal port group show

Usage:

openstack baremetal port group show [-h]

                                         [-f {json,shell,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent] [--prefix PREFIX]
                                         [--address]
                                         [--fields <field> [<field> ...]]
                                         <id>

Show baremetal port group details.

Expand
Table 11.71. Positional Arguments
ValueSummary

<id>

Uuid or name of the port group (or mac address if

--address is specified).

 
Expand
Table 11.72. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--address

<id> is the mac address (instead of uuid or name) of the port group.

--fields <field> [<field> …​]

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

Expand
Table 11.73. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 11.74. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.75. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.76. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.24. baremetal port group unset

Usage:

openstack baremetal port group unset [-h] [--name] [--address]

                                          [--extra <key>] [--property <key>]
                                          <port group>

Unset baremetal port group properties.

Expand
Table 11.77. Positional Arguments
ValueSummary

<port group>

Name or uuid of the port group.

Expand
Table 11.78. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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).

This command is provided by the python-ironicclient plugin.

11.25. baremetal port list

Usage:

openstack baremetal port list [-h] [-f {csv,json,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--sort-column SORT_COLUMN]
                                   [--address <mac-address>] [--node <node>]
                                   [--port-group <port group>]
                                   [--limit <limit>] [--marker <port>]
                                   [--sort <key>[:<direction>]]
                                   [--long | --fields <field> [<field> ...]]

List baremetal ports.

Expand
Table 11.79. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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 Ironic 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> [<field> …​]

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

Expand
Table 11.80. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--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

Expand
Table 11.81. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.82. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.83. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

11.26. baremetal port set

Usage:

openstack baremetal port set [-h] [--node <uuid>] [--address <address>]

                                  [--extra <key=value>]
                                  [--port-group <uuid>]
                                  [--local-link-connection <key=value>]
                                  [--pxe-enabled | --pxe-disabled]
                                  [--physical-network <physical network>]
                                  <port>

Set baremetal port properties.

Expand
Table 11.84. Positional Arguments
ValueSummary

<port>

Uuid of the port

Expand
Table 11.85. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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.

--local-link-connection <key=value>

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

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.

This command is provided by the python-ironicclient plugin.

11.27. baremetal port show

Usage:

openstack baremetal port show [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   [--address]
                                   [--fields <field> [<field> ...]]
                                   <id>

Show baremetal port details.

Expand
Table 11.86. Positional Arguments
ValueSummary

<id>

Uuid of the port (or mac address if --address is specified).

Expand
Table 11.87. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--address

<id> is the mac address (instead of the uuid) of the port.

--fields <field> [<field> …​]

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

Expand
Table 11.88. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 11.89. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.90. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.91. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.28. baremetal port unset

Usage:

openstack baremetal port unset [-h] [--extra <key>] [--port-group]

                                    [--physical-network]
                                    <port>

Unset baremetal port properties.

Expand
Table 11.92. Positional Arguments
ValueSummary

<port>

Uuid of the port.

Expand
Table 11.93. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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.

This command is provided by the python-ironicclient plugin.

11.29. baremetal volume connector create

Usage:

openstack baremetal volume connector create [-h]

                                                 [-f {json,shell,table,value,yaml}]
                                                 [-c COLUMN]
                                                 [--max-width <integer>]
                                                 [--fit-width]
                                                 [--print-empty]
                                                 [--noindent]
                                                 [--prefix PREFIX] --node
                                                 <uuid> --type <type>
                                                 --connector-id <connector
                                                 id> [--uuid <uuid>]
                                                 [--extra <key=value>]

Create a new baremetal volume connector.

Expand
Table 11.94. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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.

Expand
Table 11.95. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 11.96. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.97. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.98. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.30. baremetal volume connector delete

Usage:

openstack baremetal volume connector delete [-h]

                                                 <volume connector>
                                                 [<volume connector> ...]

Unregister baremetal volume connector(s).

Expand
Table 11.99. Positional Arguments
ValueSummary

<volume connector>

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

Expand
Table 11.100. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

11.31. baremetal volume connector list

Usage:

openstack baremetal volume connector list [-h]

                                               [-f {csv,json,table,value,yaml}]
                                               [-c COLUMN]
                                               [--max-width <integer>]
                                               [--fit-width] [--print-empty]
                                               [--noindent]
                                               [--quote {all,minimal,none,nonnumeric}]
                                               [--sort-column SORT_COLUMN]
                                               [--node <node>]
                                               [--limit <limit>]
                                               [--marker <volume connector>]
                                               [--sort <key>[:<direction>]]
                                               [--long | --fields <field> [<field> ...]]

List baremetal volume connectors.

Expand
Table 11.101. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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> [<field> …​]

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

Expand
Table 11.102. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--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

Expand
Table 11.103. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.104. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.105. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

11.32. baremetal volume connector set

Usage:

openstack baremetal volume connector set [-h] [--node <uuid>]

                                              [--type <type>]
                                              [--connector-id <connector id>]
                                              [--extra <key=value>]
                                              <volume connector>

Set baremetal volume connector properties.

Expand
Table 11.106. Positional Arguments
ValueSummary

<volume connector>

Uuid of the volume connector.

Expand
Table 11.107. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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.

This command is provided by the python-ironicclient plugin.

11.33. baremetal volume connector show

Usage:

openstack baremetal volume connector show [-h]

                                               [-f {json,shell,table,value,yaml}]
                                               [-c COLUMN]
                                               [--max-width <integer>]
                                               [--fit-width] [--print-empty]
                                               [--noindent]
                                               [--prefix PREFIX]
                                               [--fields <field> [<field> ...]]
                                               <id>

Show baremetal volume connector details.

Expand
Table 11.108. Positional Arguments
ValueSummary

<id>

Uuid of the volume connector.

Expand
Table 11.109. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--fields <field> [<field> …​]

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

Expand
Table 11.110. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 11.111. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.112. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.113. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.34. baremetal volume connector unset

Usage:

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

                                                <volume connector>

Unset baremetal volume connector properties.

Expand
Table 11.114. Positional Arguments
ValueSummary

<volume connector>

Uuid of the volume connector.

Expand
Table 11.115. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--extra <key>

Extra to unset (repeat option to unset multiple extras)

This command is provided by the python-ironicclient plugin.

11.35. baremetal volume target create

Usage:

openstack baremetal volume target create [-h]

                                              [-f {json,shell,table,value,yaml}]
                                              [-c COLUMN]
                                              [--max-width <integer>]
                                              [--fit-width] [--print-empty]
                                              [--noindent] [--prefix PREFIX]
                                              --node <uuid> --type <volume
                                              type> [--property <key=value>]
                                              --boot-index <boot index>
                                              --volume-id <volume id>
                                              [--uuid <uuid>]
                                              [--extra <key=value>]

Create a new baremetal volume target.

Expand
Table 11.116. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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.

Expand
Table 11.117. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 11.118. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.119. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.120. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.36. baremetal volume target delete

Usage:

openstack baremetal volume target delete [-h]

                                              <volume target>
                                              [<volume target> ...]

Unregister baremetal volume target(s).

Expand
Table 11.121. Positional Arguments
ValueSummary

<volume target>

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

Expand
Table 11.122. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

11.37. baremetal volume target list

Usage:

openstack baremetal volume target list [-h]

                                            [-f {csv,json,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent]
                                            [--quote {all,minimal,none,nonnumeric}]
                                            [--sort-column SORT_COLUMN]
                                            [--node <node>]
                                            [--limit <limit>]
                                            [--marker <volume target>]
                                            [--sort <key>[:<direction>]]
                                            [--long | --fields <field> [<field> ...]]

List baremetal volume targets.

Expand
Table 11.123. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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> [<field> …​]

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

Expand
Table 11.124. Output Formatters
ValueSummary

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

--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

Expand
Table 11.125. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.126. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.127. CSV Formatter
ValueSummary

--quote {all,minimal,none,nonnumeric}

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

11.38. baremetal volume target set

Usage:

openstack baremetal volume target set [-h] [--node <uuid>]

                                           [--type <volume type>]
                                           [--property <key=value>]
                                           [--boot-index <boot index>]
                                           [--volume-id <volume id>]
                                           [--extra <key=value>]
                                           <volume target>

Set baremetal volume target properties.

Expand
Table 11.128. Positional Arguments
ValueSummary

<volume target>

Uuid of the volume target.

Expand
Table 11.129. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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.

This command is provided by the python-ironicclient plugin.

11.39. baremetal volume target show

Usage:

openstack baremetal volume target show [-h]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            [--fields <field> [<field> ...]]
                                            <id>

Show baremetal volume target details.

Expand
Table 11.130. Positional Arguments
ValueSummary

<id>

Uuid of the volume target.

Expand
Table 11.131. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--fields <field> [<field> …​]

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

Expand
Table 11.132. Output Formatters
ValueSummary

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

the output format, defaults to table

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 11.133. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.134. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.135. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.40. baremetal volume target unset

Usage:

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

                                             [--property <key>]
                                             <volume target>

Unset baremetal volume target properties.

Expand
Table 11.136. Positional Arguments
ValueSummary

<volume target>

Uuid of the volume target.

Expand
Table 11.137. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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).

This command is provided by the python-ironicclient plugin.

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat
Back to top