Модуль community.general.wdc_redfish_command — управление внеполосными контроллерами WDC UltraStar Data102 с помощью API Redfish

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в плейбуке, укажите: community.general.wdc_redfish_command.

Добавлено в community.general 5.4.0

Обзор
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые значения

Обзор

Формирует URI Redfish локально и отправляет их удалённым внеполосным контроллерам для выполнения действий.
Управляет прошивкой внеполосного контроллера. Например, активирует прошивку, обновляет её и активирует.

Параметры

Параметр	Комментарии
auth_token string	Токен безопасности для аутентификации на внеполосном контроллере.
baseuri string	Базовый URI внеполосного контроллера. Необходимо указать этот параметр или `ioms`.
ca_path path добавлено в community.general 10.6.0	Файл в формате PEM, содержащий сертификат центра сертификации для проверки. Используется только если `validate_certs=true`.
category string / обязательный	Категория для выполнения на внеполосном контроллере.
ciphers list / элементы=string добавлено в community.general 10.6.0	Шифры TLS/SSL, используемые для запроса. Если указано значение в виде списка, все шифры объединяются по порядку с помощью `:`. Подробнее см. в описании формата списка шифров OpenSSL. Доступные шифры зависят от версий Python и OpenSSL/LibreSSL.
command list / элементы=string / обязательный	Список команд для выполнения на внеполосном контроллере.
ioms list / элементы=string	Список полных доменных имён IOM для корпуса. Необходимо указать этот параметр или `baseuri`.
password string	Пароль для аутентификации на внеполосном контроллере.
resource_id string добавлено в community.general 5.4.0	Идентификатор изменяемого компонента, например `Enclosure`, `IOModuleAFRU`, `PowerSupplyBFRU`, `FanExternalFRU3` или `FanInternalFRU`.
timeout integer	Тайм-аут в секундах для URL-запросов к внеполосному контроллеру. По умолчанию: `10`
update_creds dictionary	Учётные данные для получения образа обновления.
password string	Пароль для получения образа обновления.
username string	Имя пользователя для получения образа обновления.
update_image_uri string	URI образа для обновления.
username string	Имя пользователя для аутентификации на внеполосном контроллере.
validate_certs boolean добавлено в community.general 10.6.0	Если `false`, сертификаты TLS/SSL не проверяются. Установите значение `true`, чтобы включить проверку сертификатов. Следует использовать вместе с `ca_path`. Варианты: `false` ← (по умолчанию) `true`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевой объект.
diff_mode	Поддержка: нет	В режиме diff возвращает сведения об изменениях (или о возможных изменениях в `check_mode`).

Примечания

Примечание

В инвентаре можно указать baseuri или ioms. См. раздел ПРИМЕРЫ.
Ioms — это список полных доменных имён IOM корпуса.

Примеры

- name: Firmware Activate (required after SimpleUpdate to apply the new firmware)
  community.general.wdc_redfish_command:
    category: Update
    command: FWActivate
    ioms: "{{ ioms }}"
    username: "{{ username }}"
    password: "{{ password }}"

- name: Firmware Activate with individual IOMs specified
  community.general.wdc_redfish_command:
    category: Update
    command: FWActivate
    ioms:
      - iom1.wdc.com
      - iom2.wdc.com
    username: "{{ username }}"
    password: "{{ password }}"

- name: Firmware Activate with baseuri specified
  community.general.wdc_redfish_command:
    category: Update
    command: FWActivate
    baseuri: "iom1.wdc.com"
    username: "{{ username }}"
    password: "{{ password }}"


- name: Update and Activate (orchestrates firmware update and activation with a single command)
  community.general.wdc_redfish_command:
    category: Update
    command: UpdateAndActivate
    ioms: "{{ ioms }}"
    username: "{{ username }}"
    password: "{{ password }}"
    update_image_uri: "{{ update_image_uri }}"
    update_creds:
      username: operator
      password: supersecretpwd

- name: Turn on enclosure indicator LED
  community.general.wdc_redfish_command:
    category: Chassis
    resource_id: Enclosure
    command: IndicatorLedOn
    username: "{{ username }}"
    password: "{{ password }}"

- name: Turn off IOM A indicator LED
  community.general.wdc_redfish_command:
    category: Chassis
    resource_id: IOModuleAFRU
    command: IndicatorLedOff
    username: "{{ username }}"
    password: "{{ password }}"

- name: Turn on Power Supply B indicator LED
  community.general.wdc_redfish_command:
    category: Chassis
    resource_id: PowerSupplyBFRU
    command: IndicatorLedOn
    username: "{{ username }}"
    password: "{{ password }}"

- name: Turn on External Fan 3 indicator LED
  community.general.wdc_redfish_command:
    category: Chassis
    resource_id: FanExternalFRU3
    command: IndicatorLedOn
    username: "{{ username }}"
    password: "{{ password }}"

- name: Turn on Internal Fan indicator LED
  community.general.wdc_redfish_command:
    category: Chassis
    resource_id: FanInternalFRU
    command: IndicatorLedOn
    username: "{{ username }}"
    password: "{{ password }}"

- name: Set chassis to Low Power Mode
  community.general.wdc_redfish_command:
    category: Chassis
    resource_id: Enclosure
    command: PowerModeLow

- name: Set chassis to Normal Power Mode
  community.general.wdc_redfish_command:
    category: Chassis
    resource_id: Enclosure
    command: PowerModeNormal

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:

Ключ	Описание
msg string	Сообщение с результатом действия или описанием ошибки. Возвращается: всегда Пример: `"Action was successful"`

Авторы

Mike Moerk (@mikemoerk)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/wdc_redfish_command_module.html