interface/{interface-type}/{interface-name}/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

None