oneprovision - Manage OpenNebula Provisions
oneprovision-template command [args] [options]
--adjust x,y,z Adjust size to not truncate selected columns
-a, --all Show all provisions, including DONE
-a, --amount n Number of hosts to add or remove from the
provision (scales cardinality)
--api-version version OneForm API Version to use
--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
-d, --deployment name Specifies the deployment configuration associated
with the provision
--describe Describe list columns
--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')
-f, --force Force the resource deletion even if has
dependencies
-h, --help Show this message
-i, --ids ids Hosts IDs to remove from the provision
-i, --ips ips IP addresses to add as hosts. Only valid for
on-prem providers
-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
--no-expand Disable expand
--no-header Hides the header of the table
--no-pager Disable pagination
--operator operator Logical operator used on filters: AND, OR.
Default: AND.
-p, --password pass User password
-p, --provider-id id Set the provider by ID to create the provision
-s, --sensitive Include sensitive values information in the
output
-s, --server url OneForm endpoint
-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.
-u, --username name User name
-V, --version Show version and copyright information
-y, --yaml Show the resource in YAML format
add-host provision_id Add one or more hosts to a provision by its ID.
The number of hosts to add is specified using the --amount (or -a) option.
If the option is not provided, the command defaults to adding a single host.
Alternatively, hosts can be added by their IP addresses using the --ips option.
This option is only valid for on-prem providers.
Examples:
oneprovision add-host 0
# Adds 1 host to the provision with ID 0 (default behavior).
oneprovision add-host 0 --amount 3
# Adds 3 hosts to the provision with ID 0.
oneprovision add-host 0 --ips 1.1.1.1,2.2.2.2
# Adds hosts with the given IPs to the provision with ID 0.
# Note: IP-based host addition is only supported for on-prem providers.
Note: --amount and --ips are mutually exclusive. Use only one of them at a time.
valid options: amount, host_ips
add-ip provision_id Add a specified number of public IP addresses to a provision.
Examples:
oneprovision add-ip 0
# Allocates 1 public IP address to the provision with ID 0 (default behavior).
oneprovision add-ip 0 --amount 4
# Allocates 4 public IP addresses to the provision with ID 0.
valid options: amount
chgrp range|provisionid_list groupid Change the group of a provision.
chmod range|provisionid_list octet Change the permissions of a provision.
chown range|provisionid_list userid [groupid] Change the owner of a provision.
create driver_name [file] Create a Provision object based on driver information. valid options: deployment, provider_id
del-host provision_id Remove hosts from a provision by its ID.
This command supports two removal modes:
1) Amount-based removal using --amount (or -a):
- Specify the number of hosts to remove from the provision (random selection)
- If --amount is not provided, it defaults to 1.
2) ID-based removal using --ids (or -i):
- Provide one or more OpenNebula host IDs, separated by commas.
Examples:
oneprovision del-host 0
# Removes 1 host from the provision with ID 0 (default behavior).
oneprovision del-host 0 --amount 3
# Removes 3 hosts from the provision with ID 0, random selection.
oneprovision del-host 5 --ids 101,102,103
# Removes the hosts with OpenNebula IDs 101, 102, and 103 from the provision with ID 5.
Note: --amount and --ids are mutually exclusive. Use only one of them at a time.
valid options: amount, force, host_ids
del-ip provision_id ar_id Removes a previously allocated public IP Address Range from a provision by AR ID.
Examples:
oneprovision del-ip 0 100
# Removes Address Range with ID 100 from the provision with ID 0.
delete range|provisionid_list Delete a Provision by ID. valid options: force
deprovision range|provisionid_list Deprovision and all the associated resources a provision by ID.
Use the --force option to force the deprovisioning even if
the provision has unmanaged resources associated.
valid options: force
list List all provisions. valid options: adjust, all, csv, csv_del, delay, describe, expand, filter, json, list, listconf, no_expand, no_header, no_pager, operator, sensitive, size, yaml
logs provision_id Show the logs of a provision by ID. valid options: all
rename provision_id name Renames the provision
retry range|provisionid_list Try to recover a provision retrying the last failed action by ID. valid options: force
show provision_id Show details of a specific provision. valid options: json, sensitive, yaml
top List the available provisions continuously valid options: delay, json, sensitive, yaml
update provision_id [file] Update a provision by ID with the provided patch data.
file Path to a file
groupid OpenNebula GROUP name or id
range List of id's in the form 1,8..15
templateid OpenNebula PROVISION name or id
templateid_list Comma-separated list of OpenNebula PROVISION names or ids
text String
userid OpenNebula USER name or id
OpenNebula 7.1.80 Copyright 2002-2025, OpenNebula Project, OpenNebula Systems