community.general.wdc_redfish_info 模块 – 使用 Redfish API 管理 WDC UltraStar Data102 带外控制器

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

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

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

要在 playbook 中使用它，请指定：community.general.wdc_redfish_info。

community.general 5.4.0 中的新增功能

概要 

在本地构建 Redfish URI 并将其发送到远程带外控制器以获取信息。

参数 

参数	注释
auth_token 字符串	用于与带外控制器进行身份验证的安全令牌。
baseuri 字符串	带外控制器的基本 URI。必须包含此项或 `ioms`。
category 字符串 / 必需	在带外控制器上执行的类别。
command 列表 / 元素=字符串 / 必需	要在带外控制器上执行的命令列表。
ioms 列表 / 元素=字符串	机箱的 IOM FQDN 列表。必须包含此项或 `baseuri`。
password 字符串	用于与带外控制器进行身份验证的密码。
timeout 整数	对带外控制器的 URL 请求的超时时间（秒）。默认： `10`
username 字符串	用于与带外控制器进行身份验证的用户。

属性 

属性	支持	描述
check_mode	支持：完全支持此操作不会修改状态。	可以在 `check_mode` 中运行，并在不修改目标的情况下返回更改状态预测。
diff_mode	支持： N/A 此操作不会修改状态。	在差异模式下，将返回有关已更改内容（或可能需要在 `check_mode` 中更改的内容）的详细信息。

备注 

注意

在清单中，您可以指定 baseuri 或 ioms。请参阅示例部分。
ioms 是机箱 IOM 的 FQDN 列表。

示例 

- name: Get Simple Update Status with individual IOMs specified
  community.general.wdc_redfish_info:
    category: Update
    command: SimpleUpdateStatus
    ioms:
      - iom1.wdc.com
      - iom2.wdc.com
    username: "{{ username }}"
    password: "{{ password }}"
  register: result

- name: Print fetched information
  ansible.builtin.debug:
    msg: "{{ result.redfish_facts.simple_update_status.entries | to_nice_json }}"

- name: Get Simple Update Status with baseuri specified
  community.general.wdc_redfish_info:
    category: Update
    command: SimpleUpdateStatus
    baseuri: "iom1.wdc.com"
    username: "{{ username }}"
    password: "{{ password }}"
  register: result

- name: Print fetched information
  ansible.builtin.debug:
    msg: "{{ result.redfish_facts.simple_update_status.entries | to_nice_json }}"

返回值 

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

键	描述
描述字符串	固件更新状态描述。返回：始终示例： `"Ready for FW update"`
ErrorCode 整数	固件更新状态的数字错误代码。非零表示错误情况。返回：始终示例： `0`
EstimatedRemainingMinutes 整数	固件更新操作中剩余的估计分钟数。返回：始终示例： `20`
StatusCode 整数	固件更新状态代码。返回：始终示例： `2`

作者

Mike Moerk (@mikemoerk)