summaryrefslogtreecommitdiff
path: root/doc/source/command-objects/server.rst
diff options
context:
space:
mode:
authorDavid Rabel <rabel@b1-systems.de>2017-03-13 15:16:48 +0100
committerDavid Rabel <rabel@b1-systems.de>2017-04-07 16:36:18 +0200
commit8549071363805a9eef815dd2429b6b860db11a2c (patch)
tree64d33748a43f31851ec3b7c2756fd166314ac9f7 /doc/source/command-objects/server.rst
parent4a19f6753b9e21b3089824d17943b39c211a616a (diff)
downloadpython-openstackclient-8549071363805a9eef815dd2429b6b860db11a2c.tar.gz
Add --network and --port to server create
--nic option is quite unhandy. It is better to have two seperate options --network and --port to add a network to a new server. Change-Id: I523abdc83ca2dd4c5dd3871f8f109c2bf57c2e02 Closes-Bug: #1612898
Diffstat (limited to 'doc/source/command-objects/server.rst')
-rw-r--r--doc/source/command-objects/server.rst26
1 files changed, 26 insertions, 0 deletions
diff --git a/doc/source/command-objects/server.rst b/doc/source/command-objects/server.rst
index b2ae965a..3d2bbdf3 100644
--- a/doc/source/command-objects/server.rst
+++ b/doc/source/command-objects/server.rst
@@ -108,6 +108,8 @@ Create a new server
[--availability-zone <zone-name>]
[--block-device-mapping <dev-name=mapping> [...] ]
[--nic <net-id=net-uuid,v4-fixed-ip=ip-addr,v6-fixed-ip=ip-addr,port-id=port-uuid,auto,none> [...] ]
+ [--network <network>]
+ [--port <port>]
[--hint <key=value> [...] ]
[--config-drive <value>|True ]
[--min <count>]
@@ -176,6 +178,20 @@ Create a new server
Specifying a --nic of auto or none cannot be used with any other
--nic value.
+.. option:: --network <network>
+
+ Create a NIC on the server and connect it to network.
+ Specify option multiple times to create multiple NICs.
+ For more options on NICs see --nic parameter.
+ network: attach NIC to this network
+
+.. option:: --port <port>
+
+ Create a NIC on the server and connect it to port.
+ Specify option multiple times to create multiple NICs.
+ For more options on NICs see --nic parameter.
+ port: attach NIC to this port
+
.. option:: --hint <key=value>
Hints for the scheduler (optional extension)
@@ -200,6 +216,16 @@ Create a new server
New server name
+..
+
+The parameters ``--network <network>`` and ``--port <port>`` are actually
+wrappers to ``--nic net-id=<network>`` and ``--nic port-id=<port>``. ``--nic``
+also provides additional options to specify an IP address, automatic network
+assignment and NICs which are not assigned to any port. This functionality
+is not part of ``--network`` and ``--port``, which aim to provide a simple
+syntax for the standard use cases of connecting a new server to a given
+network or port.
+
server delete
-------------