File: //lib/python3.9/site-packages/ansible_collections/vmware/vmware_rest/plugins/lookup/cluster_moid.py
# Copyright: (c) 2021, Alina Buzachis <@alinabuzachis>
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
from __future__ import absolute_import, division, print_function
__metaclass__ = type
DOCUMENTATION = r"""
name: cluster_moid
short_description: Look up MoID for vSphere cluster objects using vCenter REST API
description:
- Returns Managed Object Reference (MoID) of the vSphere cluster object contained in the specified path.
author:
- Alina Buzachis (@alinabuzachis)
version_added: 2.1.0
requirements:
- vSphere 7.0.2 or greater
- python >= 3.6
- aiohttp
extends_documentation_fragment:
- vmware.vmware_rest.moid
"""
EXAMPLES = r"""
# lookup sample
- name: set connection info
ansible.builtin.set_fact:
connection_args:
vcenter_hostname: "vcenter.test"
vcenter_username: "[email protected]"
vcenter_password: "1234"
- name: lookup MoID of the object
ansible.builtin.debug: msg="{{ lookup('vmware.vmware_rest.cluster_moid', '/my_dc/host/my_cluster', **connection_args) }}"
- name: lookup MoID of the object inside the path
ansible.builtin.debug: msg="{{ lookup('vmware.vmware_rest.cluster_moid', '/my_dc/host/') }}"
"""
RETURN = r"""
_raw:
description: MoID of the vSphere cluster object
type: str
sample: domain-c1007
"""
from ansible_collections.vmware.vmware_rest.plugins.plugin_utils.lookup import (
Lookup,
get_credentials,
)
from ansible_collections.cloud.common.plugins.plugin_utils.turbo.lookup import (
TurboLookupBase as LookupBase,
)
class LookupModule(LookupBase):
async def _run(self, terms, variables, **kwargs):
self.set_options(var_options=variables, direct=get_credentials(**kwargs))
self.set_option("object_type", "cluster")
result = await Lookup.entry_point(terms, self._options)
return [result]
run = _run if not hasattr(LookupBase, "run_on_daemon") else LookupBase.run_on_daemon