3.1.1.1.1.2.10 GetUtilizationTrendForLogicalGroupNode
This procedure can be used to retrieve the address range utilization trend for the logical group node specified. The following are the input parameters to this procedure:
Param_logicalGroupNode: The LogicalGroupNode for which the address range utilization is being requested.
Param_addressfamily: The AddressFamily of the address range for which the utilization information for the logical group node is being requested.
Param_utilizationType: This is of type IPUtilizationType, specifying the type of utilization data that is being requested.
Param_startDate: This is the start date of the duration for which the utilization trend is being requested.
Param_endDate: This is the end date of the duration for which the utilization trend is being requested.
The following is the output parameter of this procedure.
Result_utilization: This will be of type IPCumulativeUtilization having IpUtilization to be a collection of IPUtilization. If the Param_addressfamily is Internet, the IPv4Utilization is returned and IPv6Utilization if the Param_addressfamily is InternetV6.
The following are the processing steps involved.
Call the procedure GetObjectIdsForLogicalGroupNode passing the following parameters:
Param_logicalGroupNode
Param_objectType is assigned the value of EnumerationObjectType.IPRange.
Param_addressfamily.
If Param_addressfamily is Internet, initialize Result_utilization to IPv4Utilization, otherwise initialize Result_utilization to IPv6Utilization.
For each id in Result_ObjectIds:
Call the procedure GetIPRangeFromTable passing id as Param_Id and Param_addressfamily.
If Param_utilizationType is Current:
Add result.UtilizationStatistics to Result_utilization.
Otherwise, if Param_addressFamily is InternetV6 or Param_utilizationType is not Current,
Call the procedure GetRangeUtilization passing the following parameters:
Param_id is set to id.
Param_addressfamily
Param_utilizationType
Param_startDate
Param_endDate
Add the corresponding members of IPCumulativeUtilization with Result_utilization.
Return Result_utilization as the output parameter of this procedure.