cisco.intersight.intersight_info – Gather information about Intersight

cisco.intersight.intersight_info – Gather information about Intersight

Note

This plugin is part of the cisco.intersight collection (version 1.0.9).

To install it use: ansible-galaxy collection install cisco.intersight.

To use it in a playbook, specify: cisco.intersight.intersight_info.

New in version 2.8: of cisco.intersight

• Synopsis
• Parameters
• Examples
• Return Values

Synopsis

• Gathers information about servers in Cisco Intersight.
• This module was called intersight_facts before Ansible 2.9. The usage did not change.

Parameters

Parameter	Choices/Defaults	Comments
api_key_id string / required		Public API Key ID associated with the private key.
api_private_key path / required		Filename (absolute path) of a PEM formatted file that contains your private key to be used for Intersight API authentication.
api_uri string	Default: "https://intersight.com/api/v1%22	URI used to access the Intersight API.
server_names list / elements=string / required		Server names to retrieve information from. An empty list will return all servers.
use_proxy boolean	no yes ←	If no, it will not use a proxy, even if one is defined in an environment variable on the target hosts.
validate_certs boolean	no yes ←	Boolean control for verifying the api_uri TLS certificate

Examples

- 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 Values

Common return values are documented here, the following are the fields unique to this module:

Key		Returned	Description
intersight_servers complex		always	A list of Intersight Servers. See Cisco Intersight for details.
	Moid string	always	The unique identifier of this Managed Object instance. Sample: 5978bea36ad4b000018d63dc
	Name string	always	The name of the server. Sample: SJC18-L14-UCS1-1

Authors

• David Soper (@dsoper2)
• CiscoUcs (@CiscoUcs)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/cisco/intersight/intersight_info_module.html