icontrol 0.3.1 → 0.3.2

data/lib/icontrol/networking/stp_instance.rb

@@ -1,6 +1,7 @@
 module IControl::Networking
   ##
-  # The STPInstance interface enables you to work with the definitions and attributes associated with an STP instance.
+  # The STPInstance interface enables you to work with the definitions and attributes
+  # associated with an STP instance.
   class STPInstance < IControl::Base
 
     set_id_name "stp_instances"
@@ -10,12 +11,26 @@ module IControl::Networking
     class InterfaceSTPRole < IControl::Base::Struct; end
     class InterfaceSTPState < IControl::Base::Struct; end
     class PathCost < IControl::Base::Struct; end
+    class InterfacePathCostSequence < IControl::Base::Sequence ; end
+    class InterfacePathCostSequenceSequence < IControl::Base::SequenceSequence ; end
+    class InterfacePrioritySequence < IControl::Base::Sequence ; end
+    class InterfacePrioritySequenceSequence < IControl::Base::SequenceSequence ; end
+    class InterfaceSTPRoleSequence < IControl::Base::Sequence ; end
+    class InterfaceSTPRoleSequenceSequence < IControl::Base::SequenceSequence ; end
+    class InterfaceSTPStateSequence < IControl::Base::Sequence ; end
+    class InterfaceSTPStateSequenceSequence < IControl::Base::SequenceSequence ; end
+    class PathCostSequence < IControl::Base::Sequence ; end
+    class PathCostTypeSequence < IControl::Base::Sequence ; end
+    class PathCostTypeSequenceSequence < IControl::Base::SequenceSequence ; end
     # A list of path cost types.
     class PathCostType < IControl::Base::Enumeration; end    ##
-    # Adds/associates VLANs to this spanning tree instances. This method may be used only in MSTP mode. In STP or RSTP mode, all VLANs automatically belong to spanning tree instance 0.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # Adds/associates VLANs to this spanning tree instances. This method may be used only
+    # in MSTP mode. In STP or RSTP mode, all VLANs automatically belong to spanning tree
+    # instance 0.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [String[]] :vlan_names The VLAN names to add to the spanning tree instances.
     def add_vlan(opts)
@@ -25,9 +40,10 @@ module IControl::Networking
 
     ##
     # Creates this spanning tree instances.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [long] :priorities The per-instance bridge priorities.
     # @option opts [String[]] :vlan_names The VLAN members that are under the control of the STP instances.
@@ -38,38 +54,50 @@ module IControl::Networking
 
     ##
     # Deletes all spanning tree instances.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def delete_all_instances
       super
     end
 
     ##
     # Deletes this spanning tree instances.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def delete_instance
       super
     end
 
     ##
-    # Gets the bridge priorities of this spanning tree instances. Each bridge in a spanning tree instance has a priority value, which controls the topoloty of the spanning tree chosen by the protocol. The bridge with the lowest priority value will become the root of the spanning tree. Priority values range from 0-61440 in steps of 4096. Hence, the supported priorities are: 0 16384 32768 49152 4096 20480 36864 53248 8192 24576 40960 57344 12288 28672 45056 61440 The default bridge priority is 61440, which will prevent BIGIP from being chosen as the root bridge. If this bridge priority is not one of the allowed values listed above, it is rounded down to the next lower value in the list. In STP or RSTP mode, only STP intance 0 is valid.
+    # Gets the bridge priorities of this spanning tree instances. Each bridge in a spanning
+    # tree instance has a priority value, which controls the topoloty of the spanning tree
+    # chosen by the protocol. The bridge with the lowest priority value will become the
+    # root of the spanning tree. Priority values range from 0-61440 in steps of 4096. Hence,
+    # the supported priorities are: 0 16384 32768 49152 4096 20480 36864 53248 8192 24576
+    # 40960 57344 12288 28672 45056 61440 The default bridge priority is 61440, which will
+    # prevent BIGIP from being chosen as the root bridge. If this bridge priority is not
+    # one of the allowed values listed above, it is rounded down to the next lower value
+    # in the list. In STP or RSTP mode, only STP intance 0 is valid.
+    # @rspec_example
     # @return [long]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def bridge_priority
       super
     end
 
     ##
     # Gets the STP active states for this STP port objects.
+    # @rspec_example
     # @return [InterfaceSTPState[]]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [String[]] :interfaces The interfaces/trunks from which to get the active states.
     def interface_active_state(opts)
