anchor.diff:  [width="100%",cols="23%,10%,11%,11%,45%",options="header",]
   |=======================================================================
   |Field Name |Type |POST/PUT |Required |Description
  -|uri |URI | | |A GET
  -against this URI refreshes the representation of this resource
  -
  -|id |UUID | | |A
  -unique identifier of the resource
  -
  -|adminStateUp |Bool |POST/PUT |No |The administrative state of the port.
  -If false (down), the port stops forwarding packets. If it is a router
  -port, it adittionally replies with a 'Communication administratively
  -prohibited' ICMP Default is true (up).
  -
  -|deviceId |UUID | |
  -|ID of the device (bridge or router) that this port belongs to
  -
  -|device |URI | | |A
  -GET against this URI retrieves the device resource that the port belongs
  -to. If the port is a router port, it gets a router resource, and if it’s
  -a bridge port, it gets a bridge resource
  -
  -|type |String |POST |Yes |
  -Type of device port.  It must be one of:
  -
  -* Router
  -
  -* Bridge
  +|uri |URI | |
  +|A GET against this URI refreshes the representation of this resource.
  +
  +|device |URI | |
  +|A GET against this URI retrieves the device resource to which this port
  +belongs. If the port is a bridge port, it returns a bridge resource. If it is
  +a router port, it returns a router resource.
  +
  +|host |URI | |
  +|A GET against this URI returns the host where the port is bound. The request
  +succeeds only if the port is an exterior port, bound to a host.
  +
  +|hostInterfacePort |URI | |
  +|A GET against this URI returns the interface-binding information for this port.
  +
  +|inboundFilter |URI | |
  +|A GET against this URI returns the inbound filter chain.
  +
  +|link |URI | |
  +|A POST against this URI links two interior ports. A DELETE against this URI
  +removes the link. The body of the request must contain a link resource. See
  +xref:port-link[].
  +
  +|outboundFilter |URI | |
  +|A GET against this URI returns the outbound filter chain.
  +
  +|peer |URI | |
  +|A GET against this URI returns the peer port. It requires a port to be
  +linked to another port.
  +
  +|portGroups |URI | |
  +|A GET against this URI returns the port groups of which this port is a
  +member.
  +
  +|id |UUID |POST |No
  +|A unique identifier of the resource. If this field is omitted in the POST
  +request, a random UUID is generated.
  +
  +|type |String |POST |Yes
  +|Type of port. It must be one of the following:
  +
  +* `Bridge`
  +* `Router`
   
   A new router or bridge port is unplugged. Depending on what it is later attached
  -to, it is referred to as an exterior or interior port.
  +to, it is referred to as an _exterior_ or _interior_ port.
   
   An exterior router port is a virtual port that plugs into the VIF of an entity,
   such as a VM. It can also be a virtual port connected to a host physical port,
   directly or after implementing tunnel encapsulation. Access to exterior ports is
   managed by OpenVSwitch (OpenFlow switch). Exterior bridge port is the same as
   exterior router port but it is a port on a virtual bridge. Upon being bound to
  -an interface, the port becomes exterior and will have the hostId, host, and
  -interfaceName fields be non-null. The peer and peerId fields will be null.
  +an interface, the port becomes exterior and will have the `hostId`, `host`, and
  +`interfaceName` fields be non-null. The `peer` and `peerId` fields will be null.
   
   An interior router port is a virtual port that only exists in the MidoNet
   virtual router network abstraction. It refers to a logical connection to another
   virtual networking device such as another router. An interior bridge port is the
   equivalent on a virtual bridge. Upon being linked to a peer, a port will become
  -interior and will have the peer and peerId fields be non-null. The hostId, host,
  -and interfaceName fields will be null.
  -
  -There is a third type of port, Vxlan, which is created automatically when
  +interior and will have the `peer` and `peerId` fields be non-null. The `hostId`,
  +`host`, and `interfaceName` fields will be null.
  +
  +There is a third type of port, `Vxlan`, which is created automatically when
   binding a VTEP to a Neutron network. The only operations supported on a port of
  -this type are GET and DELETE. Deleting a VXLAN port will delete all associated
  -VTEP bindings.
  -
  -|peerId |UUID | | |ID
  -of the peer port that this port is linked to. This will be set when
  -linking a port to another peer (becoming an interior port)
  -
  -|peer |URI | | |A GET
  -against this URI retrieves the peer port resource. Requires a port to be
  -linked to another port
  -
  -|networkAddress (Router only) |String |POST |Yes |IP address of the
  -network attached to this port. For example, `192.168.10.32`
  -
  -|networkLength (Router only) |Int |POST |Yes |Prefix length of the
  -network attached to this port (number of fixed network bits)
  -
  -|portAddress (Router only) |String |POST |Yes |IP address assigned to
  -the port
  -
  -|portMac (Router only) |String |POST | |Port
  -MAC address
  -
  -|vifId |UUID | | |ID
  -of the VIF plugged into the port
  -
  -|hostId |UUID | |No |ID of the port's host.
  -This will be set when binding a port to a host (becoming an exterior
  -port)
  -
  -|host |URI | | |The
  -port host's URI. Requires a port to be bound to a host
  -
  -|interfaceName |String |
  -| |Interface name of a bound port. This will be
  -set when binding a port to a host (becoming an exterior port)
  -
  -|bgps (Router only) |URI |
  -| |A GET against this URI retrieves BGP
  -configurations for this port
  -
  -|link |URI | |
  -|Location of the port link resource. A POST against this URI links two
  -interior ports. In the body of the request, 'peerId' must be specified
  -to indicate the peer interior port ID. A DELETE against this URI removes
  -the link
  -
  -|inboundFilterId |UUID |POST/PUT |No |ID of the filter chain to be
  -applied for incoming packets
  -
  -|inboundFilter |URI |
  -| |A GET against this URI retrieves the inbound
  -filter chain
  -
  -|outboundFilterId |UUID |POST/PUT |No |ID of the filter chain to be
  -applied for outgoing packets
  -
  -|outboundFilter |URI |
  -| |A GET against this URI retrieves the
  -outbound filter chain
  -
  -|portGroups |URI | |
  -|A GET against this URI retrieves the port groups that this port is a
  -member of
  -
  -|hostInterfacePort |URI |
  -| |A GET against this URI retrieves the
  -interface-binding information of this port
  -
  -|vlanId (Bridge only) |Short |POST |No |The VLAN ID assigned to this
  -port. On a given bridge, each VLAN ID can be present at most in one
  -interior port
  -
  -|bindings (Vxlan only) |URI |
  -| |A GET against this URI retrieves the list of
  -bindings between this port's bridge and its VTEP.
  -
  -|mgmtIpAddr (Vxlan only) |IP Address |
  -| |The management IP address of the VTEP whose
  -bindings this port contains
  -
  -|mgmtPort (Vxlan only) |Integer |
  -| |The TCP port used in combination with
  -mgmtIpAddr to manage the VTEP whose bindings this port contains
  -
  -|vni |Integer | | |The
  -VXLAN network identifier used by the VTEP to identify this port's
  -bridge.
  -|=======================================================================
  -
  -[[port---v1-deprecated]]
  -Port - v1, Deprecated
  -^^^^^^^^^^^^^^^^^^^^^
  -
  -_Media Type_: `[application/vnd.org.midonet.Port-v1+json]`
  -
  --------------------------------------
  -GET     /ports
  -GET     /ports/:portId
  -GET     /routers/:routerId/ports
  -GET     /routers/:routerId/peer_ports
  -GET     /bridges/:bridgeId/ports
  -GET     /bridges/:bridgeId/peer_ports
  -POST    /routers/:routerId/ports
  -POST    /bridges/:bridgeId/ports
  -PUT     /ports/:portId
  -DELETE  /ports/:portId
  --------------------------------------
  -
  -This port type has been deprecated. Please use the updated v2 Port api
  -described above.
  -
  -Port is an entity that represents a port on a virtual device (bridge or
  -router) in MidoNet. It contains the following fields:
  -
  -[width="100%",cols="25%,8%,11%,11%,45%",options="header",]
  -|=======================================================================
  -|Field Name |Type |POST/PUT |Required |Description
  -|uri |URI | | |A GET
  -against this URI refreshes the representation of this resource
  -
  -|id |UUID | | |A
  -unique identifier of the resource
  +this type are GET.
  +
  +|adminStateUp |Boolean |POST/PUT |No
  +|The administrative state of the port. If _false_ (down), the port stops
  +forwarding packets. If it is a router port, it additionally replies with a
  +_Communication administratively prohibited_ ICMP response. The default is
  +_true_ (up).
  +
  +|inboundFilterId |UUID |POST/PUT |No
  +|The identifier of the filter chain to be applied for ingress packets.
  +
  +|inboundMirrorIds |Array of UUID |POST/PUT |No
  +|The list of identifiers for the port mirrors to be applied for ingress packets.
  +
  +|insertionIds |Array of UUID |POST/PUT |No
  +|The list of identifiers for the service insertions to be applied to this port.
  +
  +|outboundFilterId |UUID |POST/PUT |No
  +|The identifier of the filter chain to be applied for egress packets.
  +
  +|outboundMirrorIds |Array of UUID |POST/PUT |No
  +|The list of identifiers for the port mirrors to be applied for egress packets.
   
   |deviceId |UUID | |
  -|ID of the device (bridge or router) that this port belongs to
  -
  -|device |URI | | |A
  -GET against this URI retrieves the device resource that the port belongs
  -to. If the port is a router port, it gets a router resource, and if it’s
  -a bridge port, it gets a bridge resource
  -
  -|type |String |POST |Yes |
  -Type of device port. It must be one of:
  -
  -* ExteriorRouter
  -
  -* InteriorRouter
  -
  -* ExteriorBridge
  -
  -* InteriorBridge
  -
  -Exterior router port is a virtual port that plugs into the VIF of an entity,
  -such as a VM. It can also be a virtual port connected to a host physical port,
  -directly or after implementing tunnel encapsulation. Access to exterior ports is
  -managed by OpenVSwitch (OpenFlow switch). Exterior bridge port is the same as
  -exterior router port but it is a port on a virtual bridge.
  -
  -Interior router port is a virtual port that only exists in the MidoNet virtual
  -router network abstraction. It refers to a logical connection to another virtual
  -networking device such as another router. Interior bridge is the equivalent port
  -type on a virtual bridge.
  -
  -|peerId (Interior) |UUID |
  -| |ID of the peer port that this port is linked
  -to
  -
  -|peer (Interior) |URI |
  -| |A GET against this URI retrieves the peer
  -port resource
  -
  -|networkAddress (Router only) |String |POST |Yes |IP address of the
  -network attached to this port. For example `192.168.10.32/27`
  -
  -|networkLength (Router only) |Int |POST |Yes |Prefix length of the
  -network attached to this port (number of fixed network bits)
  -
  -|portAddress (Router only) |String |POST |Yes |IP address assigned to
  -the port
  -
  -|vifId (Exterior and Trunk only) |UUID |
  -| |ID of the VIF plugged into the port
  -
  -|bgps (Exterior router only) |URI |
  -| |A GET against this BGP configurations for
  -this port.
  -
  -|link (Interior only) |URI |
  -| |Location of the port link resource. A POST
  -against this URI links two interior ports. In the body of the request,
  -'peerId' must be specified to indicate the peer interior port ID. A
  -DELETE against this URI removes the link
  -
  -|inboundFilterId |UUID |POST/PUT |No |ID of the filter chain to be
  -applied for incoming packets
  -
  -|inboundFilter |URI |
  -| |A GET against this URI retrieves the inbound
  -filter chain
  -
  -|outboundFilterId |UUID |POST/PUT |No |ID of the filter chain to be
  -applied for outgoing packets
  -
  -|outboundFilter |URI |
  -| |A GET against this URI retrieves the
  -outbound filter chain
  -
  -|portGroups |URI | |
  -|A GET against this URI retrieves the port groups that this port is a
  -member of
  -
  -|hostInterfacePort |URI |
  -| |A GET against this URI retrieves the
  -interface-binding information of this port
  -
  -|vlanId (Interior Bridge only) |Short |POST |No |The VLAN ID assigned to
  -this port. On a given bridge, each VLAN ID can be present at most in one
  -interior port
  -|=======================================================================
  -
  -[[port-link]]
  -Port Link
  -^^^^^^^^^
  -
  -_Media Type_: `[application/vnd.org.midonet.PortLink-v1+json]`
  -
  -----------------------------
  -POST     /ports/:portId/link
  -DELETE   /ports/:portId/link
  -----------------------------
  -
  -Represents a link between two interior ports. Links are possible
  -between:
  -
  -* Two router ports.
  -* A router port and a bridge port
  -* A router port and a bridge
  -* A bridge port and a bridge port
  -* Two Bridges, as long as just one of the two peers has a VLAN ID
  -assigned. The Bridge owning this port will act as a VLAN-Aware Bridge,
  -PUSH'ing and POP'ing VLAN IDs as frames traverse this port.
  -
  -It contains the following fields:
  -
  -[width="100%",cols="16%,7%,11%,11%,55%",options="header",]
  -|=======================================================================
  -|Field Name |Type |POST/PUT |Required |Description
  -|uri |URI | | |A GET
  -against this URI refreshes the representation of this resource
  -
  -|portId |UUID | | |A
  -unique identifier of the port
  -
  -|port |URI | | |A GET
  -against this URI retrieves the port
  -
  -|peerId |UUID |POST |yes |A unique identifier of the peer port
  -
  -|peer |URI | | |A GET
  -against this URI retrieves the peer port
  -|=======================================================================
  -
  -[[route]]
  -Route
  -^^^^^
  -
  -_Media Type_: `[application/vnd.org.midonet.Route-v1+json]`
  -
  -------------------------------------------
  -GET     /routes/:routeId
  -GET     /routers/:routerId/routes
  -POST    /routers/:routerId/routes
  -PUT     /routers/:routerId/routes/:routeId
  -DELETE  /routers/:routerId/routes/:routeId
  -------------------------------------------
  -
  -Route is an entity that represents a route on a virtual router in
  -MidoNet. It contains the following fields:
  -
  -[width="100%",cols="24%,8%,11%,11%,46%",options="header",]
  -|=======================================================================
  -|Field Name |Type |POST/PUT |Required |Description
  -|uri |URI | | |A GET
  -against this URI refreshes the representation of this resource
  -
  -|id |UUID | | |A
  -unique identifier of the resource
  -
  -|routerId |UUID | |
  -|ID of the router that this route belongs to
  -
  -|router |URI | | |A
  -GET against this URI gets the router resource
  -
  -|type |String |POST |Yes |
  -
  -|srcNetworkAddr |String |POST |Yes |Source IP address
  -
  -|srcNetworkLength |Int |POST |Yes |Source network IP address length
  -
  -|dstNetworkAddr |String |POST |Yes |Destination IP address
  -
  -|dstNetworkLength |Int |POST |Yes |Destination network IP address length
  -
  -|weight |Int |POST |Yes |The priority weight of the route. Lower weights
  -take precedence over higher weights
  -
  -|nextHopPort (Normal type only) |UUID |POST |Yes |The ID of the next hop
  -port
  -
  -|nextHopGateway (Normal type only) |String |POST |Yes |IP address of the
  -gateway router to forward the traffic to
  -|=======================================================================
  -
  -[[pool]]
  -Pool
  -^^^^
  -
  -_Media Type_: `[application/vnd.org.midonet.Pool-v1+json]`
  -
  ----------------------------------------------
  -GET     /load_balancers/:loadBalancerId/pools
  -POST    /load_balancers/:loadBalancerId/pools
  -GET     /pools/:poolId
  -PUT     /pools/:poolId
  -DELETE  /pools/:poolId
  ----------------------------------------------
  -
  -A Pool is an entity that represents a group of backend load balancer
  -addresses in MidoNet. It contains the following fields:
  -
  -[width="100%",cols="24%,8%,11%,11%,46%",options="header",]
  -|=======================================================================
  -|Field Name |Type |POST/PUT |Required |Description
  -|uri |URI | | |A GET
  -against this URI refreshes the representation of this resource.
  -
  -|id |UUID |POST |No |A unique identifier of the resource. If this field
  -is omitted in the POST request, a random UUID is generated.
  -
  -|loadBalancerId |UUID |POST |Yes |Load balancer object to which it is
  -associated with.
  -
  -|loadBalancer |URI | |
  -|A GET against this URI gets the load balancer object.
  -
  -|protocol |String |POST |No |The read-only value represents the protocol
  -used in the load balancing. Only `"TCP"` is supported.
  -
  -|lbMethod |String |POST |Yes |Load balancing algorithm. Only
  -“ROUND_ROBIN” is supported.
  -
  -|healthMonitorId |UUID |POST |No |ID of the health monitor object to
  -assign to the pool.
  -
  -|healthMonitor |URI |
  -| |A GET against this URI gets the health
  -monitor object.
  -
  -|poolMembers |URI | |
  -|A GET against this URI gets the list of URLs for the member objects.
  -
  -|adminStateUp |Bool |POST/PUT |No |Administrative state of the object.
  -
  -|vips |URI | | |A GET
  -against this URI gets the list of VIPs associated with the pool.
  -|=======================================================================
  -
  -[[poolmember]]
  -PoolMember
  -^^^^^^^^^^
  -
  -_Media Type_: `[application/vnd.org.midonet.PoolMember-v1+json]`
  -
  --------------------------------------------------------------------
  -GET      /load_balancers/:loadBalancerId/pools/:poolId/pool_members
  -POST     /load_balancers/:loadBalancerId/pools/:poolId/pool_members
  -GET      /pool_members/:poolMemberId
  -PUT      /pool_members/:poolMemberId
  -DELETE   /pool_members/:poolMemberId
  --------------------------------------------------------------------
  -
  -A PoolMember is an entity that represents a backend load balancer
  -address in MidoNet. It contains the following fields:
  -
  -[width="100%",cols="24%,8%,11%,11%,46%",options="header",]
  -|=======================================================================
  -|Field Name |Type |POST/PUT |Required |Description
  -|uri |URI | | |A GET
  -against this URI refreshes the representation of this resource.
  -
  -|id |UUID |POST |No |A unique identifier of the resource. If this field
  -is omitted in the POST request, a random UUID is generated.
  -
  -|poolId |UUID |POST |Yes |ID of the pool.
  -
  -|pool |URI | | |A GET
  -against this URI retrieves the Pool.
  -
  -|address |String |POST/PUT |Yes |IP address of the member.
  -
  -|protocolPort |Int |POST/PUT |Yes |Protocol port of the member.
  -
  -|weight |Int |POST/PUT |No |Weight used for random algorithm. Defaults
  -to `1`.
  -
  -|adminStateUp |Bool |POST/PUT |No |Administrative state of the object.
  -
  -|status |String | |
  -|The status of the object. Values are: UP, DOWN
  -|=======================================================================
  +|The identifier of the device (bridge or router) to which this port belongs.
  +
  +|interfaceName |String | |
  +|The interface name for a bound port. This will be set when binding a port to a
  +host, becoming an exterior port. See
  +xref:host-interface-port[].
  +
  +|hostId |UUID | |No
  +|The identifier of the host where this port is bound. This will be set when
  +binding a port to a host, becoming an exterior port.
  +
  +|peerId |UUID | |
  +|The identifier of the peer port to which this port is linked. This will be set
  +when linking a port to another peer, becoming an interior port. See
  +xref:port-link[].
  +
  +|tunnelKey |Integer | |
  +|The port tunnel key.
  +
  +|vifId |UUID | |
  +|The identifier of the VIF plugged into the port.
  +|=======================================================================
  +
  +The ports of type `Bridge` include the following additional fields:
  +
  +[width="100%",cols="23%,10%,11%,11%,45%",options="header",]
  +|=======================================================================
  +|Field Name |Type |POST/PUT |Required |Description
  +|vlanId |Integer |POST/PUT |No
  +|The VLAN identifier assigned to this port. On a given bridge, the VLAN
  +identifier can be present at most in one interior port.
  +|=======================================================================
  +
  +The ports of type `Router` include the following additional fields:
  +
  +[width="100%",cols="23%,10%,11%,11%,45%",options="header",]
  +|=======================================================================
  +|Field Name |Type |POST/PUT |Required |Description
  +|networkAddress |String |POST/PUT |Yes
  +|The IP address of the network attached to this port.
  +
  +|networkLength |Integer |POST/PUT |Yes
  +|The network prefix length of the network attached to this port. The value must
  +belong to the interval [0, 32].
  +
  +|portAddress |String |POST/PUT |Yes
  +|The IP address assigned to the port.
  +
  +|portMac |String |POST/PUT |No
  +|The port physical (MAC) address.
  +
  +|bgpStatus |String | |
  +|If the port is used to advertise routes to one or more BGP neighbors,
  +this field includes the status of the BGP sessions.
  +|=======================================================================
  +
  +The ports of type `Vxlan` include the following additional fields:
  +
  +[width="100%",cols="23%,10%,11%,11%,45%",options="header",]
  +|=======================================================================
  +|Field Name |Type |POST/PUT |Required |Description
  +|vtepId |UUID | |
  +|The identifier of the VTEP corresponding to this port.
  +|=======================================================================
  +
   
   [[port-group]]
  -Port Group
  -^^^^^^^^^^
  -
  -_Media Type_: `[application/vnd.org.midonet.PortGroup-v1+json]`
  +=== Port Group
  +
  +_Media Type_:::
  +  `[application/vnd.org.midonet.PortGroup-v1+json]`
  +_Collection Media Type_:::
  +  `[application/vnd.org.midonet.collection.PortGroup-v1+json]`
   
   ----------------------------------------
   GET     /port_groups
  
