Class VMGroupPool

  • All Implemented Interfaces:
    java.lang.Iterable<VMGroup>

    public class VMGroupPool
    extends Pool
    implements java.lang.Iterable<VMGroup>
    This class represents an OpenNebula VMGroup pool. It also offers static XML-RPC call wrappers.
    • Constructor Detail

      • VMGroupPool

        public VMGroupPool​(Client client)
        Creates a new VMGroup pool with the default filter flag value set to Pool.MINE_GROUP (VMGroups belonging to the connected user, and the ones in his group)
        Parameters:
        client - XML-RPC Client.
        See Also:
        VMGroupPool(Client, int)
      • VMGroupPool

        public VMGroupPool​(Client client,
                           int filter)
        Creates a new VMGroup pool.
        Parameters:
        client - XML-RPC Client.
        filter - Filter flag to use by default in the method info(). Possible values:
    • Method Detail

      • factory

        public PoolElement factory​(org.w3c.dom.Node node)
        Description copied from class: Pool
        The factory method returns a suitable PoolElement object from an XML node. Each Pool must implement the corresponding factory method.
        Specified by:
        factory in class Pool
        Parameters:
        node - XML Dom node to build the PoolElement from
        Returns:
        The corresponding PoolElement
      • info

        public static OneResponse info​(Client client,
                                       int filter)
        Retrieves all or part of the VMGroups in the pool.
        Parameters:
        client - XML-RPC Client.
        filter - Filter flag to use. Possible values:
        Returns:
        If successful the message contains the string with the information returned by OpenNebula.
      • infoAll

        public static OneResponse infoAll​(Client client)
        Retrieves all the VMGroups in the pool.
        Parameters:
        client - XML-RPC Client.
        Returns:
        If successful the message contains the string with the information returned by OpenNebula.
      • infoMine

        public static OneResponse infoMine​(Client client)
        Retrieves all the connected user's VMGroups.
        Parameters:
        client - XML-RPC Client.
        Returns:
        If successful the message contains the string with the information returned by OpenNebula.
      • infoGroup

        public static OneResponse infoGroup​(Client client)
        Retrieves all the connected user's VMGroups and the ones in his group.
        Parameters:
        client - XML-RPC Client.
        Returns:
        If successful the message contains the string with the information returned by OpenNebula.
      • info

        public static OneResponse info​(Client client,
                                       int filter,
                                       int startId,
                                       int endId)
        Retrieves all or part of the VMGroups in the pool. The VMGroups to retrieve can be also filtered by Id, specifying the first and last Id to include.
        Parameters:
        client - XML-RPC Client.
        filter - Filter flag to use. Possible values:
        startId - Lowest Id to retrieve
        endId - Biggest Id to retrieve
        Returns:
        If successful the message contains the string with the information returned by OpenNebula.
      • info

        public OneResponse info()
        Loads the xml representation of all or part of the VMGroups in the pool. The filter used is the one set in the constructor.
        Overrides:
        info in class Pool
        Returns:
        If successful the message contains the string with the information returned by OpenNebula.
        See Also:
        info(Client, int)
      • infoAll

        public OneResponse infoAll()
        Loads the xml representation of all the VMGroups in the pool.
        Overrides:
        infoAll in class Pool
        Returns:
        If successful the message contains the string with the information returned by OpenNebula.
      • infoMine

        public OneResponse infoMine()
        Loads the xml representation of all the connected user's VMGroups.
        Overrides:
        infoMine in class Pool
        Returns:
        If successful the message contains the string with the information returned by OpenNebula.
      • infoGroup

        public OneResponse infoGroup()
        Loads the xml representation of all the connected user's VMGroups and the ones in his group.
        Overrides:
        infoGroup in class Pool
        Returns:
        If successful the message contains the string with the information returned by OpenNebula.
      • info

        public OneResponse info​(int filter,
                                int startId,
                                int endId)
        Retrieves all or part of the VMGroups in the pool. The VMGroups to retrieve can be also filtered by Id, specifying the first and last Id to include.
        Overrides:
        info in class Pool
        Parameters:
        filter - Filter flag to use. Possible values:
        startId - Lowest Id to retrieve
        endId - Biggest Id to retrieve
        Returns:
        If successful the message contains the string with the information returned by OpenNebula.
      • iterator

        public java.util.Iterator<VMGroup> iterator()
        Specified by:
        iterator in interface java.lang.Iterable<VMGroup>
      • getById

        public VMGroup getById​(int id)
        Returns the VMGroup with the given Id from the pool. If it is not found, then returns null. The method info() must be called before.
        Overrides:
        getById in class Pool
        Parameters:
        id - of the VMGroup to retrieve
        Returns:
        The Image with the given Id, or null if it was not found.