intersight_facts – Gather facts about Intersight

From Get docs
Ansible/docs/2.8/modules/intersight facts module


intersight_facts – Gather facts about Intersight

New in version 2.8.


Synopsis

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:

URI used to access the Intersight API.

server_names

list / required

Server names to retrieve facts 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 facts for all servers
  intersight_facts:
    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 facts for servers by name
  intersight_facts:
    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




Status

Authors

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

Hint

If you notice any issues in this documentation you can edit this document to improve it.


© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/intersight_facts_module.html