openstack/neutron-lib
Code Issues Proposed changes

Document the new net-mtu-writable extension

Browse Source 
The extension was added in Pike. This patch is intended for backport.

Closes-Bug: #1710083
Change-Id: Ie747df83e62b3c1d433441ab0a7c00b6b54ce5d4
This commit is contained in:
Ihar Hrachyshka
2017-08-31 13:36:09 -07:00
parent b749812037
commit 24bdf4009b
6 changed files with 16 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
api-ref/source/v2/networks.inc
View File

@@ -50,13 +50,17 @@ a VLAN transparecy of the network. If the service does not support VLAN
transparency and a user requests a VLAN transparent network, transparency and a user requests a VLAN transparent network,
the plug-in refuses to create one and returns an appropriate error to the user. the plug-in refuses to create one and returns an appropriate error to the user.
MTU extension MTU extensions
============= ==============
The ``net-mtu`` extension allows plug-ins to expose the MTU that is guaranteed The ``net-mtu`` extension allows plug-ins to expose the MTU that is guaranteed
to pass through the data path of the segments in the network. This extension to pass through the data path of the segments in the network. This extension
introduces a read-only ``mtu`` attribute. introduces a read-only ``mtu`` attribute.
A newer ``net-mtu-writable`` extension enhances ``net-mtu`` in that now the
``mtu`` attribute is available for write (both when creating as well as
updating networks).
DNS integration DNS integration
=============== ===============
@@ -158,6 +162,7 @@ Request
- network: network - network: network
- admin_state_up: network-admin_state_up-request - admin_state_up: network-admin_state_up-request
- dns_domain: dns_domain-request - dns_domain: dns_domain-request
- mtu: mtu-request
- name: network-name-request - name: network-name-request
- port_security_enabled: network-port_security_enabled-request - port_security_enabled: network-port_security_enabled-request
- provider:network_type: provider:network_type - provider:network_type: provider:network_type
@@ -352,6 +357,7 @@ Request
- network: network - network: network
- admin_state_up: network-admin_state_up-request - admin_state_up: network-admin_state_up-request
- dns_domain: dns_domain-request - dns_domain: dns_domain-request
- mtu: mtu-request
- name: network-name-request - name: network-name-request
- port_security_enabled: network-port_security_enabled-request - port_security_enabled: network-port_security_enabled-request
- project_id: project_id-request - project_id: project_id-request
@@ -454,6 +460,7 @@ Request
- networks: networks - networks: networks
- admin_state_up: network-admin_state_up-request - admin_state_up: network-admin_state_up-request
- dns_domain: dns_domain-request - dns_domain: dns_domain-request
- mtu: mtu-request
- name: network-name-request - name: network-name-request
- port_security_enabled: network-port_security_enabled-request - port_security_enabled: network-port_security_enabled-request
- project_id: project_id-request - project_id: project_id-request

3
api-ref/source/v2/samples/networks/network-create-request.json
View File

@@ -3,6 +3,7 @@
"name": "sample_network", "name": "sample_network",
"admin_state_up": true, "admin_state_up": true,
"dns_domain": "my-domain.org.", "dns_domain": "my-domain.org.",
"qos_policy_id": "6a8454ade84346f59e8d40665f878b2e" "qos_policy_id": "6a8454ade84346f59e8d40665f878b2e",
"mtu": 1400
} }
} }

2
api-ref/source/v2/samples/networks/network-create-response.json
View File

@@ -8,7 +8,7 @@
"created_at": "2016-03-08T20:19:41", "created_at": "2016-03-08T20:19:41",
"dns_domain": "my-domain.org.", "dns_domain": "my-domain.org.",
"id": "4e8e5957-649f-477b-9e5b-f1f75b21c03c", "id": "4e8e5957-649f-477b-9e5b-f1f75b21c03c",
"mtu": 1500, "mtu": 1400,
"name": "net1", "name": "net1",
"port_security_enabled": true, "port_security_enabled": true,
"project_id": "9bacb3c5d39d41a79512987f338cf177", "project_id": "9bacb3c5d39d41a79512987f338cf177",

1
api-ref/source/v2/samples/networks/network-multi-create-response.json
View File

@@ -5,6 +5,7 @@
"name": "net1", "name": "net1",
"admin_state_up": true, "admin_state_up": true,
"dns_domain": "", "dns_domain": "",
"mtu": 1500,
"project_id": "9bacb3c5d39d41a79512987f338cf177", "project_id": "9bacb3c5d39d41a79512987f338cf177",
"tenant_id": "9bacb3c5d39d41a79512987f338cf177", "tenant_id": "9bacb3c5d39d41a79512987f338cf177",
"qos_policy_id": "6a8454ade84346f59e8d40665f878b2e", "qos_policy_id": "6a8454ade84346f59e8d40665f878b2e",

3
api-ref/source/v2/samples/networks/network-update-request.json
View File

@@ -2,6 +2,7 @@
"network": { "network": {
"dns_domain": "my-domain.org.", "dns_domain": "my-domain.org.",
"name": "sample_network_5_updated", "name": "sample_network_5_updated",
"qos_policy_id": "6a8454ade84346f59e8d40665f878b2e" "qos_policy_id": "6a8454ade84346f59e8d40665f878b2e",
"mtu": 1300
} }
} }

2
api-ref/source/v2/samples/networks/network-update-response.json
View File

@@ -8,7 +8,7 @@
"created_at": "2016-03-08T20:19:41", "created_at": "2016-03-08T20:19:41",
"dns_domain": "my-domain.org.", "dns_domain": "my-domain.org.",
"id": "1f370095-98f6-4079-be64-6d3d4a6adcc6", "id": "1f370095-98f6-4079-be64-6d3d4a6adcc6",
"mtu": 1500, "mtu": 1300,
"name": "sample_network_5_updated", "name": "sample_network_5_updated",
"port_security_enabled": true, "port_security_enabled": true,
"project_id": "4fd44f30292945e481c7b8a0c8908869", "project_id": "4fd44f30292945e481c7b8a0c8908869",