one_host – Manages OpenNebula Hosts
one_host – Manages OpenNebula Hosts
New in version 2.6.
Synopsis
- Manages OpenNebula Hosts
Requirements
The below requirements are needed on the host that executes this module.
- pyone
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
api_password string |
The password or token for XMLRPC authentication. If not specified then the value of the ONE_PASSWORD environment variable, if any, is used.
| |
api_url string |
The ENDPOINT URL of the XMLRPC server. If not specified then the value of the ONE_URL environment variable, if any, is used.
| |
api_username string |
The name of the user for XMLRPC authentication. If not specified then the value of the ONE_USERNAME environment variable, if any, is used. | |
cluster_id - |
Default: 0 |
The cluster ID. |
cluster_name - |
The cluster specified by name. | |
im_mad_name - |
Default: "kvm" |
The name of the information manager, this values are taken from the oned.conf with the tag name IM_MAD (name) |
labels - |
The labels for this host. | |
name - / required |
Hostname of the machine to manage. | |
state - |
|
Takes the host to the desired lifecycle state. If If If
|
template - |
The template or attribute changes to merge into the host template.
| |
validate_certs boolean |
|
Whether to validate the SSL certificates or not. This parameter is ignored if PYTHONHTTPSVERIFY environment variable is used. |
vmm_mad_name - |
Default: "kvm" |
The name of the virtual machine manager mad name, this values are taken from the oned.conf with the tag name VM_MAD (name) |
wait_timeout integer |
Default: 300 |
Time to wait for the desired state to be reached before timeout, in seconds. |
Examples
- name: Create a new host in OpenNebula
one_host:
name: host1
cluster_id: 1
api_url: http://127.0.0.1:2633/RPC2
- name: Create a host and adjust its template
one_host:
name: host2
cluster_name: default
template:
LABELS:
- gold
- ssd
RESERVED_CPU: -100
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Rafael del Valle (@rvalle)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/one_host_module.html