Docs4dev
Docs
ansible / 2.4 / vmware_datacenter_module.html

vmware_datacenter - Manage VMware vSphere Datacenters

New in version 2.0.

Synopsis

  • Manage VMware vSphere Datacenters

Requirements (on host that executes module)

  • python >= 2.6
  • PyVmomi

Options

parameter required default choices comments
datacenter_name
 yes
The name of the datacenter the cluster will be created in.
hostname
 yes
The hostname or IP address of the vSphere vCenter API server
password
 yes
The password of the vSphere vCenter
aliases: pass, pwd
state
 no present
  • present
  • absent
If the datacenter should be present or absent
username
 yes
The username of the vSphere vCenter
aliases: user, admin
validate_certs
 no True
  • True
  • False
Allows connection when SSL certificates are not valid. Set to false when certificates are not trusted.

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

Notes

Note

  • Tested on vSphere 6.0

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/vmware_datacenter_module.html