@@ -78,11 +106,26 @@ module IControl::Networking
     end
 
     ##
-    # Gets the path costs for this network interfaces in this spanning tree instances. An interface path cost represents the relative cost of sending network traffic through that interface. In calculating the spanning tree, the algorithm tries to minimize the total path cost between each point and the root bridge. By manipulating the path costs of different interfaces, it's possible to steer traffic toward paths that are faster, more reliable, and/or more economical. Path costs have a range of 1-200,000,000, and the default path cost for an interface is based on the interface's maximum speed (not the actual speed). Max interface speed	 Default path cost	 10 Gb/s		 2,000	 1 Gb/s		 20,000	 100 Mb/s		 200,000	 10 MB/s		 2,000,000 The default path cost is a function of the interface's maximum speed, not its actual speed, so the default path cost of a 10/100/1000 Mb/s interface will be 20,000 even if the interface is running at 10 Mb/s. Changes in link speed don't cause path costs to change. Link aggregation doesn't affect the default path cost, i.e. a trunk of four 1 Gb/s interfaces will still have a default path cost of 20,000. In STP or RSTP mode, only STP intance 0 is valid.
+    # Gets the path costs for this network interfaces in this spanning tree instances.
+    # An interface path cost represents the relative cost of sending network traffic through
+    # that interface. In calculating the spanning tree, the algorithm tries to minimize
+    # the total path cost between each point and the root bridge. By manipulating the path
+    # costs of different interfaces, it's possible to steer traffic toward paths that are
+    # faster, more reliable, and/or more economical. Path costs have a range of 1-200,000,000,
+    # and the default path cost for an interface is based on the interface's maximum speed
+    # (not the actual speed). Max interface speed	 Default path cost	 10 Gb/s		 2,000
+    # 1 Gb/s		 20,000	 100 Mb/s		 200,000	 10 MB/s		 2,000,000 The default path cost is
+    # a function of the interface's maximum speed, not its actual speed, so the default
+    # path cost of a 10/100/1000 Mb/s interface will be 20,000 even if the interface is
+    # running at 10 Mb/s. Changes in link speed don't cause path costs to change. Link
+    # aggregation doesn't affect the default path cost, i.e. a trunk of four 1 Gb/s interfaces
+    # will still have a default path cost of 20,000. In STP or RSTP mode, only STP intance
+    # 0 is valid.
+    # @rspec_example
     # @return [InterfacePathCost[]]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [String[]] :interfaces The interfaces from which to get the interface path costs.
     # @option opts [IControl::Networking::STPInstance::PathCostType[]] :path_cost_types The types of path costs (internal/external) to query.
@@ -92,11 +135,19 @@ module IControl::Networking
     end
 
     ##
-    # Gets the priorities for this network interfaces in this spanning tree instances. These priority values influence which interfaces are chosen to carry network traffic. Interfaces with numerically lower values are favored to carry traffic. Interface priorities have values in the range from 0-240 in steps of 166. Hence, the supported priorities are: 0	64 128 192 16	80 144 208 32	96 160 224 48 112 176 240 The default interface priority is 128. If this interface priority is not one of the allowed values listed above, it is rounded down to the next lower value in the list. In STP or RSTP mode, only STP intance 0 is valid.
+    # Gets the priorities for this network interfaces in this spanning tree instances.
+    # These priority values influence which interfaces are chosen to carry network traffic.
+    # Interfaces with numerically lower values are favored to carry traffic. Interface
+    # priorities have values in the range from 0-240 in steps of 166. Hence, the supported
+    # priorities are: 0	64 128 192 16	80 144 208 32	96 160 224 48 112 176 240 The default
+    # interface priority is 128. If this interface priority is not one of the allowed values
+    # listed above, it is rounded down to the next lower value in the list. In STP or RSTP
+    # mode, only STP intance 0 is valid.
+    # @rspec_example
     # @return [InterfacePriority[]]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [String[]] :interfaces The interfaces from which to get the interface priorities.
     def interface_priority(opts)
@@ -106,10 +157,11 @@ module IControl::Networking
 
     ##
     # Gets the STP requested/configured states for this STP port objects.
+    # @rspec_example
     # @return [InterfaceSTPState[]]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [String[]] :interfaces The interfaces/trunks from which to get the active states.
     def interface_requested_state(opts)
