ovirt_templates - Module to manage virtual machine templates in oVirt¶
New in version 2.3.
Requirements (on host that executes module)¶
- python >= 2.7
- ovirt-engine-sdk-python >= 4.0.0
Options¶
parameter | required | default | choices | comments |
---|---|---|---|---|
auth |
yes |
Dictionary with values needed to create HTTP/HTTPS connection to oVirt:
username [required] - The name of the user, something like `admin@internal`.
password [required] - The password of the user.
url [required] - A string containing the base URL of the server, usually something like `https://server.example.com/ovirt-engine/api`.
token - Token to be used instead of login with username/password.
insecure - A boolean flag that indicates if the server TLS certificate and host name should be checked.
ca_file - A PEM file containing the trusted CA certificates. The certificate presented by the server will be verified using these CA certificates. If `ca_file ` parameter is not set, system wide CA certificate store is used.
kerberos - A boolean flag indicating if Kerberos authentication should be used instead of the default basic authentication.
| ||
clone_permissions |
no |
If True then the permissions of the VM (only the direct ones, not the inherited ones) will be copied to the created template.
This parameter is used only when
state present.
| ||
cluster |
no |
Name of the cluster, where template should be created/imported.
| ||
cpu_profile |
no |
CPU profile to be set to template.
| ||
description |
no |
Description of the template.
| ||
exclusive |
no |
When
state is exported this parameter indicates if the existing templates with the same name should be overwritten.
| ||
export_domain |
no |
When
state is exported or imported this parameter specifies the name of the export storage domain.
| ||
image_disk |
no |
When
state is imported and image_provider is used this parameter specifies the name of disk to be imported as template.
| ||
image_provider |
no |
When
state is imported this parameter specifies the name of the image provider to be used.
| ||
name |
yes |
Name of the the template to manage.
| ||
poll_interval |
no | 3 |
Number of the seconds the module waits until another poll request on entity status is sent.
| |
state |
no | present |
|
Should the template be present/absent/exported/imported
|
storage_domain |
no |
When
state is imported this parameter specifies the name of the destination data storage domain.
| ||
timeout |
no | 180 |
The amount of time in seconds the module should wait for the instance to get into desired state.
| |
vm |
no |
Name of the VM, which will be used to create template.
| ||
wait |
no |
True if the module should wait for the entity to get into desired state.
|
Examples¶
# Examples don't contain auth parameter for simplicity, # look at ovirt_auth module to see how to reuse authentication: # Create template from vm - ovirt_templates: cluster: Default name: mytemplate vm: rhel7 cpu_profile: Default description: Test # Import template - ovirt_templates: state: imported name: mytemplate export_domain: myexport storage_domain: mystorage cluster: mycluster # Remove template - ovirt_templates: state: absent name: mytemplate
Return Values¶
Common return values are documented here common_return_values
, the following are the fields unique to this module:
name | description | returned | type | sample |
---|---|---|---|---|
id | ID of the template which is managed | On success if template is found. | str | 7de90f31-222c-436c-a1ca-7e655bd5b60c |
template | Dictionary of all the template attributes. Template attributes can be found on your oVirt instance at following url: https://ovirt.example.com/ovirt-engine/api/model#types/template. | On success if template is found. |
Notes¶
Note
In order to use this module you have to install oVirt Python SDK. To ensure it’s installed with correct version you can create the following task: pip: name=ovirt-engine-sdk-python version=4.0.0
This is an Extras Module¶
For more information on what this means please read modules_extra
For help in developing on modules, should you be so inclined, please read community
, developing_test_pr
and developing_modules
.