Update openstackclient commands
This updates the spec to reflect the changes that were done during implementation of the osc commands. In particular: - it was decided not to provide two commands (differing in spelling) for the same thing, so 'passthru' instead of 'passthrough' - not to implement osc commands that are equivalent to 'ironic driver-raid-logical-disk-properties' and 'ironic driver-properties' because we aren't sure (yet) what the "right" command might be Change-Id: I1f146e73ea342f07d65dcc985a5e94f2c8a98fd0 Closes-Bug: #1526479
This commit is contained in:
parent
7193727248
commit
baea3c0df3
@ -49,10 +49,12 @@ structure [#]_ :
|
|||||||
instead of "openstack baremetal node boot-device set", we are going to use
|
instead of "openstack baremetal node boot-device set", we are going to use
|
||||||
"openstack baremetal node boot device set".
|
"openstack baremetal node boot device set".
|
||||||
|
|
||||||
* a small survey indicated that some people liked 'passthrough' and
|
* only provide one OpenStackClient command to do something; avoid aliasing
|
||||||
others liked 'thru'. Ironic's REST API and documentation use
|
|
||||||
'thru', whereas 'passthrough' is more "proper" English. To make
|
* for naming, the trend is to use Americanised spelling, eg 'favor' instead of
|
||||||
everyone happy, we'll support both spellings.
|
'favour'. Having said that, it is important to take into consideration
|
||||||
|
the terminology/usage outside of OpenStack, e.g. by operators and
|
||||||
|
administrators.
|
||||||
|
|
||||||
Alternatives
|
Alternatives
|
||||||
------------
|
------------
|
||||||
@ -100,6 +102,7 @@ openstack baremetal chassis
|
|||||||
--description <description> Chassis description
|
--description <description> Chassis description
|
||||||
--extra <key=value> Extra chassis properties. Can be specified
|
--extra <key=value> Extra chassis properties. Can be specified
|
||||||
multiple times.
|
multiple times.
|
||||||
|
--uuid <uuid> UUID of the chassis
|
||||||
|
|
||||||
* openstack baremetal chassis delete <uuid> [<uuid> ...]
|
* openstack baremetal chassis delete <uuid> [<uuid> ...]
|
||||||
|
|
||||||
@ -116,34 +119,27 @@ openstack baremetal chassis
|
|||||||
--description <description> Will unset the chassis description ('')
|
--description <description> Will unset the chassis description ('')
|
||||||
|
|
||||||
ironic CLI users who want to see a list of nodes belonging to a given chassis
|
ironic CLI users who want to see a list of nodes belonging to a given chassis
|
||||||
should use `openstack baremetal node list --chassis`, since we will not
|
should use ``openstack baremetal node list --chassis``, since we will not
|
||||||
provide an `openstack baremetal chassis xxx` equivalent to
|
provide an ``openstack baremetal chassis xxx`` equivalent to
|
||||||
`ironic chassis-node-list`.
|
``ironic chassis-node-list``.
|
||||||
|
|
||||||
openstack baremetal driver
|
openstack baremetal driver
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
* openstack baremetal driver list
|
* openstack baremetal driver list
|
||||||
|
|
||||||
* openstack baremetal driver show <driver_name>
|
* openstack baremetal driver show <driver>
|
||||||
--properties Only shows available driver properties
|
|
||||||
|
|
||||||
* openstack baremetal driver passthrough list <driver_name>
|
* openstack baremetal driver passthru list <driver>
|
||||||
|
|
||||||
* openstack baremetal driver passthrough call <driver_name> <method>
|
* openstack baremetal driver passthru call <driver> <method>
|
||||||
|
|
||||||
<method> Vendor passthrough method to call.
|
<method> Vendor passthru method to call.
|
||||||
|
|
||||||
--arg <key=value> key=value to add to passthrough method. Can be
|
--arg <key=value> key=value to add to passthru method. Can be
|
||||||
specified multiple times.
|
specified multiple times.
|
||||||
--http-method <http_method> one of 'POST', 'PUT', 'GET', 'DELETE', 'PATCH'
|
--http-method <http_method> one of 'POST', 'PUT', 'GET', 'DELETE', 'PATCH'
|
||||||
|
|
||||||
* openstack baremetal driver passthru list <driver_name>
|
|
||||||
An alias to 'openstack baremetal driver passthrough list'
|
|
||||||
|
|
||||||
* openstack baremetal driver passthru call <driver_name> <method>
|
|
||||||
An alias to 'openstack baremetal driver passthrough call'
|
|
||||||
|
|
||||||
openstack baremetal node
|
openstack baremetal node
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
@ -152,8 +148,7 @@ openstack baremetal node
|
|||||||
Obsoletes: openstack baremetal show
|
Obsoletes: openstack baremetal show
|
||||||
|
|
||||||
--instance Interpret <uuid> as an instance UUID
|
--instance Interpret <uuid> as an instance UUID
|
||||||
--long Display detailed information about node.
|
--fields <field,[field,...]> Select fields to fetch and display.
|
||||||
--states Include state information. Mutually exclusive with --long.
|
|
||||||
|
|
||||||
* openstack baremetal node list
|
* openstack baremetal node list
|
||||||
|
|
||||||
@ -203,6 +198,12 @@ openstack baremetal node
|
|||||||
specified multiple times.
|
specified multiple times.
|
||||||
--instance-info <key=value> instance-info to set/update on the node. Can be
|
--instance-info <key=value> instance-info to set/update on the node. Can be
|
||||||
specified multiple times.
|
specified multiple times.
|
||||||
|
--target-raid-config <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.
|
||||||
|
|
||||||
* openstack baremetal node unset <uuid>
|
* openstack baremetal node unset <uuid>
|
||||||
|
|
||||||
@ -217,22 +218,18 @@ openstack baremetal node
|
|||||||
--instance-info <key> key to unset from instance-info. Can be specified
|
--instance-info <key> key to unset from instance-info. Can be specified
|
||||||
multiple times.
|
multiple times.
|
||||||
--instance-uuid <uuid> Instance uuid.
|
--instance-uuid <uuid> Instance uuid.
|
||||||
|
--name Name of the node.
|
||||||
* openstack baremetal node passthrough list <uuid>
|
--target-raid_config target RAID configuration
|
||||||
|
|
||||||
* openstack baremetal node passthrough call <uuid> <method>
|
|
||||||
|
|
||||||
<method> Vendor-passthrough method to be called
|
|
||||||
|
|
||||||
--arg <key=value> argument to send to passthrough method. Can
|
|
||||||
be specified multiple times.
|
|
||||||
--http-method <http_method> One of 'POST', 'PUT', 'GET', 'DELETE', 'PATCH'
|
|
||||||
|
|
||||||
* openstack baremetal node passthru list <uuid>
|
* openstack baremetal node passthru list <uuid>
|
||||||
an alias to 'openstack baremetal node passthrough list'
|
|
||||||
|
|
||||||
* openstack baremetal node passthru call <uuid> <method>
|
* openstack baremetal node passthru call <uuid> <method>
|
||||||
an alias to 'openstack baremetal node passthrough call'
|
|
||||||
|
<method> Vendor passthru method to be called
|
||||||
|
|
||||||
|
--arg <key=value> argument to send to passthru method. Can
|
||||||
|
be specified multiple times.
|
||||||
|
--http-method <http_method> One of 'POST', 'PUT', 'GET', 'DELETE', 'PATCH'
|
||||||
|
|
||||||
* openstack baremetal node console show <uuid>
|
* openstack baremetal node console show <uuid>
|
||||||
|
|
||||||
@ -286,9 +283,16 @@ openstack baremetal node
|
|||||||
* openstack baremetal node validate <uuid>
|
* openstack baremetal node validate <uuid>
|
||||||
|
|
||||||
ironic CLI users who want to see a list of ports belonging to a given node
|
ironic CLI users who want to see a list of ports belonging to a given node
|
||||||
should use `openstack baremetal port list --node`, since we will not
|
should use ``openstack baremetal port list --node``, since we will not
|
||||||
provide an `openstack baremetal node xxx` equivalent to
|
provide an ``openstack baremetal node xxx`` equivalent to
|
||||||
`ironic node-port-list`.
|
``ironic node-port-list``.
|
||||||
|
|
||||||
|
ironic CLI users who want the equivalent to ``ironic node-show-states`` should
|
||||||
|
use the following command::
|
||||||
|
|
||||||
|
openstack baremetal node show <node> --fields console_enabled last_error
|
||||||
|
power_state provision_state provision_updated_at raid_config
|
||||||
|
target_power_state target_provision_state target_raid_config
|
||||||
|
|
||||||
openstack baremetal port
|
openstack baremetal port
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
@ -328,6 +332,17 @@ openstack baremetal port
|
|||||||
--extra <key> key to remove. Can be specified multiple times.
|
--extra <key> key to remove. Can be specified multiple times.
|
||||||
|
|
||||||
|
|
||||||
|
Not addressed
|
||||||
|
~~~~~~~~~~~~~
|
||||||
|
OpenStackClient commands corresponding to these ironic CLI commands are not
|
||||||
|
addressed by this proposal. They will be addressed in a future release.
|
||||||
|
|
||||||
|
* ``ironic driver-raid-logical-disk-properties``. Get RAID logical disk
|
||||||
|
properties for a driver.
|
||||||
|
|
||||||
|
* ``ironic driver-properties``. Get properties (node.driver_info keys and
|
||||||
|
descriptions) for a driver.
|
||||||
|
|
||||||
RPC API impact
|
RPC API impact
|
||||||
--------------
|
--------------
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user