@@ -119,10 +171,11 @@ module IControl::Networking
 
     ##
     # Gets the STP roles for this STP port objects.
+    # @rspec_example
     # @return [InterfaceSTPRole[]]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [String[]] :interfaces The interfaces/trunks from which to get the active states.
     def interface_role(opts)
@@ -132,65 +185,78 @@ module IControl::Networking
 
     ##
     # Gets a list of all spanning tree instances.
+    # @rspec_example
     # @return [long]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def list
       super
     end
 
     ##
     # Gets the MAC addresses of the regional root bridges.
+    # @rspec_example
     # @return [String]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def regional_root_bridge_mac_address
       super
     end
 
     ##
     # Gets the MAC addresses of the root bridges.
+    # @rspec_example
     # @return [String]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def root_bridge_mac_address
       super
     end
 
     ##
     # Gets the version information for this interface.
+    # @rspec_example
     # @return [String]
     def version
       super
     end
 
     ##
-    # Gets the lists of VLANs this spanning tree instances are associated with. This method may be used only in MSTP mode. In STP or RSTP mode, all VLANs automatically belong to spanning tree instance 0.
+    # Gets the lists of VLANs this spanning tree instances are associated with. This method
+    # may be used only in MSTP mode. In STP or RSTP mode, all VLANs automatically belong
+    # to spanning tree instance 0.
+    # @rspec_example
     # @return [String[]]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def vlan
       super
     end
 
     ##
-    # Removes all VLANs from this spanning tree instances. This method may be used only in MSTP mode. In STP or RSTP mode, all VLANs automatically belong to spanning tree instance 0, and they can not be deleted from it.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # Removes all VLANs from this spanning tree instances. This method may be used only
+    # in MSTP mode. In STP or RSTP mode, all VLANs automatically belong to spanning tree
+    # instance 0, and they can not be deleted from it.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def remove_all_vlans
       super
     end
 
     ##
-    # Removes VLANs from this spanning tree instances. This method may be used only in MSTP mode. In STP or RSTP mode, all VLANs automatically belong to spanning tree instance 0, and they can not be deleted from it.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # Removes VLANs from this spanning tree instances. This method may be used only in
+    # MSTP mode. In STP or RSTP mode, all VLANs automatically belong to spanning tree instance
+    # 0, and they can not be deleted from it.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [String[]] :vlan_names The VLAN names to remove from the spanning tree instances.
     def remove_vlan(opts)
@@ -199,10 +265,19 @@ module IControl::Networking
     end
 
     ##
-    # Sets the bridge priorities of this spanning tree instances. Each bridge in a spanning tree instance has a priority value, which controls the topoloty of the spanning tree chosen by the protocol. The bridge with the lowest priority value will become the root of the spanning tree. Priority values range from 0-61440 in steps of 4096. Hence, the supported priorities are: 0 16384 32768 49152 4096 20480 36864 53248 8192 24576 40960 57344 12288 28672 45056 61440 The default bridge priority is 61440, which will prevent BIGIP from being chosen as the root bridge. If this bridge priority is not one of the allowed values listed above, it is rounded down to the next lower value in the list. In STP or RSTP mode, only STP intance 0 is valid.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # Sets the bridge priorities of this spanning tree instances. Each bridge in a spanning
+    # tree instance has a priority value, which controls the topoloty of the spanning tree
+    # chosen by the protocol. The bridge with the lowest priority value will become the
+    # root of the spanning tree. Priority values range from 0-61440 in steps of 4096. Hence,
+    # the supported priorities are: 0 16384 32768 49152 4096 20480 36864 53248 8192 24576
+    # 40960 57344 12288 28672 45056 61440 The default bridge priority is 61440, which will
+    # prevent BIGIP from being chosen as the root bridge. If this bridge priority is not
+    # one of the allowed values listed above, it is rounded down to the next lower value
+    # in the list. In STP or RSTP mode, only STP intance 0 is valid.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [long] :priorities The bridge priorities of the specified spanning tree instances.
     def set_bridge_priority(opts)
@@ -211,10 +286,25 @@ module IControl::Networking
     end
 
     ##
