diff options
author | Zuul <zuul@review.opendev.org> | 2021-08-31 10:54:48 +0000 |
---|---|---|
committer | Gerrit Code Review <review@openstack.org> | 2021-08-31 10:54:48 +0000 |
commit | 649b2452da07c25e1251c6185552278f91b7c517 (patch) | |
tree | 1103e84572dc275f28f350efa9d995f52c403628 /doc | |
parent | 0d0de2e448ebfe0485eb1714b1f9d81b807c7128 (diff) | |
parent | e906a8c0ec87b870b0ae75c20cf1d2da36433636 (diff) | |
download | nova-649b2452da07c25e1251c6185552278f91b7c517.tar.gz |
Merge "nova-manage: Introduce volume show, refresh, get_connector commands"
Diffstat (limited to 'doc')
-rw-r--r-- | doc/source/cli/nova-manage.rst | 108 |
1 files changed, 108 insertions, 0 deletions
diff --git a/doc/source/cli/nova-manage.rst b/doc/source/cli/nova-manage.rst index 2478de3899..8354e9bc2b 100644 --- a/doc/source/cli/nova-manage.rst +++ b/doc/source/cli/nova-manage.rst @@ -1408,6 +1408,114 @@ This command requires that the - Invalid input +Volume Attachment Commands +========================== + +volume_attachment get_connector +------------------------------- + +.. program:: nova-manage volume_attachment get_connector + +.. code-block:: shell + + nova-manage volume_attachment get_connector + +Show the host connector for this compute host. + +When called with the ``--json`` switch this dumps a JSON string containing the +connector information for the current host, which can be saved to a file and +used as input for the :program:`nova-manage volume_attachment refresh` command. + +.. versionadded:: 24.0.0 (Xena) + +.. rubric:: Return codes + +.. list-table:: + :widths: 20 80 + :header-rows: 1 + + * - Return code + - Description + * - 0 + - Success + * - 1 + - An unexpected error occurred + +volume_attachment show +---------------------- + +.. program:: nova-manage volume_attachment show + +.. code-block:: shell + + nova-manage volume_attachment show [INSTANCE_UUID] [VOLUME_ID] + +Show the details of a the volume attachment between ``VOLUME_ID`` and +``INSTANCE_UUID``. + +.. versionadded:: 24.0.0 (Xena) + +.. rubric:: Return codes + +.. list-table:: + :widths: 20 80 + :header-rows: 1 + + * - Return code + - Description + * - 0 + - Success + * - 1 + - An unexpected error occurred + * - 2 + - Instance not found + * - 3 + - Instance is not attached to volume + +volume_attachment refresh +------------------------- + +.. program:: nova-manage volume_attachment refresh + +.. code-block:: shell + + nova-manage volume_attachment refresh [INSTANCE_UUID] [VOLUME_ID] [CONNECTOR_PATH] + +Refresh the connection info associated with a given volume attachment. + +The instance must be attached to the volume, have a ``vm_state`` of ``stopped`` +and not be ``locked``. + +``CONNECTOR_PATH`` should be the path to a JSON-formatted file containing up to +date connector information for the compute currently hosting the instance as +generated using the :program:`nova-manage volume_attachment get_connector` +command. + +.. versionadded:: 24.0.0 (Xena) + +.. rubric:: Return codes + +.. list-table:: + :widths: 20 80 + :header-rows: 1 + + * - Return code + - Description + * - 0 + - Success + * - 1 + - An unexpected error occurred + * - 2 + - Connector path does not exist + * - 3 + - Failed to open connector path + * - 4 + - Instance does not exist + * - 5 + - Instance state invalid (must be stopped and unlocked) + * - 6 + - Instance is not attached to volume + Libvirt Commands ================ |