Модуль community.general.idrac_redfish_command — управление внеполосными контроллерами с помощью OEM API Redfish iDRAC

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

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

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

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

Формирует URI Redfish на локальном компьютере и отправляет их удалённым внеполосным контроллерам для выполнения действия.
Предназначен для операций с Dell iDRAC, требующих OEM-расширений Redfish.

Параметры

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

Атрибуты

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

Примеры

- name: Create BIOS configuration job (schedule BIOS setting update)
  community.general.idrac_redfish_command:
    category: Systems
    command: CreateBiosConfigJob
    resource_id: System.Embedded.1
    baseuri: "{{ baseuri }}"
    username: "{{ username }}"
    password: "{{ password }}"

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

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

Ключ	Описание
msg string	Сообщение с результатом действия или описанием ошибки. Возвращается: всегда Пример: `"Action was successful"`
return_values dictionary добавлен в community.general 6.6.0	Словарь, содержащий данные ответа, специфичные для команды, выполненной в рамках действия. Возвращается: при успешном выполнении Пример: `{"job_id": "/redfish/v1/Managers/iDRAC.Embedded.1/Jobs/JID_471269252011"}`

Авторы

Jose Delarosa (@jose-delarosa)

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

© 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/idrac_redfish_command_module.html