Модуль community.general.idrac_redfish_config — управление серверами через iDRAC с помощью API Dell Redfish

Примечание

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

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

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

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

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

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

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

Параметры

Параметр	Комментарии
auth_token string добавлено в community.general 2.3.0	Токен безопасности для аутентификации в iDRAC.
baseuri string / обязательный	Базовый URI iDRAC.
ca_path path добавлено в community.general 10.6.0	Файл в формате PEM, содержащий сертификат CA для проверки. Используется, только если `validate_certs=true`.
category string / обязательный	Категория для выполнения на iDRAC.
ciphers list / элементы=string добавлено в community.general 10.6.0	Шифры TLS/SSL для использования при запросе. Если указан список, все шифры объединяются по порядку с помощью `:`. Подробности см. в разделе Формат списка шифров OpenSSL. Доступные шифры зависят от версий Python и OpenSSL/LibreSSL.
command list / элементы=string / обязательный	Список команд для выполнения на iDRAC. `SetManagerAttributes`, `SetLifecycleControllerAttributes` и `SetSystemAttributes` являются взаимоисключающими командами, если `category` имеет значение `Manager`.
manager_attributes dictionary добавлено в community.general 0.2.0	Словарь пар «имя атрибута iDRAC — значение» для обновления. По умолчанию: `{}`
password string	Пароль для аутентификации в iDRAC.
resource_id string добавлено в community.general 0.2.0	Идентификатор System, Manager или Chassis для изменения.
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	Поддержка: нет	В режиме diff возвращает сведения об изменениях (или о возможных изменениях в `check_mode`).

Примеры

- name: Enable NTP and set NTP server and Time zone attributes in iDRAC
  community.general.idrac_redfish_config:
    category: Manager
    command: SetManagerAttributes
    resource_id: iDRAC.Embedded.1
    manager_attributes:
      NTPConfigGroup.1.NTPEnable: "Enabled"
      NTPConfigGroup.1.NTP1: "{{ ntpserver1 }}"
      Time.1.Timezone: "{{ timezone }}"
    baseuri: "{{ baseuri }}"
    username: "{{ username}}"
    password: "{{ password }}"

- name: Enable Syslog and set Syslog servers in iDRAC
  community.general.idrac_redfish_config:
    category: Manager
    command: SetManagerAttributes
    resource_id: iDRAC.Embedded.1
    manager_attributes:
      SysLog.1.SysLogEnable: "Enabled"
      SysLog.1.Server1: "{{ syslog_server1 }}"
      SysLog.1.Server2: "{{ syslog_server2 }}"
    baseuri: "{{ baseuri }}"
    username: "{{ username}}"
    password: "{{ password }}"

- name: Configure SNMP community string, port, protocol and trap format
  community.general.idrac_redfish_config:
    category: Manager
    command: SetManagerAttributes
    resource_id: iDRAC.Embedded.1
    manager_attributes:
      SNMP.1.AgentEnable: "Enabled"
      SNMP.1.AgentCommunity: "public_community_string"
      SNMP.1.TrapFormat: "SNMPv1"
      SNMP.1.SNMPProtocol: "All"
      SNMP.1.DiscoveryPort: 161
      SNMP.1.AlertPort: 162
    baseuri: "{{ baseuri }}"
    username: "{{ username}}"
    password: "{{ password }}"

- name: Enable CSIOR
  community.general.idrac_redfish_config:
    category: Manager
    command: SetLifecycleControllerAttributes
    resource_id: iDRAC.Embedded.1
    manager_attributes:
      LCAttributes.1.CollectSystemInventoryOnRestart: "Enabled"
    baseuri: "{{ baseuri }}"
    username: "{{ username}}"
    password: "{{ password }}"

- name: Set Power Supply Redundancy Policy to A/B Grid Redundant
  community.general.idrac_redfish_config:
    category: Manager
    command: SetSystemAttributes
    resource_id: iDRAC.Embedded.1
    manager_attributes:
      ServerPwr.1.PSRedPolicy: "A/B Grid Redundant"
    baseuri: "{{ baseuri }}"
    username: "{{ username}}"
    password: "{{ password }}"

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

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

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

Авторы

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_config_module.html