cisco.intersight.intersight_info 模块 – 收集关于 Intersight 的信息

注意

此模块是 cisco.intersight 集合 (版本 2.0.20) 的一部分。

如果您使用的是 ansible 软件包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install cisco.intersight。

要在 playbook 中使用它，请指定：cisco.intersight.intersight_info。

概要

• 收集关于 Cisco Intersight 中服务器的信息。

• 在 Ansible 2.9 之前，此模块称为 intersight_facts。使用方法没有改变。

参数

参数	注释
api_key_id 字符串 / 必填	与私钥关联的公共 API 密钥 ID。 如果未设置，则使用 INTERSIGHT_API_KEY_ID 环境变量的值。
api_private_key 路径 / 必填	用于 Intersight API 身份验证的 PEM 格式私钥数据的文件名（绝对路径）或字符串。 如果使用字符串，则应使用 Ansible vault 加密字符串数据。 例如：ansible-vault encrypt_string –vault-id ‘—–BEGIN EC PRIVATE KEY—–’ <您的私钥数据> —–END EC PRIVATE KEY—–’ 如果未设置，则使用 INTERSIGHT_API_PRIVATE_KEY 环境变量的值。
api_uri 字符串	用于访问 Intersight API 的 URI。 如果未设置，则使用 INTERSIGHT_API_URI 环境变量的值。 默认值： "https://intersight.com/api/v1"
server_names 列表 / 元素=字符串	要从中检索信息的服务器名称。 空列表将返回所有服务器。
use_proxy 布尔值	如果为 no，即使在目标主机上的环境变量中定义了代理，它也不会使用代理。 选项 false true ← (默认)
validate_certs 布尔值	用于验证 api_uri TLS 证书的布尔值控制 选项 false true ← (默认)

示例

- 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

返回值

常见的返回值已在 此处 记录，以下是此模块特有的字段

键	描述
intersight_servers 复杂类型	Intersight 服务器列表。详情请参见 Cisco Intersight。 返回： 始终
Moid 字符串	此托管对象实例的唯一标识符。 返回： 始终 示例： "5978bea36ad4b000018d63dc"
名称 字符串	服务器的名称。 返回： 始终 示例： "SJC18-L14-UCS1-1"

作者

• David Soper (@dsoper2)

• CiscoUcs (@CiscoUcs)

集合链接

• 问题追踪器
• 仓库 (源代码)