Модуль dellemc.openmanage.ome_powerstate – Выполняет операции управления питанием на OpenManage Enterprise

Примечание

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

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

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

Чтобы использовать его в книге задач, укажите: dellemc.openmanage.ome_powerstate.

Новое в dellemc.openmanage 2.1.0

Обзор
Требования
Параметры
Примечания
Примеры
Значения возврата

Обзор

Этот модуль выполняет поддерживаемые операции управления питанием на OpenManage Enterprise.

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
ca_path путь добавлен в dellemc.openmanage 5.0.0	Файл PEM (Privacy Enhanced Mail), содержащий сертификат CA, используемый для проверки.
device_id целое число	Идентификатор целевого устройства. device_id взаимоисключающее с device_service_tag.
device_service_tag строка	Тег целевого устройства. device_service_tag взаимоисключающее с device_id.
hostname строка / обязательно	IP-адрес или имя хоста OpenManage Enterprise или OpenManage Enterprise Modular.
password строка	Пароль OpenManage Enterprise или OpenManage Enterprise Modular. Если пароль не указан, используется переменная окружения `OME_PASSWORD`. Пример: export OME_PASSWORD=пароль
port целое число	Порт HTTPS OpenManage Enterprise или OpenManage Enterprise Modular. По умолчанию: `443`
power_state строка / обязательно	Желаемое конечное состояние питания. Варианты: `"on"` `"off"` `"coldboot"` `"warmboot"` `"shutdown"`
timeout целое число добавлен в dellemc.openmanage 5.0.0	Таймаут сокета в секундах. По умолчанию: `30`
username строка	Имя пользователя OpenManage Enterprise или OpenManage Enterprise Modular. Если имя пользователя не указано, используется переменная окружения `OME_USERNAME`. Пример: export OME_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.
Этот модуль поддерживает check_mode.

Примеры

---
- name: Power state operation based on device id
  dellemc.openmanage.ome_powerstate:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_id: 11111
    power_state: "off"

- name: Power state operation based on device service tag
  dellemc.openmanage.ome_powerstate:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_service_tag: "KLBR111"
    power_state: "on"

- name: Power state operation based on list of device ids
  dellemc.openmanage.ome_powerstate:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_id: "{{ item.device_id }}"
    power_state: "{{ item.state }}"
  with_items:
    - { "device_id": 11111, "state": "on" }
    - { "device_id": 22222, "state": "off" }

- name: Power state operation based on list of device service tags
  dellemc.openmanage.ome_powerstate:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_service_tag: "{{ item.service_tag }}"
    power_state: "{{ item.state }}"
  with_items:
    - { "service_tag": "KLBR111", "state": "on" }
    - { "service_tag": "KLBR222", "state": "off" }

Значения возврата

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

Ключ	Описание
job_status словарь	Подробности о задании операции управления питанием и ходе его выполнения из OME. Возвращается: успех Пример: {"Builtin": false, "CreatedBy": "user", "Editable": true, "EndTime": null, "Id": 11111, "JobDescription": "DeviceAction_Task", "JobName": "DeviceAction_Task_PowerState", "JobStatus": {"Id": 1111, "Name": "New"}, "JobType": {"Id": 1, "Internal": false, "Name": "DeviceAction_Task"}, "LastRun": "2019-04-01 06:39:02.69", "LastRunStatus": {"Id": 1112, "Name": "Running"}, "NextRun": null, "Params": [{"JobId": 11111, "Key": "powerState", "Value": "2"}, {"JobId": 11111, "Key": "operationName", "Value": "POWER_CONTROL"}], "Schedule": "", "StartTime": null, "State": "Enabled", "Targets": [{"Data": "", "Id": 11112, "JobId": 11111, "TargetType": {"Id": 1000, "Name": "DEVICE"}}], "UpdatedBy": null, "Visible": true}
msg строка	Общее состояние задания операции управления питанием. Возвращается: всегда Пример: `"Power State operation job submitted successfully."`

Ключ

Описание

job_status

словарь

Подробности о задании операции управления питанием и ходе его выполнения из OME.

Возвращается: успех

Пример: {"Builtin": false, "CreatedBy": "user", "Editable": true, "EndTime": null, "Id": 11111, "JobDescription": "DeviceAction_Task", "JobName": "DeviceAction_Task_PowerState", "JobStatus": {"Id": 1111, "Name": "New"}, "JobType": {"Id": 1, "Internal": false, "Name": "DeviceAction_Task"}, "LastRun": "2019-04-01 06:39:02.69", "LastRunStatus": {"Id": 1112, "Name": "Running"}, "NextRun": null, "Params": [{"JobId": 11111, "Key": "powerState", "Value": "2"}, {"JobId": 11111, "Key": "operationName", "Value": "POWER_CONTROL"}], "Schedule": "", "StartTime": null, "State": "Enabled", "Targets": [{"Data": "", "Id": 11112, "JobId": 11111, "TargetType": {"Id": 1000, "Name": "DEVICE"}}], "UpdatedBy": null, "Visible": true}

msg

строка

Общее состояние задания операции управления питанием.

Возвращается: всегда

Пример: "Power State operation job submitted successfully."

Авторы

Felix Stephen (@felixs88)

Ссылки на сборки

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