VMware: New module vmware_drs_group_facts (#50649)

* Added new vmware module for gathering facts for DRS groups
* Update lib/ansible/modules/cloud/vmware/vmware_drs_group_facts.py
* Updated doc
* Fixed integration test with mutual exclusive paramteres

Co-Authored-By: karstenjakobsen <karsten@karstenjakobsen.dk>

test/integration/targets/vmware_drs_group_facts/aliases

@@ -0,0 +1,2 @@
+shippable/vcenter/group1
+cloud/vcenter

test/integration/targets/vmware_drs_group_facts/tasks/main.yml

@@ -0,0 +1,65 @@
+# Test code for the vmware_drs_group_facts module
+# Copyright: (c) 2018, Karsten Kaj Jakobsen <kj@patientsky.com>
+# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+
+- name: store the vcenter container ip
+  set_fact:
+    vcsim: "{{ lookup('env', 'vcenter_host') }}"
+- debug: var=vcsim
+
+- name: Wait for Flask controller to come up online
+  wait_for:
+    host: "{{ vcsim }}"
+    port: 5000
+    state: started
+
+- name: kill vcsim
+  uri:
+    url: http://{{ vcsim }}:5000/killall
+
+- name: start vcsim
+  uri:
+    url: http://{{ vcsim }}:5000/spawn?cluster=2
+  register: vcsim_instance
+
+- name: Wait for Flask controller to come up online
+  wait_for:
+    host: "{{ vcsim }}"
+    port: 443
+    state: started
+
+- debug: var=vcsim_instance
+
+- name: Gather DRS group facts from given cluster
+  vmware_drs_group_facts:
+    hostname: "{{ vcsim }}"
+    username: "{{ vcsim_instance['json']['username'] }}"
+    password: "{{ vcsim_instance['json']['password'] }}"
+    cluster_name: DC0_C0
+    validate_certs: False
+  register: drs_group_0001_results
+
+- debug: var=drs_group_0001_results
+
+- assert:
+    that:
+      - "drs_group_0001_results.drs_group_facts.DC0_C0 is defined"
+      - "not drs_group_0001_results.drs_group_facts.DC0_C1 is defined"
+      - "not drs_group_0001_results.changed"
+
+- name: Gather DRS group facts from given datacenter
+  vmware_drs_group_facts:
+    hostname: "{{ vcsim }}"
+    username: "{{ vcsim_instance['json']['username'] }}"
+    password: "{{ vcsim_instance['json']['password'] }}"
+    datacenter: DC0
+    validate_certs: False
+  register: drs_group_0002_results
+
+- debug: var=drs_group_0002_results
+
+- assert:
+    that:
+      - "drs_group_0002_results.drs_group_facts.DC0_C0 is defined"
+      - "drs_group_0002_results.drs_group_facts.DC0_C1 is defined"
+      - "not drs_group_0002_results.changed"