ansible / ansible.builtin / v2.8.15 / module / vmware_drs_group_facts Gathers facts about DRS VM/Host groups on the given cluster | "added in version" 2.8 of ansible.builtin" Authors: Karsten Kaj Jakobsen (@karstenjakobsen) preview | supported by communityansible.builtin.vmware_drs_group_facts (v2.8.15) — module
pip
Install with pip install ansible==2.8.15
This module can be used to gather facts about DRS VM/HOST groups from the given cluster.
--- - name: "Gather DRS facts about given Cluster" register: cluster_drs_group_facts vmware_drs_group_facts: hostname: "{{ vcenter_hostname }}" password: "{{ vcenter_password }}" username: "{{ vcenter_username }}" cluster_name: "{{ cluster_name }}" datacenter: "{{ datacenter }}" delegate_to: localhost
- name: "Gather DRS group facts about all clusters in given datacenter" register: cluster_drs_group_facts vmware_drs_group_facts: hostname: "{{ vcenter_hostname }}" password: "{{ vcenter_password }}" username: "{{ vcenter_username }}" datacenter: "{{ datacenter }}" delegate_to: localhost
port: default: 443 description: - The port number of the vSphere vCenter or ESXi server. - If the value is not specified in the task, the value of environment variable C(VMWARE_PORT) will be used instead. - Environment variable support added in Ansible 2.6. type: int hostname: description: - The hostname or IP address of the vSphere vCenter or ESXi server. - If the value is not specified in the task, the value of environment variable C(VMWARE_HOST) will be used instead. - Environment variable support added in Ansible 2.6. type: str password: aliases: - pass - pwd description: - The password of the vSphere vCenter or ESXi server. - If the value is not specified in the task, the value of environment variable C(VMWARE_PASSWORD) will be used instead. - Environment variable support added in Ansible 2.6. type: str username: aliases: - admin - user description: - The username of the vSphere vCenter or ESXi server. - If the value is not specified in the task, the value of environment variable C(VMWARE_USER) will be used instead. - Environment variable support added in Ansible 2.6. type: str datacenter: aliases: - datacenter_name description: - Datacenter to search for DRS VM/Host groups. required: true proxy_host: description: - Address of a proxy that will receive all HTTPS requests and relay them. - The format is a hostname or a IP. - If the value is not specified in the task, the value of environment variable C(VMWARE_PROXY_HOST) will be used instead. - This feature depends on a version of pyvmomi greater than v6.7.1.2018.12 required: false type: str proxy_port: description: - Port of the HTTP proxy that will receive all HTTPS requests and relay them. - If the value is not specified in the task, the value of environment variable C(VMWARE_PROXY_PORT) will be used instead. required: false type: int cluster_name: description: - Cluster to search for VM/Host groups. - If set, facts of DRS groups belonging this cluster will be returned. - Not needed if C(datacenter) is set. required: false validate_certs: default: true description: - Allows connection when SSL certificates are not valid. Set to C(false) when certificates are not trusted. - If the value is not specified in the task, the value of environment variable C(VMWARE_VALIDATE_CERTS) will be used instead. - Environment variable support added in Ansible 2.6. - If set to C(true), please make sure Python >= 2.7.9 is installed on the given machine. type: bool
drs_group_facts: description: Metadata about DRS group from given cluster / datacenter returned: always sample: drs_group_facts: DC0_C0: - group_name: GROUP_HOST_S01 hosts: - vm-01.zone - vm-02.zone type: host - group_name: GROUP_HOST_S02 hosts: - vm-03.zone - vm-04.zone type: host - group_name: GROUP_VM_S01 type: vm vms: - test-node01 - group_name: GROUP_VM_S02 type: vm vms: - test-node02 DC0_C1: [] type: dict