onevmgroup(1)

ONEVMGROUP(1)

onevmgroup(1) -- manages VM groups

ONEVMGROUP(1)

NAME

onevmgroup - manages VM groups

SYNOPSIS

onevmgroup command [args] [options]

OPTIONS



 --adjust x,y,z            Adjust size to not truncate selected columns


 --admin                   lock admin actions


 --all                     lock all actions


 -a, --append              Append new attributes to the current template


 --csv                     Write table in csv format


 --csv-del del             Set delimiter for csv output


 -d, --delay x             Sets the delay in seconds for top command


 --describe                Describe list columns


 --endpoint endpoint       URL of OpenNebula xmlrpc frontend


 --expand [x=prop,y=prop]  Expands the columns size to fill the terminal.


                           For example: $onevm list --expand


                           name=0.4,group=0.6 will expand name 40% and


                           group 60%. $onevm list --expand name,group will


                           expand name and group based on its size.$onevm


                           list --expand will expand all columns.


 -f, --filter x,y,z        Filter data. An array is specified with


                           column=value pairs. Valid operators


                           =,!=,<,<=,>,>=,~ e.g. NAME=test (match name with


                           test) NAME~test (match every NAME containing the


                           substring ´test´)


 -h, --help                Show this message


 -j, --json                Show the resource in JSON format


 -l, --list x,y,z          Selects columns to display with list command


 -c, --listconf conf       Selects a predefined column list


 --manage                  lock manage actions


 --no-expand               Disable expand


 --no-header               Hides the header of the table


 --no-pager                Disable pagination


 -n, --numeric             Do not translate user and group IDs


 --operator operator       Logical operator used on filters: AND, OR.


                           Default: AND.


 --password password       Password to authenticate with OpenNebula


 -s, --size x=size,y=size  Change the size of selected columns. For example:


                           $ onevm list --size "name=20" will make column


                           name size 20.


 --use                     lock use actions


 --user name               User name used to connect to OpenNebula


 -v, --verbose             Verbose mode


 -V, --version             Show version and copyright information


 -x, --xml                 Show the resource in xml format


 -y, --yaml                Show the resource in YAML format

COMMANDS

○: chgrp range|vmgroupid_list groupid Changes the VM Group´s group
○: chmod range|vmgroupid_list octet Changes the VM Group permissions
○: chown range|vmgroupid_list userid [groupid] Changes the VM Group´s owner and group
○: create file Creates a new VM Group from the given description
○: delete range|vmgroupid_list Deletes the VM Group
○: list [filterflag] Lists VM Group in the pool. The default columns and their layout can be configured in onevmgroup.yaml valid options: adjust, csv, csv_del, delay, describe, expand, filter, json, list, listconf, no_expand, no_header, no_pager, numeric, operator, size, xml, yaml
○: lock range|vmgroupid_list Locks a VM Group to prevent certain actions defined by different levels. The show action will never be locked. Valid states are: All. Levels: [Use]: locks Admin, Manage and Use actions. [Manage]: locks Manage and Use actions. [Admin]: locks only Admin actions. valid options: admin, all, manage, use
○: rename vmgroupid name Renames the VM Group
○: role-add vmgroupid [file] Add role to VM Group.
○: role-delete vmgroupid roleid Deletes role from VM Group.
○: role-update vmgroupid roleid [file] Update VM Group role
○: show vmgroupid Shows information for the given VM Group valid options: json, xml, yaml
○: unlock range|vmgroupid_list Unlocks a VM Group. Valid states are: All.
○: update vmgroupid [file] Update the template contents. If a path is not provided the editor will be launched to modify the current content. valid options: append

ARGUMENT FORMATS

○: file Path to a file
○: filterflag a, all all the known VM_GROUPs m, mine the VM_GROUP belonging to the user in ONE_AUTH g, group ´mine´ plus the VM_GROUP belonging to the groups the user is member of G, primary group the VM_GROUP owned the user´s primary group uid VM_GROUP of the user identified by this uid user VM_GROUP of the user identified by the username
○: groupid OpenNebula GROUP name or id
○: range List of id´s in the form 1,8..15
○: roleid Role identifier
○: text String
○: userid OpenNebula USER name or id
○: vmgroupid OpenNebula VM_GROUP name or id
○: vmgroupid_list Comma-separated list of OpenNebula VM_GROUP names or ids

VERSION

April 2026