From 8066f8c745054caeb7bd66d4c2be15ab5fac1d1f Mon Sep 17 00:00:00 2001
From: Stephen Finucane <stephenfin@redhat.com>
Date: Tue, 31 Aug 2021 17:44:20 +0100
Subject: Microversion 2.90 - Configurable hostnames

Change-Id: Icd4362a07196e59bafcdfaff44323ce1386d4f55
Signed-off-by: Stephen Finucane <stephenfin@redhat.com>
Depends-On: https://review.opendev.org/c/openstack/nova/+/778550/
---
 doc/source/cli/nova.rst | 26 ++++++++++++++++++++++++--
 1 file changed, 24 insertions(+), 2 deletions(-)

(limited to 'doc')

diff --git a/doc/source/cli/nova.rst b/doc/source/cli/nova.rst
index 4b501949..54ec9991 100644
--- a/doc/source/cli/nova.rst
+++ b/doc/source/cli/nova.rst
@@ -975,6 +975,7 @@ nova boot
                     [--trusted-image-certificate-id <trusted-image-certificate-id>]
                     [--host <host>]
                     [--hypervisor-hostname <hypervisor-hostname>]
+                    [--hostname <hostname>]
                     <name>
 
 Boot a new server.
@@ -1149,6 +1150,12 @@ quality of service support, microversion ``2.72`` is required.
   Requested hypervisor hostname to create servers. Admin only by default.
   (Supported by API versions '2.74' - '2.latest')
 
+``--hostname <hostname>``
+  Hostname for the instance. This sets the hostname stored in the
+  metadata server: a utility such as cloud-init running on the guest
+  is required to propagate these changes to the guest.
+  (Supported by API versions '2.90' - '2.latest')
+
 .. _nova_clear-password:
 
 nova clear-password
@@ -2885,6 +2892,7 @@ nova rebuild
                        [--user-data <user-data>] [--user-data-unset]
                        [--trusted-image-certificate-id <trusted-image-certificate-id>]
                        [--trusted-image-certificates-unset]
+                       [--hostname <hostname>]
                        <server> <image>
 
 Shutdown, re-image, and re-boot a server.
@@ -2958,6 +2966,12 @@ Shutdown, re-image, and re-boot a server.
   specified with the ``--trusted-image-certificate-id`` option.
   (Supported by API versions '2.63' - '2.latest')
 
+``--hostname <hostname>``
+  New hostname for the instance. This only updates the hostname
+  stored in the metadata server: a utility running on the guest
+  is required to propagate these changes to the guest.
+  (Supported by API versions '2.90' - '2.latest')
+
 .. _nova_refresh-network:
 
 nova refresh-network
@@ -3795,9 +3809,11 @@ nova update
 
 .. code-block:: console
 
-   usage: nova update [--name <name>] [--description <description>] <server>
+   usage: nova update [--name <name>] [--description <description>]
+                      [--hostname <hostname>]
+                      <server>
 
-Update the name or the description for a server.
+Update attributes of a server.
 
 **Positional arguments:**
 
@@ -3815,6 +3831,12 @@ Update the name or the description for a server.
   will be removed. (Supported by API versions
   '2.19' - '2.latest')
 
+``--hostname <hostname>``
+  New hostname for the instance. This only updates the hostname
+  stored in the metadata server: a utility running on the guest
+  is required to propagate these changes to the guest.
+  (Supported by API versions '2.90' - '2.latest')
+
 .. _nova_usage:
 
 nova usage
-- 
cgit v1.2.1