Модуль dellemc.openmanage.ome_device_power_settings — Настройка параметров питания шасси в OpenManage Enterprise Modular

Примечание

Этот модуль входит в коллекцию dellemc.openmanage (версия 10.0.2).

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

Чтобы установить её, используйте: ansible-galaxy collection install dellemc.openmanage. Для использования этого модуля требуются дополнительные компоненты. Подробнее см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: dellemc.openmanage.ome_device_power_settings.

Добавлено в dellemc.openmanage 4.2.0

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

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

Этот модуль позволяет настраивать параметры питания шасси в OpenManage Enterprise Modular.

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
ca_path путь добавлено в dellemc.openmanage 5.0.0	Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA для проверки.
device_id целое число	Идентификатор шасси, параметры которого необходимо обновить. Если идентификатор устройства не указан, этот модуль обновляет параметры питания для hostname. device_id нельзя использовать вместе с device_service_tag.
device_service_tag строка	Сервисный тег шасси, параметр которого необходимо обновить. Если сервисный тег устройства не указан, этот модуль обновляет параметры питания для hostname. device_service_tag нельзя использовать вместе с device_id.
hostname строка / обязательный	IP-адрес или имя узла OpenManage Enterprise Modular.
hot_spare_configuration словарь	Параметры конфигурации горячего резерва.
enable_hot_spare логическое значение / обязательный	Включает или отключает конфигурацию горячего резерва для регулирования напряжения при низком энергопотреблении блока питания (PSU). Варианты: `false` `true`
primary_grid строка	Варианты выбора для сетки PSU. `GRID_1` горячий резерв для сетки 1. `GRID_2` горячий резерв для сетки 2. Варианты: `"GRID_1"` ← (по умолчанию) `"GRID_2"`
password строка	Пароль OpenManage Enterprise Modular. Если пароль не указан, используется переменная среды `OME_PASSWORD`. Пример: export OME_PASSWORD=password
port целое число	HTTPS-порт OpenManage Enterprise Modular. По умолчанию: `443`
power_configuration словарь	Параметры конфигурации питания.
enable_power_cap логическое значение / обязательный	Включает или отключает настройки ограничения мощности. Варианты: `false` `true`
power_cap целое число	Максимальный предел энергопотребления устройства. Укажите предел потребления в ваттах. Этот параметр обязателен, если для enable_power_cap задано значение true.
redundancy_configuration словарь	Параметры конфигурации резервирования.
redundancy_policy строка	Варианты настройки политики резервирования. `NO_REDUNDANCY` политика резервирования не используется. `GRID_REDUNDANCY` для распределения питания путем разделения PSU на две сетки. `PSU_REDUNDANCY` для распределения питания между всеми PSU. Варианты: `"NO_REDUNDANCY"` ← (по умолчанию) `"GRID_REDUNDANCY"` `"PSU_REDUNDANCY"`
timeout целое число добавлено в dellemc.openmanage 5.0.0	Тайм-аут на уровне сокета в секундах. По умолчанию: `30`
username строка	Имя пользователя OpenManage Enterprise Modular. Если имя пользователя не указано, используется переменная среды `OME_USERNAME`. Пример: export OME_USERNAME=username
validate_certs логическое значение добавлено в dellemc.openmanage 5.0.0	Если задано `false`, сертификаты SSL не будут проверяться. Используйте `false` только на ресурсах под личным контролем, где применяются самоподписанные сертификаты. В версиях коллекции до `5.0.0` значение validate_certs по умолчанию — `false`. Варианты: `false` `true` ← (по умолчанию)
x_auth_token строка добавлено в dellemc.openmanage 9.3.0	Токен аутентификации. Если x_auth_token не указан, используется переменная среды `OME_X_AUTH_TOKEN`. Пример: export OME_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

Запускайте этот модуль в системе с прямым доступом к Dell OpenManage Enterprise Modular.
Этот модуль поддерживает check_mode.

Примеры

---
- name: Update power configuration settings of a chassis using the device ID.
  dellemc.openmanage.ome_device_power_settings:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_id: 25011
    power_configuration:
      enable_power_cap: true
      power_cap: 3424

- name: Update redundancy configuration settings of a chassis using the device service tag.
  dellemc.openmanage.ome_device_power_settings:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_service_tag: GHRT2RL
    redundancy_configuration:
      redundancy_policy: GRID_REDUNDANCY

- name: Update hot spare configuration settings of a chassis using device ID.
  dellemc.openmanage.ome_device_power_settings:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_id: 25012
    hot_spare_configuration:
      enable_hot_spare: true
      primary_grid: GRID_1

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

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

Ключ	Описание
error_info словарь	Сведения об ошибке HTTP. Возвращается: при ошибке HTTP Пример: `{"error": {"@Message.ExtendedInfo": [{"Message": "Unable to process the request because an error occurred.", "MessageArgs": [], "MessageId": "GEN1234", "RelatedProperties": [], "Resolution": "Retry the operation. If the issue persists, contact your system administrator.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}`
msg строка	Общий статус параметров питания устройства. Возвращается: всегда Пример: `"Successfully updated the power settings."`
power_details словарь	Возвращается при успешном обновлении параметров питания. Возвращается: при успешном выполнении Пример: `{"EnableHotSpare": true, "EnablePowerCapSettings": true, "MaxPowerCap": "3424", "MinPowerCap": "3291", "PowerCap": "3425", "PrimaryGrid": "GRID_1", "RedundancyPolicy": "NO_REDUNDANCY", "SettingType": "Power"}`

Авторы

Felix Stephen (@felixs88)

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

© 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/dellemc/openmanage/ome_device_power_settings_module.html