GET'>
PUT'>
POST'>
DELETE'>
'>
'>
]>
External Network Extension (<literal>external-net</literal>)
The external network extension is used to specify whether
the network is external or not. This information is used
by Layer-3 network (router) extension.
External networks are connected to a router's external
gateway and host floating IPs.
Concepts
The External Network extension adds the
router:external
attribute to the network resource.
Network Attributes
Attribute
Type
Required
CRUDC. Use the attribute in
create operations.R. This attribute is
returned in response to show and
list operations.U. You can update the
value of this attribute.D. You can delete the
value of this attribute.
Default Value
Validation Constraints
Notes
router:external
Bool
No
CRU
False
{ True | False }
Specifies whether the network is an external network or not.
Network API operations with external network extensionList Networks
Verb
URI
Description
&GET;
/networks
Returns a list of networks with their router:external
attributes.
Response codes are same as the normal operation of listing networks.
router:external attribute is visible
to all users by default policy setting.
Regular users are not authorized to create ports on external networks,
however they will be able to see this attribute in their network list.
This is because external networks can be used by any tenant to
set an external gateway for Neutron routers or create floating
IPs and associate them with ports on internal tenant networks.
List Networks with router:external attribute: JSON ResponseShow Network
Verb
URI
Description
&GET;
/networks/network_id
Returns details about a specific network, including external
networks attributes.
Response codes are same as the normal operation of listing networks.
router:external attribute is visible
to all users including non-admin by default policy setting.
Show network with external attributes: JSON ResponseCreate Network
Verb
URI
Description
&POST;
/networks
Creates a new network using the external network extension
attribute.
If the user submitting the request is not allowed to set this
attribute, a 403 Forbidden response will be returned.
Usage of this attribute might be restricted through authorization policies.
By the default policy only admin users can set this attribute.
Create Network with external attributes: JSON RequestUpdate Network
Verb
URI
Description
&PUT;
/networks/network_id
Updates a network, including the external
network extension attribute.
If the user submitting the request is not allowed to set this
attribute, a 403 Forbidden response will be returned.
Usage of this attribute might be restricted through authorization policies.
By the default policy only admin users can set this attribute.
Update external attributes for a network: JSON Request