dellemc.openmanage.redfish_firmware – Выполнение обновления встроенного ПО компонента с использованием файла образа, доступного в локальной или удаленной системе

Примечание

Этот плагин является частью коллекции dellemc.openmanage (версия 3.0.0).

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

Для использования в playbook, укажите: dellemc.openmanage.redfish_firmware.

Новое в версии 2.1.0: dellemc.openmanage

Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Этот модуль позволяет обновлять встроенное ПО только одного компонента за раз. Если модуль запущен для более чем одного компонента, возвращается сообщение об ошибке.
В зависимости от компонента обновление встроенного ПО применяется после автоматической или ручной перезагрузки.

Требования

Ниже указаны требования, необходимые на хосте, который выполняет этот модуль.

python >= 2.7.5
urllib3

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
baseuri строка / обязательно		IP-адрес целевого внешнего контроллера. Например - <ipaddress>:<port>.
image_uri строка / обязательно		URI местоположения образа встроенного ПО или локальный путь. Например - http://<web_address>/components.exe или /home/firmware_repo/component.exe.
password строка / обязательно		Пароль целевого внешнего контроллера.
transfer_protocol строка	Варианты: CIFS FTP HTTP ← HTTPS NSF OEM SCP SFTP TFTP	Протокол, используемый для передачи файла образа встроенного ПО. Применимо для обновления на основе URI.
username строка / обязательно		Имя пользователя целевого внешнего контроллера.

Примечания

Примечание

Запустите этот модуль из системы, имеющей прямой доступ к API Redfish.
Этот модуль не поддерживает check_mode.

Примеры

---
- name: Update the firmware from a single executable file available in a HTTP protocol
  dellemc.openmanage.redfish_firmware:
    baseuri: "192.168.0.1"
    username: "user_name"
    password: "user_password"
    image_uri: "http://192.168.0.2/firmware_repo/component.exe"
    transfer_protocol: "HTTP"

- name: Update the firmware from a single executable file available in a local path
  dellemc.openmanage.redfish_firmware:
    baseuri: "192.168.0.1"
    username: "user_name"
    password: "user_password"
    image_uri: "/home/firmware_repo/component.exe"

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

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

Ключ	Возвращается	Описание
error_info словарь	при ошибке http	Подробности об ошибке http. Пример: {'error': {'@Message.ExtendedInfo': [{'Message': 'Unable to complete the operation because the JSON data format entered is invalid.', 'Resolution': 'Do the following and the retry the operation: 1) Enter the correct JSON data format and retry the operation. 2) Make sure that no syntax error is present in JSON data format. 3) Make sure that a duplicate key is not present in JSON data format.', 'Severity': 'Critical'}, {'Message': 'The request body submitted was malformed JSON and could not be parsed by the receiving service.', 'Resolution': 'Ensure that the request body is valid JSON and resubmit the request.', 'Severity': 'Critical'}], 'code': 'Base.1.2.GeneralError', 'message': 'A general error has occurred. See ExtendedInfo for more information.'}}
msg строка	всегда	Общее состояние задачи обновления встроенного ПО. Пример: Задача обновления встроенного ПО успешно отправлена.
task словарь	успех	Возвращает ID и URI созданной задачи. Пример: {'id': 'JID_XXXXXXXXXXXX', 'uri': '/redfish/v1/TaskService/Tasks/JID_XXXXXXXXXXXX'}

Авторы

Felix Stephen (@felixs88)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/dellemc/openmanage/redfish_firmware_module.html