M #: Update monitoring new parameter for APIs (#4896)

src/oca/go/src/goca/host.go

@@ -111,7 +111,8 @@ func (hc *HostsController) Create(name, im, vm string, clusterID int) (int, erro
 }
 
 // Monitoring Returns the Hosts monitoring records
-// * num: The number of records to be retrieved. If it is -1, all the records will be retrieved.
+// num: Retrieve monitor records in the last num seconds.
+// 0 just the last record, -1 all records
 func (hc *HostsController) Monitoring(num int) (string, error) {
 	monitorData, err := hc.c.Client.Call("one.hostpool.monitoring", num)
 	if err != nil {

src/oca/go/src/goca/vm.go

@@ -180,7 +180,8 @@ func (vc *VMController) Info(decrypt bool) (*vm.VM, error) {
 // -2: All resources
 // -1: Resources belonging to the user and any of his groups
 // >= 0: UID User's Resources
-// num: the number of records to be retrieved. If -1 every record is retrieved
+// num: Retrieve monitor records in the last num seconds.
+// 0 just the last record, -1 all records
 func (vc *VMsController) Monitoring(filter, num int) (string, error) {
 	monitorData, err := vc.c.Client.Call("one.vmpool.monitoring", filter, num)
 	if err != nil {

src/oca/java/src/org/opennebula/client/host/HostPool.java

@@ -78,8 +78,8 @@ public class HostPool extends Pool implements Iterable<Host>{
      * Retrieves the monitoring data for all the hosts in the pool.
      *
      * @param client XML-RPC Client.
-     * @param num number of monitoring records to be retrieved, if -1
-     * every record will be retrieved.
+     * @param num: Retrieve monitor records in the last num seconds.
+     * 0 just the last record, -1 all records.
      * @return If successful the message contains the string
      * with the information returned by OpenNebula.
      */

src/oca/java/src/org/opennebula/client/vm/VirtualMachinePool.java

@@ -265,8 +265,8 @@ public class VirtualMachinePool extends Pool implements Iterable<VirtualMachine>
      * <li>{@link Pool#GROUP}: User's primary group Virtual Machines</li>
      * <li>&gt;= 0 UID User's Virtual Machines</li>
      * </ul>
-     * @param num number of monitoring records to be retrieved, if -1
-     * every record will be retrieved.
+     * @param num: Retrieve monitor records in the last num seconds.
+     * 0 just the last record, -1 all records.
      * @return If successful the message contains the string
      * with the information returned by OpenNebula.
      */