summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJenkins <jenkins@review.openstack.org>2017-06-19 14:28:13 +0000
committerGerrit Code Review <review@openstack.org>2017-06-19 14:28:13 +0000
commitbc4c91e7be8e4c52506a8f970078ecee6655ee82 (patch)
tree6526ddba3ff1fb00fc455325c4f3462345727657
parent3e02460e2ef1a9eeff3fb860a1ff8609a11616a9 (diff)
parent7d7cc942211f0523f970dd6c1268d1d778aed8a7 (diff)
Merge "Amend api-ref for multiple networks request"
-rw-r--r--api-ref/source/parameters.yaml18
1 files changed, 12 insertions, 6 deletions
diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index 11efb2c..a410233 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -3685,12 +3685,18 @@ networks:
3685 a network, specify the UUID of the network in the ``uuid`` attribute in a ``networks`` 3685 a network, specify the UUID of the network in the ``uuid`` attribute in a ``networks``
3686 object. To provision the server instance with a NIC for an already existing port, 3686 object. To provision the server instance with a NIC for an already existing port,
3687 specify the port-id in the ``port`` attribute in a ``networks`` object. 3687 specify the port-id in the ``port`` attribute in a ``networks`` object.
3688 3688
3689 In microversion 2.32, the ``tag`` is an optional string attribute that 3689 If multiple networks are defined, the order in which they appear in the
3690 can be used to assign a tag to a virtual network interface. This tag is 3690 guest operating system will not necessarily reflect the order in which they
3691 then exposed to the guest in the metadata API and the config drive and is 3691 are given in the server boot request. Guests should therefore not depend
3692 associated to hardware metadata for that network interface, such as bus 3692 on device order to deduce any information about their network devices.
3693 (ex: PCI), bus address (ex: 0000:00:02.0), and MAC address. 3693 Instead, device role tags should be used: introduced in 2.32, broken in
3694 2.37, and re-introduced and fixed in 2.42, the ``tag`` is an optional,
3695 string attribute that can be used to assign a tag to a virtual network
3696 interface. This tag is then exposed to the guest in the metadata API and
3697 the config drive and is associated to hardware metadata for that network
3698 interface, such as bus (ex: PCI), bus address (ex: 0000:00:02.0), and MAC
3699 address.
3694 3700
3695 A bug has caused the ``tag`` attribute to no longer be accepted starting 3701 A bug has caused the ``tag`` attribute to no longer be accepted starting
3696 with version 2.37. Therefore, network interfaces could only be tagged in 3702 with version 2.37. Therefore, network interfaces could only be tagged in