vmware_datacenter - Manage VMware vSphere Datacenters
New in version 2.0.
Synopsis
- Manage VMware vSphere Datacenters
Requirements
The below requirements are needed on the host that executes this module.
- python >= 2.6
- PyVmomi
Parameters
| Parameter | Choices/Defaults | Comments |
|---|---|---|
| datacenter_name
required
|
The name of the datacenter the cluster will be created in.
|
|
| hostname
required
|
The hostname or IP address of the vSphere vCenter API server
|
|
| password
required
|
The password of the vSphere vCenter
aliases: pass, pwd |
|
| port
(added in 2.5)
|
Default:
443
|
The port number of the vSphere vCenter or ESXi server.
If the value is not specified in the task, the value of environment variable
VMWARE_PORT will be used instead.
Environment variable supported added in version 2.6.
|
| state |
|
If the datacenter should be present or absent
|
| username
required
|
The username of the vSphere vCenter
aliases: user, admin |
|
| validate_certs |
True
|
Allows connection when SSL certificates are not valid. Set to
false when certificates are not trusted.
If the value is not specified in the task, the value of environment variable
VMWARE_VALIDATE_CERTS will be used instead.
Environment variable supported added in version 2.6.
|
Notes
Note
- Tested on vSphere 6.0
Examples
# Example vmware_datacenter command from Ansible Playbooks
- name: Create Datacenter
local_action:
module: vmware_datacenter
hostname: "{{ ansible_ssh_host }}"
username: root
password: vmware
datacenter_name: "datacenter"
state: present
Status
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Author
- Joseph Callen (@jcpowermac), Kamil Szczygiel (@kamsz)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/vmware_datacenter_module.html