-    # Sets the path costs for this network interfaces in this spanning tree instances. An interface path cost represents the relative cost of sending network traffic through that interface. In calculating the spanning tree, the algorithm tries to minimize the total path cost between each point and the root bridge. By manipulating the path costs of different interfaces, it's possible to steer traffic toward paths that are faster, more reliable, and/or more economical. Path costs have a range of 1-200,000,000, and the default path cost for an interface is based on the interface's maximum speed (not the actual speed). Max interface speed	 Default path cost	 10 Gb/s		 2,000	 1 Gb/s		 20,000	 100 Mb/s		 200,000	 10 MB/s		 2,000,000 The default path cost is a function of the interface's maximum speed, not its actual speed, so the default path cost of a 10/100/1000 Mb/s interface will be 20,000 even if the interface is running at 10 Mb/s. Changes in link speed don't cause path costs to change. Link aggregation doesn't affect the default path cost, i.e. a trunk of four 1 Gb/s interfaces will still have a default path cost of 20,000. In STP or RSTP mode, only STP intance 0 is valid.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # Sets the path costs for this network interfaces in this spanning tree instances.
+    # An interface path cost represents the relative cost of sending network traffic through
+    # that interface. In calculating the spanning tree, the algorithm tries to minimize
+    # the total path cost between each point and the root bridge. By manipulating the path
+    # costs of different interfaces, it's possible to steer traffic toward paths that are
+    # faster, more reliable, and/or more economical. Path costs have a range of 1-200,000,000,
+    # and the default path cost for an interface is based on the interface's maximum speed
+    # (not the actual speed). Max interface speed	 Default path cost	 10 Gb/s		 2,000
+    # 1 Gb/s		 20,000	 100 Mb/s		 200,000	 10 MB/s		 2,000,000 The default path cost is
+    # a function of the interface's maximum speed, not its actual speed, so the default
+    # path cost of a 10/100/1000 Mb/s interface will be 20,000 even if the interface is
+    # running at 10 Mb/s. Changes in link speed don't cause path costs to change. Link
+    # aggregation doesn't affect the default path cost, i.e. a trunk of four 1 Gb/s interfaces
+    # will still have a default path cost of 20,000. In STP or RSTP mode, only STP intance
+    # 0 is valid.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [IControl::Networking::STPInstance::InterfacePathCost[]] :path_costs The interface path costs of the specified interfaces in the spanning tree instances.
     def set_interface_path_cost(opts)
@@ -223,10 +313,18 @@ module IControl::Networking
     end
 
     ##
-    # Sets the priorities for this network interfaces in this spanning tree instances. These priority values influence which interfaces are chosen to carry network traffic. Interfaces with numerically lower values are favored to carry traffic. Interface priorities have values in the range from 0-240 in steps of 166. Hence, the supported priorities are: 0	64 128 192 16	80 144 208 32	96 160 224 48 112 176 240 The default interface priority is 128. If this interface priority is not one of the allowed values listed above, it is rounded down to the next lower value in the list. In STP or RSTP mode, only STP intance 0 is valid.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # Sets the priorities for this network interfaces in this spanning tree instances.
+    # These priority values influence which interfaces are chosen to carry network traffic.
+    # Interfaces with numerically lower values are favored to carry traffic. Interface
+    # priorities have values in the range from 0-240 in steps of 166. Hence, the supported
+    # priorities are: 0	64 128 192 16	80 144 208 32	96 160 224 48 112 176 240 The default
+    # interface priority is 128. If this interface priority is not one of the allowed values
+    # listed above, it is rounded down to the next lower value in the list. In STP or RSTP
+    # mode, only STP intance 0 is valid.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [IControl::Networking::STPInstance::InterfacePriority[]] :priorities The interface priorities of the specified interfaces in the spanning tree instances.
     def set_interface_priority(opts)

data/lib/icontrol/networking/trunk.rb

@@ -1,22 +1,29 @@
 module IControl::Networking
   ##
-  # The Trunk interface enables you to work with the definitions and attributes contained in a device's trunk.
+  # The Trunk interface enables you to work with the definitions and attributes contained
+  # in a device's trunk.
   class Trunk < IControl::Base
 
     set_id_name "trunks"
 
     class TrunkStatisticEntry < IControl::Base::Struct; end
     class TrunkStatistics < IControl::Base::Struct; end
