interface/{interface-type}/{interface-name}/spanning-tree

Configures spanning tree.

Resource URIs


URI	Description
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree	Configures spanning tree at the interface level. Valid interface types: Ethernet, Port-channel.


GET URIs	Description
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/portfast	Enable an interface to move directly to forwarding on link up. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/guard	Change an interface's spanning tree guard mode. Valid interface types: Ethernet, Port-channel.


POST URIs	Payload	Description
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree	<instance><id>(unit32)</id><priority>(unit32)</priority></instance>	Configures STP instance. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/autoedge	<autoedge>(empty)</autoedge>	Configures STP auto-edge. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/cost	<cost>(unitr32)</cost>	Configures the cost. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/edgeport/edgeportbasic	<edgeportbasic>(empty)</edgeportbasic>	Configures STP edge port. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/edgeport/bpdu-guard	<bpdu-guard>(empty)</bpdu-guard>	Configures BPDU guard. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/edgeport/bpdu-filter	<bpdu-filter>(empty)</bpdu-filter>	Configures BPDU filter. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/instance/{instance-id}/cost	<cost>(unit32)</cost>	Configures cost. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/instance/{instance-id}/restricted-role	<restricted-role>(empty)</restricted-role>	Configures restricted role for a particular instance. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/instance/{instance-id}/restricted-tcn	<restricted-tcn>(empty)</restricted-tcn>	Configures restricted TCN for a particular instance. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/restricted-role	<restricted-role>(empty)</restricted-role>	Configures restricted role. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/restricted-tcn	<restricted-tcn>(empty)</restricted-tcn>	Configures restricted TCN. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/portfast	<portfastbasic></portfastbasic>	Enables an interface to move directly to forwarding on link up. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/portfast	<bpdu-guard>(empty)</bpdu-guard>	Guards the port against reception of BPDUs. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/portfast	<bpdu-filter>(empty)</bpdu-filter>	Sets the portfast bpdu-filter for the port. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree	<link-type>(enumeration)</link-type>	Point-to-point - enable rapid transition. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree	<priority>(unit32)</priority>	Sets the priority. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree	<shutdown>(empty)</shutdown>	Turns off STP. Valid interface types: Ethernet, Port-channel. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/guard	<root>(empty)</root>	Disables reception of superior BPDUs. Valid interface types: Ethernet, Port-channel.


PATCH URIs	Payload	Description
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/cost	<cost>(unit32)</cost>	Configures the cost. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/portfast/portfastbasic	<portfastbasic>(string)</portfastbasic>	Enables an interface to move directly to forwarding on link up. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/portfast/bpdu-guard	<bpdu-guard>(empty)</bpdu-guard>	Guards the port against reception of BPDUs. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/portfast/bpdu-filter	<bpdu-filter>(empty)</bpdu-filter>	Sets the portfast bpdu-filter for the port. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/link-type	<link-type>(enumeration)</link-type>	Point-to-point - enable rapid transition. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/priority	<priority>(unit32)</priority>	Sets the priority. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/shutdown	<shutdown>(empty)</shutdown>	Turns off STP. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/guard/root	<root>(empty)</root>	Disables reception of superior BPDUs. Valid interface types: Ethernet, Port-channel.


PUT URIs	Payload	Description
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/cost	<cost>(unit32)</cost>	Configures the cost. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/portfast/portfastbasic	<portfastbasic>(string)</portfastbasic>	Enables an interface to move directly to forwarding on link up. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/portfast/bpdu-guard	<bpdu-guard>(empty)</bpdu-guard>	Guards the port against reception of BPDUs. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/portfast/bpdu-filter	<bpdu-filter>(empty)</bpdu-filter>	Sets the portfast bpdu-filter for the port. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/link-type	<link-type>(enumeration)</link-type>	Point-to-point - enable rapid transition. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/priority	<priority>(unit32)</priority>	Sets the priority. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/shutdown	<shutdown>(empty)</shutdown>	Turns off STP. Valid interface types: Ethernet, Port-channel.
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/guard/root	<root>(empty)</root>	Disables reception of superior BPDUs. Valid interface types: Ethernet, Port-channel.


DELETE URIs
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/portfast
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/guard
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/autoedge
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/cost
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/edgeport/edgeportbasic
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/edgeport/bpdu-guard
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/edgeport/bpdu-filter
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/instance/{instance-id}/cost
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/instance/{instance-id}/restricted-role
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/instance/{instance-id}/restricted-tcn
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/restricted-role
<base_URI>/config/running/interface/{interface-type}/{interface-name}/spanning-tree/restricted-tcn

Parameters

interface-type: Valid interface types: Ethernet, Port-channel.
priority: Specifies the priority.
cost: Path cost (lower path cost indicates greater likelihood of becoming root port). The range is from 1 to 200000000.

Usage Guidelines

GET, POST, PUT, PATCH, DELETE, OPTIONS, and HEAD operations are supported.

Examples

URI

The following example uses the GET option to retrieve the configuration details.

http://host:80/rest/config/running/interface/ethernet/%222/13%22/spanning-tree

None

<spanning-tree xmlns="urn:brocade.com:mgmt:brocade-xstp" xmlns:y="http://brocade.com/ns/rest" 
y:self="/rest/config/running/interface/Ethernet/%222/13%22/spanning-tree">
  <cost>100</cost>
  <portfast y:self="/rest/config/running/interface/Ethernet/%222/13%22/spanning-tree/portfast">
    <portfastbasic>true</portfastbasic>
    <bpdu-guard>true</bpdu-guard>
    <bpdu-filter>true</bpdu-filter>
  </portfast>
  <guard y:self="/rest/config/running/interface/Ethernet/%222/13%22/spanning-tree/guard">
  </guard>
  <priority>32</priority>
</spanning-tree>

URI

The following example uses the POST option to configure STP BPDU guard.

http://host:80/rest/config/running/interface/ethernet/%222/13%22/spanning-tree/portfast

<bpdu-guard>(empty)</bpdu-guard>

None

URI

The following example uses the DELETE option to remove STP.

http://host:80/rest/config/running/interface/ethernet/%222/13%22/spanning-tree

None