Documentation

vmware_datacenter - Manage VMware vSphere Datacenters

New in version 2.0.

Synopsis

  • Manage VMware vSphere Datacenters

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.

Support

This module is community maintained without core committer oversight.

For more information on what this means please read Module Support

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