cisco.intersight.intersight_info – Gather information about Intersight

Note

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

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

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. If not set, the value of the INTERSIGHT_API_KEY_ID environment variable is used.
api_private_key string / required		Filename (absolute path) or string of PEM formatted private key data to be used for Intersight API authentication. If a string is used, Ansible vault should be used to encrypt string data. Ex. ansible-vault encrypt_string --vault-id tme@/Users/dsoper/Documents/vault_password_file '-----BEGIN EC PRIVATE KEY----- <your private key data> -----END EC PRIVATE KEY-----' If not set, the value of the INTERSIGHT_API_PRIVATE_KEY environment variable is used.
api_uri string	Default: "https://intersight.com/api/v1"	URI used to access the Intersight API. If not set, the value of the INTERSIGHT_API_URI environment variable is used.
server_names list / elements=string / required		Server names to retrieve information from. An empty list will return all servers.
use_proxy boolean	Choices: 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	Choices: 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/intersight/intersight_info_module.html