#!/usr/bin/python # Copyright (c) 2016-2017 Hewlett Packard Enterprise Development LP # GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt) # SPDX-License-Identifier: GPL-3.0-or-later from __future__ import annotations DOCUMENTATION = r""" module: oneview_datacenter_info short_description: Retrieve information about the OneView Data Centers description: - Retrieve information about the OneView Data Centers. requirements: - "hpOneView >= 2.0.1" author: - Alex Monteiro (@aalexmonteiro) - Madhav Bharadwaj (@madhav-bharadwaj) - Priyanka Sood (@soodpr) - Ricardo Galeno (@ricardogpsf) attributes: check_mode: version_added: 3.3.0 # This was backported to 2.5.4 and 1.3.11 as well, since this was a bugfix options: name: description: - Data Center name. type: str options: description: - 'Retrieve additional information. Options available: V(visualContent).' type: list elements: str extends_documentation_fragment: - community.general.oneview - community.general.oneview.factsparams - community.general.attributes - community.general.attributes.info_module """ EXAMPLES = r""" - name: Gather information about all Data Centers community.general.oneview_datacenter_info: hostname: 172.16.101.48 username: administrator password: my_password api_version: 500 delegate_to: localhost register: result - name: Print fetched information about Data Centers ansible.builtin.debug: msg: "{{ result.datacenters }}" - name: Gather paginated, filtered and sorted information about Data Centers community.general.oneview_datacenter_info: hostname: 172.16.101.48 username: administrator password: my_password api_version: 500 params: start: 0 count: 3 sort: 'name:descending' filter: 'state=Unmanaged' register: result - name: Print fetched information about paginated, filtered and sorted list of Data Centers ansible.builtin.debug: msg: "{{ result.datacenters }}" - name: Gather information about a Data Center by name community.general.oneview_datacenter_info: hostname: 172.16.101.48 username: administrator password: my_password api_version: 500 name: "My Data Center" delegate_to: localhost register: result - name: Print fetched information about Data Center found by name ansible.builtin.debug: msg: "{{ result.datacenters }}" - name: Gather information about the Data Center Visual Content community.general.oneview_datacenter_info: hostname: 172.16.101.48 username: administrator password: my_password api_version: 500 name: "My Data Center" options: - visualContent delegate_to: localhost register: result - name: Print fetched information about Data Center found by name ansible.builtin.debug: msg: "{{ result.datacenters }}" - name: Print fetched information about Data Center Visual Content ansible.builtin.debug: msg: "{{ result.datacenter_visual_content }}" """ RETURN = r""" datacenters: description: Has all the OneView information about the Data Centers. returned: Always, but can be null. type: dict datacenter_visual_content: description: Has information about the Data Center Visual Content. returned: When requested, but can be null. type: dict """ from ansible_collections.community.general.plugins.module_utils.oneview import OneViewModuleBase class DatacenterInfoModule(OneViewModuleBase): argument_spec = dict(name=dict(type="str"), options=dict(type="list", elements="str"), params=dict(type="dict")) def __init__(self): super().__init__( additional_arg_spec=self.argument_spec, supports_check_mode=True, ) def execute_module(self): client = self.oneview_client.datacenters info = {} if self.module.params.get("name"): datacenters = client.get_by("name", self.module.params["name"]) if self.options and "visualContent" in self.options: if datacenters: info["datacenter_visual_content"] = client.get_visual_content(datacenters[0]["uri"]) else: info["datacenter_visual_content"] = None info["datacenters"] = datacenters else: info["datacenters"] = client.get_all(**self.facts_params) return dict(changed=False, **info) def main(): DatacenterInfoModule().run() if __name__ == "__main__": main()