W3cubDocs

/Ansible

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–2017 Michael DeHaan
© 2017 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/vmware_datacenter_module.html