positive.code: 
  _application/vnd.org.midonet.xxxxx-v#+json_
  
  where “xxxxx“ represents the unique resource identifier and "#" is the
  media type's version number. For most media types the version number
  will be 1, but several media types have additional versions. See the
  sections on individual media types for available versions. Old versions
  are provided for backwards compatibility; in general you should use the
  newest version available.
  
  When doing a GET on a particular resource, specify the media type in the
  Accept header field. When doing a POST or PUT on a particular resource,
  specify the media type in the Content-Type header field. This also
  applies when you are operating on collections as well.
  
  [[request-headers]]
  Request Headers
  ^^^^^^^^^^^^^^^
  
  The following HTTP request headers are relevant to MidoNet REST API:
  
  
negative.code: [width="100%",cols="24%,8%,11%,11%,46%",options="header",]
  |=======================================================================
  |Field Name |Type |POST/PUT |Required |Description
  |uri |URI | |
  |A GET against this URI refreshes the representation of this resource.
  
  |arpTable |URI | |
  |A GET against this URI returns the ARP table for this bridge. See
  xref:ip4macpair[].
  
  |dhcpSubnets |URI | |
  |A GET against this URI returns the DHCP subnets for this bridge. See
  xref:dhcp-subnet[].
  
  |dhcpSubnets6 |URI | |
  |A GET against this URI returns the DHCPv6 subnets for this bridge. See
  xref:dhcp6-subnet[].
  
  |inboundFilter |URI | |
  |A GET against this URI returns the inbound filter chain.
  
  |macTable |URI | |
  |A GET against this URI returns the MAC table for this bridge. See
  xref:mac-port[].
  
  |outboundFilter |URI | |
  |A GET against this URI returns the outbound filter chain.
  
  |ports |URI | |
  |A GET against this URI returns the ports for this bridge. See
  xref:port[].
  
  |peerPorts |URI | |
  |A GET against this URI returns the interior ports connected to this
  bridge.
  
  |vxLanPorts |URI | |
  |A GET against this URI returns the VXLAN ports for this bridge.
  
  |macPortTemplate |String | |
  |Template of the URI that represents the location of the MAC-port entry in the
  MAC table for this bridge.
  
  |vlanMacPortTemplate |String | |
  |Template of the URI that represents the location of the MAC-port entry for a
  specific VLAN in the MAC table of this bridge.
  
  |vlanMacTableTemplate |String | |
  |Template of the URI that represents the location of the MAC table for a
  specific VLAN of this bridge. See
  xref:mac-port[].
  
  |id |UUID |POST |No
  |A unique identifier of the resource. If this field is omitted in the POST
  request, a random UUID is generated.
  
  |adminStateUp |Boolean |POST/PUT |No
  |The administrative state of the bridge, and if _false_ (down), the bridge stops
  forwarding packets. The default is _true_ (up).
  
  |inboundFilterId |UUID |POST/PUT |No
  |The identifier of the filter chain to be applied for ingress packets.
  
  |inboundMirrorIds |Array of UUID |POST/PUT |No
  |The list of IDs for the mirrors applied to ingress packets.
  
  |name |String |POST/PUT |No
  |The name of the bridge. The maximum length is 255 characters.
  
  |outboundFilterId |UUID |POST/PUT |No
  |The identifier of the filter chain to be applied for egress packets.
  
  |outboundMirrorIds |Array of UUID |POST/PUT |No
  |The list of IDs for the mirrors applied to egress packets.
  
  |tenantId |String |POST/PUT |No
  |The identifier of the tenant that owns the bridge.
  
  |vxlanPortIds |Array of UUID | |
  |The list of IDs for the bridge VXLAN ports, which contains the bindings from
  this bridge to hardware VTEPs. It is read-only.
  |=======================================================================
  
  [[bridge-query-parameters]]
  ==== Query Parameters
  
  [width="73%",cols="19%,81%",options="header",]
  |=============================================================
  |Name |Description
  |tenant_id |The identifier of the tenant to filter the search.
  |=============================================================
  
  
  [[chain]]
  === Chain
  
  _Media Type_:::
    `[application/vnd.org.midonet.Chain-v1+json]`
  _Collection Media Type_:::
    `[application/vnd.org.midonet.collection.Chain-v1+json]`
  
  -----------------------------------
  GET     /chains
  GET     /chains?tenant_id=:tenantId
  GET     /chains/:chainId
  POST    /chains
  DELETE  /chains/:chainId
  -----------------------------------
  
  Chain is an entity that represents a rule chain on a virtual router in
  MidoNet. It contains the following fields:
  
  [width="100%",cols="16%,8%,11%,11%,54%",]
  |=======================================================================
  |Field Name |Type |POST/PUT |Required |Description
  
  |uri |URI | |
  |A GET against this URI refreshes the representation of this resource.
  
  |rules |URI | |
  |A GET against this URI returns the rules belonging to this chain.
  
  |id |UUID |POST |No
  |A unique identifier of the resource. If this field is omitted in the POST
  request, a random UUID is generated.
  
  |name |String |POST |No
  |The name of the chain. The maximum length is 255 characters.
  
  |tenantId |String |POST |No
  |The identifier of the tenant that owns the chain.
  |=======================================================================
  
  [[chain-query-parameters]]
  ==== Query Parameters
  
  [width="73%",cols="19%,81%",options="header",]
  |=============================================================
  |Name |Description
  |tenant_id |The identifier of the tenant to filter the search.
  |=============================================================
  
  
  [[dhcp-host]]
  === DHCP Host
  
  _Media Type_:::
    `[application/vnd.org.midonet.DhcpHost-v2+json]`
  _Collection Media Type_:::
    `[application/vnd.org.midonet.collection.DhcpHost-v2+json]`
  
  --------------------------------------------------------------
  GET     /bridges/:bridgeId/dhcp/:subnetAddr/hosts
  GET     /bridges/:bridgeId/dhcp/:subnetAddr/hosts/:mac_address
  POST    /bridges/:bridgeId/dhcp/:subnetAddr/hosts
  PUT     /bridges/:bridgeId/dhcp/:subnetAddr/hosts/:mac_address
  DELETE  /bridges/:bridgeId/dhcp/:subnetAddr/hosts/:mac_address
  --------------------------------------------------------------
  
  [width="100%",cols="21%,16%,11%,11%,41%",options="header",]
  |=======================================================================
  |Field Name |Type |POST/PUT |Required |Description
  |uri |URI | |
  |A GET against this URI refreshes the representation of this source.
  
  |ipAddr |String |POST/PUT |Yes
  |The IPv4 address of the host.
  
  |macAddr |String |POST/PUT |Yes
  |The MAC Address of the host.
  
  |name |String |POST/PUT |Yes
  |The name of the host.
  
  |extraDhcpOpts |Array of (String, String) |POST/PUT |No
  |List of DHCP options where an option is composed of two key-value
  pairs with the key fields, `optName` and `optValue`.
   +
   +
  For "optName", use the DHCP option code listed here: +
  http://www.iana.org/assignments/bootp-dhcp-parameters/bootp-dhcp-parameters.xhtml#options +
   +
  For example, to set the interface MTU:
  `[{"optName": "26", "optValue": "9000"}]`
  |=======================================================================
  
  
  [[dhcp-subnet]]
  === DHCP Subnet
  
  _Media Type_:::
    `[application/vnd.org.midonet.DhcpSubnet-v2+json]`
  _Collection Media Type_:::
    `[application/vnd.org.midonet.collection.DhcpSubnet-v2+json]`
  
  -------------------------------------------
  GET     /bridges/:bridgeId/dhcp
  GET     /bridges/:bridgeId/dhcp/:subnetAddr
  POST    /bridges/:bridgeId/dhcp
  PUT     /bridges/:bridgeId/dhcp/:subnetAddr
  DELETE  /bridges/:bridgeId/dhcp/:subnetAddr
  -------------------------------------------
  
  [width="100%",cols="21%,16%,11%,11%,41%",options="header",]
  |=======================================================================
  |Field Name |Type |POST/PUT |Required |Description
  |uri |URI | |
  |A GET against this URI refreshes the representation of this source.
  
  |hosts |URI | |
  |A GET against this URI returns the DHCP hosts for this subnet.
  
  |subnetPrefix |String |POST/PUT |Yes
  |The IPv4 subnet prefix address.
  
  |subnetLength |Integer |POST/PUT |Yes
  |The IPv4 subnet prefix length. The value must belong to the interval [0, 32].
  
  |defaultGateway |String |POST/PUT |No
  |The IPv4 address of the default gateway.
  
  |dnsServerAddrs |Array of String |POST/PUT |No
  |The list of DNS server IPv4 addresses.
  
  |enabled |Boolean |POST/PUT |No |Indicates whether the DHCP service is
  enabled. The default value is true.
  
  |interfaceMTU |Integer |POST/PUT |No
  |The interface Maximum Transmission Unit. The value must belong to the
  interval [0, 65536].
  
  |opt121Routes |Array of (String, Integer, String) |POST/PUT |No
  |The list of DHCP option 121 routes, each of which consists of the following
  fields: `destinationPrefix` as an IPv4 subnet address; `destinationLength` as
  an IPv4 subnet prefix length; and `gatewayAddr` as the gateway IPv4 address.
  
  |serverAddr |String |POST/PUT |No
  |The IPv4 address of the DHCP server.
  |=======================================================================
  
  
  [[dhcp6-host]]
  === DHCPv6 Host
  
  _Media Type_:::
    `[application/vnd.org.midonet.DhcpV6Host-v1+json]`
  _Collection Media Type_:::
    `[application/vnd.org.midonet.collection.DhcpV6Host-v1+json]`
  
  ----------------------------------------------------------------
  GET     /bridges/:bridgeId/dhcpV6/:subnetAddr/hosts
  GET     /bridges/:bridgeId/dhcpV6/:subnetAddr/hosts/:mac_address
  POST    /bridges/:bridgeId/dhcpV6/:subnetAddr/hosts
  PUT     /bridges/:bridgeId/dhcpV6/:subnetAddr/hosts/:mac_address
  DELETE  /bridges/:bridgeId/dhcpV6/:subnetAddr/hosts/:mac_address
  ----------------------------------------------------------------
  
  [width="100%",cols="21%,16%,11%,11%,41%",options="header",]
  |=======================================================================
  |Field Name |Type |POST/PUT |Required |Description
  |uri |URI | |
  |A GET against this URI refreshes the representation of this source.
  
  |clientId |String |POST/PUT |Yes
  |The client identifier.
  
  |fixedAddress |String |POST/PUT |Yes
  |The IPv6 address assigned to the specified client.
  
  |name |String |POST/PUT |Yes
  |The name of the host.
  |=======================================================================
  
  
  [[dhcp6-subnet]]
  === DHCPv6 Subnet
  
  _Media Type_:::
    `[application/vnd.org.midonet.DhcpV6Subnet-v1+json]`
  _Collection Media Type_:::
    `[application/vnd.org.midonet.collection.DhcpV6Subnet-v1+json]`
  
  ---------------------------------------------
  GET     /bridges/:bridgeId/dhcpV6
  GET     /bridges/:bridgeId/dhcpV6/:subnetAddr
  POST    /bridges/:bridgeId/dhcpV6
  PUT     /bridges/:bridgeId/dhcpV6/:subnetAddr
  DELETE  /bridges/:bridgeId/dhcpV6/:subnetAddr
  ---------------------------------------------
  
  [width="100%",cols="21%,16%,11%,11%,41%",options="header",]
  |=======================================================================
  |Field Name |Type |POST/PUT |Required |Description
  |uri |URI | |
  |A GET against this URI refreshes the representation of this source.
  
  |hosts |URI | |
  |A GET against this URI returns the DHCP hosts for this subnet.
  
  |prefix |String |POST/PUT |Yes
  |The IPv6 subnet prefix.
  
  |prefixLength |Integer |POST/PUT |Yes
  |The IPv6 subnet prefix length. The value must belong to the interval [0, 128].
  |=======================================================================
  
  
  [[health-monitor]]
  === Health Monitor
  
  _Media Type_:::
    `[application/vnd.org.midonet.HealthMonitor-v1+json]`
  _Collection Media Type_:::
    `[application/vnd.org.midonet.collection.HealthMonitor-v1+json]`
  
  ------------------------------------------
  GET      /health_monitors
  GET      /health_monitors/:healthMonitorId
  POST     /health_monitors
  PUT      /health_monitors/:healthMonitorId
  DELETE   /health_monitors/:healthMonitorId
  ------------------------------------------
  
  [NOTE]
  To use this feature, please make sure that health monitoring is activated in the
  MidoNet Agent configuration. See _HAProxy configuration_ in the Operation
  Guide for details.
  
  A HealthMonitor is an entity that represents a virtual health monitor
  device for use with load balancers in MidoNet. It contains the following
  fields:
  
  [width="100%",cols="24%,8%,11%,11%,46%",options="header",]
  |=======================================================================
  |Field Name |Type |POST/PUT |Required |Description
  |uri |URI | |
  |A GET against this URI refreshes the representation of this resource.
  
  |pools |URI | |
  |A GET against this URI returns the pools monitored by this healh monitor.
  
  |id |UUID |POST |No
  |A unique identifier of the resource. If this field is omitted in the POST
  request, a random UUID is generated.
  
  |type |String |POST/PUT |Yes
  |The type of the health monitor checking protocol. The following type is
  supported: `TCP`.
  
  |adminStateUp |Boolean |POST/PUT |No
  |The administrative state of the health monitor. The default is true (up).
  
  |delay |Integer |POST/PUT |No
  |The delay for the health check interval in seconds. The default is zero.
  
  |maxRetries |Integer |POST/PUT |No
  |The number of times to retry for health check. The defaults is zero.
  
  |timeout |Integer |POST/PUT |No
  |The timeout value for the health check in seconds. The defaults is zero.
  |=======================================================================
  
  
  [[host]]
  === Host
  
  _Media Type_:::
    `[application/vnd.org.midonet.Host-v3+json]`
  _Collection Media Type_:::
    `[application/vnd.org.midonet.collection.Host-v3+json]`
  
  ----------------------
  GET     /hosts
  GET     /hosts/:hostId
  PUT     /hosts/:hostId
  DELETE  /hosts/:hostId
  ----------------------
  
  Host is an entity that provides some information about a MidoNet Agent node.
  It contains the following fields:
  
  [width="100%",cols="28%,13%,11%,11%,37%",options="header",]
  |=======================================================================
  |Field Name |Type |POST/PUT |Required |Description
  |uri |URI | |
  |A GET against this URI refreshes the representation of this resource.
  
  |interfaces |URI | |
  |A GET against this URI returns the interfaces of this host.
  
  |ports |URI | |
  |A GET against this URI returns the virtual ports bound to the interfaces
  of this host.
  
  |id |UUID | |
  |A unique identifier of the resource. It is generated by the MidoNet Agent
  running on the host.
  
  |alive |Boolean | |
  |Returns true if the MidoNet Agent is running on the physical host.
  
  |name |String | |
  |The host name.
  
  |addresses |Array of String | |
  |The list of IP addresses assigned to the interfaces of this host.
  
  |hostInterfaces |Array of Interface | |
  |The list of interfaces belonging to this host. See
  xref:interface[].
  
  |floodingProxyWeight |Integer |PUT |No
  |The weight assigned to the host for becoming a flooding proxy for a L2 VXLAN
  gateway. For more information see the _L2 VXLAN Gateway_ in the Operation
  Guide. The value must belong to the interval [0, 65535].
  |=======================================================================
  
  
  [[host-interface-port]]
  === Host Interface Port
  
  _Media Type_:::
    `[application/vnd.org.midonet.HostInterfacePort-v1+json]`
  
  ------------------------------------
  GET     /hosts/:hostId/ports
  GET     /hosts/:hostId/ports/:portId
  POST    /hosts/:hostId/ports
  DELETE  /hosts/:hostId/ports/:portId
  ------------------------------------
  
  The `HostInterfacePort` binding allows mapping a virtual network port to
  an interface (virtual or physical) of a physical host where the MidoNet
  Agent is running. It contains the following fields:
  
  [width="100%",cols="20%,8%,11%,11%,50%",options="header",]
  |=======================================================================
  |Field Name |Type |POST/PUT |Required |Description
  |uri |URI | |
  |A GET against this URI refreshes the representation of this resource.
  
  |host |URI | |
  |A GET against this URI returns the host corresponding to this binding.
  
  |port |URI | |
  |A GET against this URI returns the virtual port corresponding to this binding.
  
  |hostId |UUID |POST |Yes
  |The identifier of the physical host.
  
  |interfaceName |String |POST |Yes
  |The name of the interface that is mapped to the virtual port.
  
  |portId |UUID |POST |Yes
  |The identifier of the virtual port mapped to the host interface.
  |=======================================================================
  
  
  [[interface]]
  === Interface
  
  _Media Type_:::
    `[application/vnd.org.midonet.Interface-v1+json]`
  _Collection Media Type_:::
    `[application/vnd.org.midonet.collection.Interface-v1+json]`
  
  ------------------------------------------------
  GET     /hosts/:hostId/interfaces
  GET     /hosts/:hostId/interfaces/:interfaceName
  ------------------------------------------------
  
  The interface is an entity abstracting information about a physical
  interface associated with a host.
  
  [width="100%",cols="16%,17%,11%,11%,45%",options="header",]
  |=======================================================================
  |Field Name |Type |POST/PUT |Required |Description
  |uri |URI | |
  |A GET against this URI refreshes the representation of this resource.
  
  |addresses |Array of String | |
  |The list of IP addresses bound to this interface.
  
  |addresses |Array of String | |
  |The list of IP addresses bound to this interface.
  
  |hostId |UUID | |
  |The identifier of the host that owns this interface.
  
  |mac |String | |
  |The interface physical address (MAC).
  
  |mtu |Integer | |
  |The interface maximum transmission unit (MTU) value.
  
  |name |String | |
  |The physical interface name.
  
  |portType |String | |
  |The datapath port type. It can be one of the following: `NetDev`, `Internal`,
  `Gre`, `VXLan`, `Gre64`, `Lisp`
  
  |status |Integer | |
  |A bitmask representing the status flags. Currently it provides information
  about _UP_ (0x1) status and _CARRIER_ (0x2) status.
  
  |type |String | |
  |The interface type. It can be one of the following: `Unknown`, `Physical`,
  `Virtual`, `Tunnel`.
  |=======================================================================
  
  
  [[ip4macpair]]
  === IPv4-MAC Pair
  
  _Media Type_:::
    `[application/vnd.org.midonet.IP4Mac-v1+json]`
  _Collection Media Type_:::
    `[application/vnd.org.midonet.collection.IP4Mac-v1+json]`
  
  ------------------------------------------------
  GET     /bridges/:bridgeId/arp_table
  GET     /bridges/:bridgeId/arp_table/:ip4MacPair
  POST    /bridges/:bridgeId/arp_table
  DELETE  /bridges/:bridgeId/arp_table/:ip4MacPair
  ------------------------------------------------
  
  [width="100%",cols="16%,8%,12%,11%,53%",options="header",]
  |=======================================================================
  |Field Name |Type |POST/PUT |Required |Description
  |uri |URI | |
  |A GET against this URI refreshes the representation of this resource.
  
  |ip |String |POST |Yes
  |The IP version 4 address.
  
  |mac |String |POST |Yes
  |The MAC address. If ARP replies are enabled on the bridge, the IP
  will resolve to this MAC.
  |=======================================================================
  
  
  [[ip-address-group]]
  === IP Address Group
  
  _Media Type_:::
    `[application/vnd.org.midonet.IpAddrGroup-v1+json]`
  _Collection Media Type_:::
    `[application/vnd.org.midonet.collection.IpAddrGroup-v1+json]`
  
  --------------------------------------
  GET     /ip_addr_groups
  GET     /ip_addr_groups/:ipAddrGroupId
  POST    /ip_addr_groups
  DELETE  /ip_addr_groups/:ipAddrGroupId
  --------------------------------------
  
  IP address group is a group of IP addresss. Currently only IPv4 is
  supported. An IP address group can be specified in the chain rule to
  filter the traffic coming from all the addresses belonging to that the
  specified group.
  
  [width="100%",cols="16%,8%,11%,11%,54%",options="header",]
  |=======================================================================
  |Field Name |Type |POST/PUT |Required |Description
  |uri |URI | |
  |A GET against this URI refreshes the representation of this resource.
  
  |addrs |URI | |
  |A GET against this URI returns the members of this address group.
  
  |id |UUID |POST |No
  |A unique identifier of the resource. If this field is omitted in the POST
  request, a random UUID is generated.
  
  |name |String |POST |Yes
  |The name of the address group. The name length must be between 1 and 255
  characters.
  |=======================================================================
  
  
  [[ip-address-group-address]]
  === IP Address Group Address
  
  _Media Type_:::
    `[application/vnd.org.midonet.IpAddrGroupAddr-v1+json]`
  _Collection Media Type_:::
    `[application/vnd.org.midonet.collection.IpAddrGroupAddr-v1+json]`
  
  --------------------------------------------------------------------------
  GET     /ip_addr_groups/:ipAddrGroupId/ip_addrs
  GET     /ip_addr_groups/:ipAddrGroupId/versions/:version/ip_addrs/:ip_addr
  POST    /ip_addr_groups/:ipAddrGroupId/ip_addrs
  DELETE  /ip_addr_groups/:ipAddrGroupId/versions/:version/ip_addrs/:ip_addr
  --------------------------------------------------------------------------
  
  IP address group address represents the membership of an IP address in an IP
  address group.
  
  [width="100%",cols="20%,8%,11%,11%,50%",options="header",]
  |=======================================================================
  |Field Name |Type |POST/PUT |Required |Description
  |uri |URI | |
  |A GET against this URI refreshes the representation of this resource.
  
  |ipAddrGroup |URI | |
  |A GET against this URI returns the IP address group.
  
  |addr |String |POST |Yes
  |The IPv4 or IPv6 address.
  
  |ipAddrGroupId |UUID |POST |Yes
  |The identifier of the IP address group of which this IP address is a member.
  
  |version |Integer | |
  |The IP address version. The value is 4 or 6.
  |=======================================================================
  
  
  [[l2insertion]]
  === L2 Insertion
  
  _Media Type_:::
    `[application/vnd.org.midonet.L2Insertion-v1+json]`
  _Collection Media Type_:::
    `[application/vnd.org.midonet.collection.L2Insertion-v1+json]`
  
  ------------------------------------
  GET     /l2insertions
  GET     /l2insertions/:l2insertionId
  POST    /l2insertions
  PUT     /l2insertions/:l2insertionId
  DELETE  /l2insertions/:l2insertionId
  ------------------------------------
  
  L2 insertion represents a service insertion redirecting the packets to a
  specified service port. It contains the following fields:
  
  [width="100%",cols="20%,8%,11%,11%,50%",options="header",]
  |=======================================================================
  |Field Name |Type |POST/PUT |Required |Description
  |uri |URI | |
  |A GET against this URI refreshes the representation of this resource.
  
  |id |UUID |POST |No
  |A unique identifier of the resource. If this field is omitted in the POST
  request, a random UUID is generated.
  
  |mac |String |POST/PUT |Yes
  |The MAC address for which the corresponding traffic will be redirected by this
  service insertion.
  
  |portId |UUID |POST/PUT |Yes
  |The identifier of the virtual port on which the traffic is inspected.
  
  |position |Integer |POST/PUT |Yes
  |The position of the service insertion in a service insertions chain.
  
  |srvPortId |UUID |POST/PUT |Yes
  |The identifier of the virtual port toward which the traffic will be redirected.
  
  |failOpen |Boolean |POST/PUT |No
  |If true, it allows the traffic when the chain is down or not ready. The
  default is false.
  
  |vlan |Integer |POST/PUT |No
  |The VLAN identifier applied to the redirected traffic.
  |=======================================================================
  
  
  [[port-link]]
  === Port Link
  
  _Media Type_:::
    `[application/vnd.org.midonet.PortLink-v1+json]`
  
  ----------------------------
  POST     /ports/:portId/link
  DELETE   /ports/:portId/link
  ----------------------------
  
  It represents a link between two interior ports. Links are possible
  between:
  
  * Two router ports.
  * A router port and a bridge port
  * Two bridge ports, as long as just one of the two peers has a VLAN ID
  assigned. The bridge owning this port will act as a VLAN-aware bridge,
  pushing and poping VLAN IDs as frames traverse this port.
  
  It contains the following fields:
  
  [width="100%",cols="16%,7%,11%,11%,55%",options="header",]
  |=======================================================================
  |Field Name |Type |POST/PUT |Required |Description
  |uri |URI | |
  |A GET against this URI refreshes the representation of this resource.
  
  |port |URI | |
  |A GET against this URI returns the port.
  
  |peer |URI | |
  |A GET against this URI returns the peer port.
  
  |portId |UUID |POST |Yes
  |The identifier of the port.
  
  |peerId |UUID |POST |Yes
  |The identifier of the peer port.
  |=======================================================================
  
  
  [[load-balancer]]
  === Load Balancer
  
  _Media Type_:::
    `[application/vnd.org.midonet.LoadBalancer-v1+json]`
  _Collection Media Type_:::
    `[application/vnd.org.midonet.collection.LoadBalancer-v1+json]`
  
  ---------------------------------------
  GET     /load_balancers
  GET     /load_balancers/:loadBalancerId
  POST    /load_balancers
  PUT     /load_balancers/:loadBalancerId
  DELETE  /load_balancers/:loadBalancerId
  ---------------------------------------
  
  A load balancer is an entity that represents a layer 4 virtual load balancer
  device. It contains the following fields:
  
  [width="100%",cols="24%,8%,11%,11%,46%",options="header",]
  |=======================================================================
  |Field Name |Type |POST/PUT |Required |Description
  |uri |URI | |
  |A GET against this URI refreshes the representation of this resource.
  
  |router |URI | |
  |A GET against this URI returns the router for this load balancer.
  
  |pools |URI | |
  |A GET against this URI returns the list of pools associated with the load
  balancer.
  
  |vips |URI | |
  |A GET against this URI returns the list of VIPs associated with the load
  balancer.
  
  |id |UUID |POST |No
  |A unique identifier of the resource. If this field is omitted in the POST
  request, a random UUID is generated.
  
  |routerId |UUID |POST/PUT |Yes
  |The identifier of the associated router.
  
  |adminStateUp |Boolean |POST/PUT |No
  |The administrative state of the load balancer. The default is _true_ (up).
  |=======================================================================
  
  
  [[mac-port]]
  === MAC-Port
  
  _Media Type_:::
    `[application/vnd.org.midonet.MacPort-v2+json]`
  _Collection Media Type_:::
    `[application/vnd.org.midonet.collection.MacPort-v2+json]`
  
  ---------------------------------------------------------------
  GET     /bridges/:bridgeId/mac_table
  