-    # A list of frame distribution hashing options used to select which link to send the frame on, to maintain packet order.
+    class DistributionHashOptionSequence < IControl::Base::Sequence ; end
+    class LACPTimeoutOptionSequence < IControl::Base::Sequence ; end
+    class LinkSelectionPolicySequence < IControl::Base::Sequence ; end
+    class TrunkStatisticEntrySequence < IControl::Base::Sequence ; end
+    # A list of frame distribution hashing options used to select which link to send the
+    # frame on, to maintain packet order.
     class DistributionHashOption < IControl::Base::Enumeration; end
     # A list of LACP timeout options.
     class LACPTimeoutOption < IControl::Base::Enumeration; end
     # A list of link selection policies.
     class LinkSelectionPolicy < IControl::Base::Enumeration; end    ##
     # Adds the lists of interfaces to this trunk.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [String[]] :interfaces The lists of interfaces to add to the specified trunks.
     def add_interface(opts)
@@ -26,9 +33,10 @@ module IControl::Networking
 
     ##
     # Creates this trunk.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [boolean] :lacp_states The LACP enabled states associated with the specified trunks.
     # @option opts [String[]] :interfaces The interfaces associated with the specified trunks.
@@ -39,174 +47,206 @@ module IControl::Networking
 
     ##
     # Deletes all trunk.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def delete_all_trunks
       super
     end
 
     ##
     # Deletes this trunk.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def delete_trunk
       super
     end
 
     ##
-    # Gets the states indicating whether LACP is operating in active or passive mode. When operating in passive mode, LACP will not send LACP frames out LACP-enabled interfaces or LACP-enabled trunk unless an LACP frame is first received on that interface or trunk. When operating in active mode, LACP immediately begins sending LACP frames from LACP-enabled interfaces and trunk.
+    # Gets the states indicating whether LACP is operating in active or passive mode. When
+    # operating in passive mode, LACP will not send LACP frames out LACP-enabled interfaces
+    # or LACP-enabled trunk unless an LACP frame is first received on that interface or
+    # trunk. When operating in active mode, LACP immediately begins sending LACP frames
+    # from LACP-enabled interfaces and trunk.
+    # @rspec_example
     # @return [EnabledState]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def active_lacp_state
       super
     end
 
     ##
     # Gets the statistics of all trunk.
+    # @rspec_example
     # @return [TrunkStatistics]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def all_statistics
       super
     end
 
     ##
     # Gets the number of configured links of this trunk.
+    # @rspec_example
     # @return [long]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def configured_member_count
       super
     end
 
     ##
     # Gets the frame distribution hashing option used by this trunk.
+    # @rspec_example
     # @return [DistributionHashOption]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def distribution_hash_option
       super
     end
 
     ##
     # Gets the list of interfaces associated with this trunk.
+    # @rspec_example
     # @return [String[]]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def interface
       super
     end
 
     ##
     # Gets the states indicating whether LACP is enabled/disabled for this trunk.
+    # @rspec_example
     # @return [EnabledState]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def lacp_enabled_state
       super
     end
 
     ##
     # Gets LACP timeout options for this trunk.
+    # @rspec_example
     # @return [LACPTimeoutOption]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def lacp_timeout_option
       super
     end
 
     ##
     # Gets the link selection policies used by this trunk.
+    # @rspec_example
     # @return [LinkSelectionPolicy]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def link_selection_policy
       super
     end
 
     ##
     # Gets a list of all trunk on this device.
+    # @rspec_example
     # @return [String]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def list
       super
     end
 
     ##
-    # Gets the current operational media speeds of this trunk. Unit = Mbps. This will be equivalent to the sum of the speeds of all operational links in a particular trunk.
+    # Gets the current operational media speeds of this trunk. Unit = Mbps. This will be
+    # equivalent to the sum of the speeds of all operational links in a particular trunk.
+    # @rspec_example
     # @return [long]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def media_speed
       super
     end
 
     ##
     # Gets the media status of this trunk.
+    # @rspec_example
     # @return [MediaStatus]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def media_status
       super
     end
 
     ##
     # Gets the current number of operational links of this trunk.
+    # @rspec_example
     # @return [long]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def operational_member_count
       super
     end
 
     ##
     # Gets the statistics of this trunk.
+    # @rspec_example
     # @return [TrunkStatistics]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def statistics
       super
     end
 
     ##
