cisco.ucs.ucs_query 模块 – 通过类或可分辨名称查询 UCS Manager 对象

注意

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

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

要安装它，请使用： ansible-galaxy collection install cisco.ucs。您需要其他要求才能使用此模块，请参阅要求以了解详细信息。

要在 playbook 中使用它，请指定：cisco.ucs.ucs_query。

概要 

- 通过类或可分辨名称查询 UCS Manager 对象。

要求 

执行此模块的主机需要以下要求。

ucsmsdk

参数 

参数	注释
class_ids 字符串	要查询的一个或多个 UCS Manager 类 ID。作为逗号分隔的列表
delegate_to 字符串	模块将在哪里运行默认值： `"localhost"`
distinguished_names 字符串	要查询的一个或多个 UCS Manager 可分辨名称。作为逗号分隔的列表
hostname 字符串 / 必选	Cisco UCS Manager 的 IP 地址或主机名。模块可以与 UCS 平台模拟器一起使用 https://cs.co/ucspe
password 字符串 / 必选	用于 Cisco UCS Manager 身份验证的密码。
port 整数	连接期间要使用的端口号（默认情况下，https 使用 443，http 连接使用 80）。
proxy 字符串	如果 use_proxy 为 no，则指定用于连接的代理。例如，‘http://proxy.xy.z:8080’
use_proxy 布尔值	如果 `no`，则不会使用系统环境变量定义的代理。选项 `false` `true` ← (默认)
use_ssl 布尔值	如果 `no`，将使用 HTTP 连接而不是默认的 HTTPS 连接。选项 `false` `true` ← (默认)
username 字符串	用于 Cisco UCS Manager 身份验证的用户名。默认值： `"admin"`

示例 

- name: Query UCS Class ID
  cisco.ucs.ucs_query:
    hostname: "{{ ucs_hostname }}"
    username: "{{ ucs_username }}"
    password: "{{ ucs_password }}"
    class_ids: computeBlade
    delegate_to: localhost

- name: Query UCS Class IDs
  cisco.ucs.ucs_query:
    hostname: "{{ ucs_hostname }}"
    username: "{{ ucs_username }}"
    password: "{{ ucs_password }}"
    class_ids: computeBlade, fabricVlan
    delegate_to: localhost

- name: Query UCS Distinguished Name
  cisco.ucs.ucs_query:
    hostname: "{{ ucs_hostname }}"
    username: "{{ ucs_username }}"
    password: "{{ ucs_password }}"
    distinguished_names: org-root
    delegate_to: localhost

- name: Query UCS Distinguished Names
  cisco.ucs.ucs_query:
    hostname: "{{ ucs_hostname }}"
    username: "{{ ucs_username }}"
    password: "{{ ucs_password }}"
    distinguished_names: org-root, sys/rack-unit-1, sys/chassis-1/blade-2
    delegate_to: localhost

返回值 

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

键	描述
objects 字典	结果 JSON 编码返回：总是

作者

John McDonough (@movinalot)
CiscoUcs (@CiscoUcs)