mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
118 lines
3.4 KiB
Python
118 lines
3.4 KiB
Python
#!/usr/bin/python
|
|
# -*- coding: utf-8 -*-
|
|
|
|
# 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
|
|
|
|
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
|
'status': ['preview'],
|
|
'supported_by': 'community'}
|
|
|
|
DOCUMENTATION = r'''
|
|
---
|
|
module: intersight_info
|
|
short_description: Gather information about Intersight
|
|
description:
|
|
- Gathers information about servers in L(Cisco Intersight,https://intersight.com).
|
|
- This module was called C(intersight_facts) before Ansible 2.9. The usage did not change.
|
|
extends_documentation_fragment:
|
|
- cisco.intersight.intersight
|
|
|
|
options:
|
|
server_names:
|
|
description:
|
|
- Server names to retrieve information from.
|
|
- An empty list will return all servers.
|
|
type: list
|
|
required: yes
|
|
author:
|
|
- David Soper (@dsoper2)
|
|
- CiscoUcs (@CiscoUcs)
|
|
'''
|
|
|
|
EXAMPLES = r'''
|
|
- name: Get info for all servers
|
|
intersight_info:
|
|
api_private_key: ~/Downloads/SecretKey.txt
|
|
api_key_id: 64612d300d0982/64612d300d0b00/64612d300d3650
|
|
server_names:
|
|
- debug:
|
|
msg: "server name {{ item.Name }}, moid {{ item.Moid }}"
|
|
loop: "{{ intersight_servers }}"
|
|
when: intersight_servers is defined
|
|
|
|
- name: Get info for servers by name
|
|
intersight_info:
|
|
api_private_key: ~/Downloads/SecretKey.txt
|
|
api_key_id: 64612d300d0982/64612d300d0b00/64612d300d3650
|
|
server_names:
|
|
- SJC18-L14-UCS1-1
|
|
- debug:
|
|
msg: "server moid {{ intersight_servers[0].Moid }}"
|
|
when: intersight_servers[0] is defined
|
|
'''
|
|
|
|
RETURN = r'''
|
|
intersight_servers:
|
|
description: A list of Intersight Servers. See L(Cisco Intersight,https://intersight.com/apidocs) for details.
|
|
returned: always
|
|
type: complex
|
|
contains:
|
|
Name:
|
|
description: The name of the server.
|
|
returned: always
|
|
type: str
|
|
sample: SJC18-L14-UCS1-1
|
|
Moid:
|
|
description: The unique identifier of this Managed Object instance.
|
|
returned: always
|
|
type: str
|
|
sample: 5978bea36ad4b000018d63dc
|
|
'''
|
|
|
|
from ansible_collections.cisco.intersight.plugins.module_utils.intersight import IntersightModule, intersight_argument_spec
|
|
from ansible.module_utils.basic import AnsibleModule
|
|
|
|
|
|
def get_servers(module, intersight):
|
|
query_list = []
|
|
if module.params['server_names']:
|
|
for server in module.params['server_names']:
|
|
query_list.append("Name eq '%s'" % server)
|
|
query_str = ' or '.join(query_list)
|
|
options = {
|
|
'http_method': 'get',
|
|
'resource_path': '/compute/PhysicalSummaries',
|
|
'query_params': {
|
|
'$filter': query_str,
|
|
'$top': 5000
|
|
}
|
|
}
|
|
response_dict = intersight.call_api(**options)
|
|
|
|
return response_dict.get('Results')
|
|
|
|
|
|
def main():
|
|
argument_spec = intersight_argument_spec
|
|
argument_spec.update(
|
|
server_names=dict(type='list', required=True),
|
|
)
|
|
|
|
module = AnsibleModule(
|
|
argument_spec,
|
|
supports_check_mode=True,
|
|
)
|
|
if module._name in ('intersight_facts', 'community.general.intersight_facts'):
|
|
module.deprecate("The 'intersight_facts' module has been renamed to 'intersight_info'", version='2.13')
|
|
|
|
intersight = IntersightModule(module)
|
|
|
|
# one API call returning all requested servers
|
|
module.exit_json(intersight_servers=get_servers(module, intersight))
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|