-    # Gets the states indicating whether this trunk will participate in the spanning tree protocol. Disabling spanning tree protocol on a trunk enables learning and forwarding on it. The spanning tree algorithm then behaves as if the trunk did not exist. No STP, RSTP, or MSTP packets are transmitted or received on the trunk, and the spanning tree algorithm exerts no control over forwarding or learning on the port. NOTE: For a trunk to participate in spanning tree protocol, the protocol must be enabled on all of its configured member interfaces.
+    # Gets the states indicating whether this trunk will participate in the spanning tree
+    # protocol. Disabling spanning tree protocol on a trunk enables learning and forwarding
+    # on it. The spanning tree algorithm then behaves as if the trunk did not exist. No
+    # STP, RSTP, or MSTP packets are transmitted or received on the trunk, and the spanning
+    # tree algorithm exerts no control over forwarding or learning on the port. NOTE: For
+    # a trunk to participate in spanning tree protocol, the protocol must be enabled on
+    # all of its configured member interfaces.
+    # @rspec_example
     # @return [EnabledState]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def stp_enabled_state
       super
     end
 
     ##
-    # Gets the states indicating whether RSTP or MSTP BPDUs (depending on the current STP mode) to be sent on this trunk, until such time as a legacy STP bridge is detected again on those trunk. Note: This method is only applicable when the current STP mode is RSTP or MSTP.
+    # Gets the states indicating whether RSTP or MSTP BPDUs (depending on the current STP
+    # mode) to be sent on this trunk, until such time as a legacy STP bridge is detected
+    # again on those trunk. Note: This method is only applicable when the current STP mode
+    # is RSTP or MSTP.
+    # @rspec_example
     # @return [EnabledState]
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def stp_protocol_detection_reset_state
       super
     end
 
     ##
     # Gets the version information for this interface.
+    # @rspec_example
     # @return [String]
     def version
       super
@@ -214,18 +254,20 @@ module IControl::Networking
 
     ##
     # Removes all interfaces from this trunk.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def remove_all_interfaces
       super
     end
 
     ##
     # Removes the lists of interfaces from this trunk.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [String[]] :interfaces The lists of interfaces to remove from the specified trunks.
     def remove_interface(opts)
@@ -235,18 +277,24 @@ module IControl::Networking
 
     ##
     # Resets the statistics of this trunk.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     def reset_statistics
       super
     end
 
     ##
-    # Gets the states indicating whether LACP is operating in active or passive mode. When operating in passive mode, LACP will not send LACP frames out LACP-enabled interfaces or LACP-enabled trunk unless an LACP frame is first received on that interface or trunk. When operating in active mode, LACP immediately begins sending LACP frames from LACP-enabled interfaces and trunk.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # Gets the states indicating whether LACP is operating in active or passive mode. When
+    # operating in passive mode, LACP will not send LACP frames out LACP-enabled interfaces
+    # or LACP-enabled trunk unless an LACP frame is first received on that interface or
+    # trunk. When operating in active mode, LACP immediately begins sending LACP frames
+    # from LACP-enabled interfaces and trunk.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [IControl::Common::EnabledState] :states The states indicating whether active LACP is enabled/disabled.
     def set_active_lacp_state(opts)
@@ -256,9 +304,10 @@ module IControl::Networking
 
     ##
     # Sets the frame distribution hashing option used by this trunk.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [IControl::Networking::Trunk::DistributionHashOption] :hashing_options The frame distribution hashing option used by the specified trunks..
     def set_distribution_hash_option(opts)
@@ -268,9 +317,10 @@ module IControl::Networking
 
     ##
     # Sets the states indicating whether LACP is enabled/disabled for this trunk.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [IControl::Common::EnabledState] :states The states indicating whether LACP is enabled/disabled for the specified trunks.
     def set_lacp_enabled_state(opts)
@@ -280,9 +330,10 @@ module IControl::Networking
 
     ##
     # Gets LACP timeout options for this trunk.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [IControl::Networking::Trunk::LACPTimeoutOption] :timeout_options The LACP timeout options for the specified trunks.
     def set_lacp_timeout_option(opts)
@@ -292,9 +343,10 @@ module IControl::Networking
 
     ##
     # Sets the link selection policies used by this trunk.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [IControl::Networking::Trunk::LinkSelectionPolicy] :policies The link selection policies used by the specified trunks.
     def set_link_selection_policy(opts)
@@ -303,10 +355,17 @@ module IControl::Networking
     end
 
     ##
