VMware: add properties option to vmware_datastore_info module (#62940)

* add_properties_option_to_vmware_datastore_info
* fix document indent error
* add changelog file for vmware_datastore_info
pull/66619/head
sky-joker 5 years ago committed by Abhijeet Kasurde
parent 7fabb28d22
commit 1befb52321

@ -0,0 +1,2 @@
minor_changes:
- vmware_datastore_info - added ``properties`` and ``schema`` options.

@ -55,6 +55,7 @@ options:
description:
- Gather mount information of NFS datastores.
- Disabled per default because this slows down the execution if you have a lot of datastores.
- Only valid when C(schema) is C(summary).
type: bool
default: false
version_added: 2.8
@ -62,9 +63,36 @@ options:
description:
- Gather mount information of VMFS datastores.
- Disabled per default because this slows down the execution if you have a lot of datastores.
- Only valid when C(schema) is C(summary).
type: bool
default: false
version_added: 2.8
schema:
description:
- Specify the output schema desired.
- The 'summary' output schema is the legacy output from the module
- The 'vsphere' output schema is the vSphere API class definition
which requires pyvmomi>6.7.1
choices: ['summary', 'vsphere']
default: 'summary'
type: str
version_added: '2.10'
properties:
description:
- Specify the properties to retrieve.
- If not specified, all properties are retrieved (deeply).
- Results are returned in a structure identical to the vsphere API.
- 'Example:'
- ' properties: ['
- ' "name",'
- ' "info.vmfs.ssd",'
- ' "capability.vsanSparseSupported",'
- ' "overallStatus"'
- ' ]'
- Only valid when C(schema) is C(vsphere).
type: list
required: False
version_added: '2.10'
extends_documentation_fragment: vmware.documentation
'''
@ -88,6 +116,21 @@ EXAMPLES = '''
name: datastore1
delegate_to: localhost
register: info
- name: Gather some info from a datastore using the vSphere API output schema
vmware_datastore_info:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter_name: '{{ datacenter_name }}'
schema: vsphere
properties:
- name
- info.vmfs.ssd
- capability.vsanSparseSupported
- overallStatus
delegate_to: localhost
register: info
'''
RETURN = """
@ -146,6 +189,8 @@ class VMwareHostDatastore(PyVmomi):
super(VMwareHostDatastore, self).__init__(module)
self.gather_nfs_mount_info = self.module.params['gather_nfs_mount_info']
self.gather_vmfs_mount_info = self.module.params['gather_vmfs_mount_info']
self.schema = self.module.params['schema']
self.properties = self.module.params['properties']
def check_datastore_host(self, esxi_host, datastore):
""" Get all datastores of specified ESXi host """
@ -163,6 +208,7 @@ class VMwareHostDatastore(PyVmomi):
""" Build list with datastores """
datastores = list()
for datastore in datastore_list:
if self.schema == 'summary':
summary = datastore.summary
datastore_summary = dict()
datastore_summary['accessible'] = summary.accessible
@ -200,6 +246,12 @@ class VMwareHostDatastore(PyVmomi):
datastores.extend([datastore_summary])
else:
datastores.extend([datastore_summary])
else:
if self.module.params['name']:
if datastore.name == self.module.params['name']:
datastores.extend(([self.to_json(datastore, self.properties)]))
else:
datastores.extend(([self.to_json(datastore, self.properties)]))
return datastores
@ -257,7 +309,9 @@ def main():
datacenter=dict(type='str', aliases=['datacenter_name']),
cluster=dict(type='str'),
gather_nfs_mount_info=dict(type='bool', default=False),
gather_vmfs_mount_info=dict(type='bool', default=False)
gather_vmfs_mount_info=dict(type='bool', default=False),
schema=dict(type='str', choices=['summary', 'vsphere'], default='summary'),
properties=dict(type='list')
)
module = AnsibleModule(argument_spec=argument_spec,
supports_check_mode=True

@ -124,3 +124,69 @@
that:
- "datastore_info_0005['datastores'][0]['name'] == ro_datastore"
- "datastore_info_0005['datastores'][0]['capacity'] is defined"
# Testcase with property specify
- name: get list of info about datastores with properties specify - no dc
vmware_datastore_info:
validate_certs: False
hostname: "{{ vcenter_hostname }}"
username: "{{ vcenter_username }}"
password: "{{ vcenter_password }}"
cluster: "{{ ccr1 }}"
schema: vsphere
properties:
- name
register: datastore_info_0006
- debug:
msg: "{{ datastore_info_0006 }}"
- assert:
that:
- "datastore_info_0006['datastores'][0]['name'] is defined"
- name: get list of info about one datastore with properties specify
vmware_datastore_info:
validate_certs: False
hostname: "{{ vcenter_hostname }}"
username: "{{ vcenter_username }}"
password: "{{ vcenter_password }}"
datacenter: "{{ dc1 }}"
name: "{{ ro_datastore }}"
schema: vsphere
properties:
- name
register: datastore_info_0007
- debug:
msg: "{{ datastore_info_0007 }}"
- assert:
that:
- "datastore_info_0007['datastores'][0]['name'] is defined"
- "datastore_info_0007['datastores'][0]['name'] == ro_datastore"
- "datastore_info_0007['datastores'] | length == 1"
- name: get list of info about datastores with multiple properties specify
vmware_datastore_info:
validate_certs: False
hostname: "{{ vcenter_hostname }}"
username: "{{ vcenter_username }}"
password: "{{ vcenter_password }}"
datacenter: "{{ dc1 }}"
name: "{{ ro_datastore }}"
schema: vsphere
properties:
- name
- capability.vsanSparseSupported
- overallStatus
register: datastore_info_0008
- debug:
msg: "{{ datastore_info_0008 }}"
- assert:
that:
- "datastore_info_0008['datastores'][0]['name'] is defined"
- "datastore_info_0008['datastores'][0]['capability']['vsanSparseSupported'] is defined"
- "datastore_info_0008['datastores'][0]['overallStatus'] is defined"

Loading…
Cancel
Save