-    # Sets the states indicating whether this trunk will participate in the spanning tree protocol. Disabling spanning tree protocol on a trunk enables learning and forwarding on it. The spanning tree algorithm then behaves as if the trunk did not exist. No STP, RSTP, or MSTP packets are transmitted or received on the trunk, and the spanning tree algorithm exerts no control over forwarding or learning on the port. NOTE: For a trunk to participate in spanning tree protocol, the protocol must be enabled on all of its configured member interfaces.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # Sets the states indicating whether this trunk will participate in the spanning tree
+    # protocol. Disabling spanning tree protocol on a trunk enables learning and forwarding
+    # on it. The spanning tree algorithm then behaves as if the trunk did not exist. No
+    # STP, RSTP, or MSTP packets are transmitted or received on the trunk, and the spanning
+    # tree algorithm exerts no control over forwarding or learning on the port. NOTE: For
+    # a trunk to participate in spanning tree protocol, the protocol must be enabled on
+    # all of its configured member interfaces.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [IControl::Common::EnabledState] :states The STP enabled states to set for the specified interface names.
     def set_stp_enabled_state(opts)
@@ -315,10 +374,14 @@ module IControl::Networking
     end
 
     ##
-    # Sets the states indicating whether RSTP or MSTP BPDUs (depending on the current STP mode) to be sent on this trunk, until such time as a legacy STP bridge is detected again on those trunk. Note: This method is only applicable when the current STP mode is RSTP or MSTP.
-    # @raise [IControl::Common::AccessDenied] raised if the client credentials are not valid.
-    # @raise [IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
-    # @raise [IControl::Common::OperationFailed] raised if an operation error occurs.
+    # Sets the states indicating whether RSTP or MSTP BPDUs (depending on the current STP
+    # mode) to be sent on this trunk, until such time as a legacy STP bridge is detected
+    # again on those trunk. Note: This method is only applicable when the current STP mode
+    # is RSTP or MSTP.
+    # @rspec_example
+    # @raise [IControl::IControl::Common::AccessDenied] raised if the client credentials are not valid.
+    # @raise [IControl::IControl::Common::InvalidArgument] raised if one of the arguments is invalid.
+    # @raise [IControl::IControl::Common::OperationFailed] raised if an operation error occurs.
     # @param [Hash] opts
     # @option opts [IControl::Common::EnabledState] :states The STP protocol detection reset states to set for the specified interface names.
     def set_stp_protocol_detection_reset_state(opts)
@@ -329,18 +392,18 @@ module IControl::Networking
     ##
     # A struct that describes a trunk's general statistics.
     # @attr [String] trunk_name The trunk name.
-    # @attr [IControl::Common::Statistic] statistics The statistics.
+    # @attr [IControl::Common::StatisticSequence] statistics The statistics.
     class TrunkStatisticEntry < IControl::Base::Struct
       icontrol_attribute :trunk_name, String
-      icontrol_attribute :statistics, IControl::Common::Statistic
+      icontrol_attribute :statistics, IControl::Common::StatisticSequence
     end
 
     ##
     # A struct that describes trunk statistics and timestamp.
-    # @attr [IControl::Networking::Trunk::TrunkStatisticEntry] statistics The statistics for a sequence of trunks.
+    # @attr [IControl::Networking::Trunk::TrunkStatisticEntrySequence] statistics The statistics for a sequence of trunks.
     # @attr [IControl::Common::TimeStamp] time_stamp The time stamp at the time the statistics are gathered.
     class TrunkStatistics < IControl::Base::Struct
-      icontrol_attribute :statistics, IControl::Networking::Trunk::TrunkStatisticEntry
+      icontrol_attribute :statistics, IControl::Networking::Trunk::TrunkStatisticEntrySequence
       icontrol_attribute :time_stamp, IControl::Common::TimeStamp
     end
 
@@ -353,7 +416,8 @@ module IControl::Networking
     class LinkSelectionPolicySequence < IControl::Base::Sequence ; end
     ## A sequence of trunk statistics.
     class TrunkStatisticEntrySequence < IControl::Base::Sequence ; end
-    # A list of frame distribution hashing options used to select which link to send the frame on, to maintain packet order.
+    # A list of frame distribution hashing options used to select which link to send the
+    # frame on, to maintain packet order.
     class DistributionHashOption < IControl::Base::Enumeration
       # Hash on the destination MAC address.
       DISTRIBUTION_HASH_OPTION_DST_MAC = :DISTRIBUTION_HASH_OPTION_DST_MAC