Модуль dellemc.openmanage.ome_devices — выполнение операций с целевыми устройствами

Примечание

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

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

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

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

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

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

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

Выполнение операций с устройствами, таких как обновление инвентаризации, очистка очереди заданий iDRAC и сброс iDRAC из OpenManage Enterprise.

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
ca_path path добавлено в dellemc.openmanage 5.0.0	Файл Privacy Enhanced Mail (PEM), содержащий сертификат ЦС для проверки.
device_action string	`refresh_inventory` обновляет инвентаризацию целевых устройств. `reset_idrac` Запускает сброс целевых устройств iDRAC. `clear_idrac_job_queue` Очищает очередь заданий целевых устройств iDRAC. Для каждого действия запускается задание. Варианты: `"refresh_inventory"` ← (по умолчанию) `"reset_idrac"` `"clear_idrac_job_queue"`
device_ids list / elements=integer	Идентификаторы целевых устройств. Этот параметр нельзя использовать одновременно с device_service_tags.
device_service_tags list / elements=string	Метки обслуживания целевых устройств. Этот параметр нельзя использовать одновременно с device_ids.
hostname string / обязательный	IP-адрес или имя хоста OpenManage Enterprise.
job_description string	Необязательное описание задания.
job_name string	Необязательное имя задания.
job_schedule string	Укажите строку cron для планирования задания. По умолчанию: `"startnow"`
job_wait boolean	Позволяет дождаться завершения задания. Этот параметр применяется, если значение state — `present`. Применяется, если значение job_schedule — `startnow`. Варианты: `false` `true` ← (по умолчанию)
job_wait_timeout integer	Максимальное время ожидания для job_wait в секундах. Отслеживание задания выполняется только в течение этого времени. Этот параметр применяется, если значение job_wait — `true`. По умолчанию: `1200`
password string	Пароль OpenManage Enterprise. Если пароль не указан, используется переменная среды `OME_PASSWORD`. Пример: export OME_PASSWORD=password
port integer	HTTPS-порт OpenManage Enterprise. По умолчанию: `443`
state string	`present` Позволяет выполнить действие device_action на целевых устройствах. `absent` Удаляет устройство из OpenManage Enterprise. Задание не запускается. Параметры job_wait, job_schedule, job_name и job_description для этой операции не применяются. Варианты: `"present"` ← (по умолчанию) `"absent"`
timeout integer добавлено в dellemc.openmanage 5.0.0	Тайм-аут на уровне сокета в секундах. По умолчанию: `30`
username string	Имя пользователя OpenManage Enterprise. Если имя пользователя не указано, используется переменная среды `OME_USERNAME`. Пример: export OME_USERNAME=username
validate_certs boolean добавлено в dellemc.openmanage 5.0.0	Если задано значение `false`, SSL-сертификаты не проверяются. Задавайте `false` только на сайтах под личным управлением, где используются самозаверяющие сертификаты. До версии коллекции `5.0.0` для validate_certs по умолчанию задавалось значение `false`. Варианты: `false` `true` ← (по умолчанию)
x_auth_token string добавлено в dellemc.openmanage 9.3.0	Токен аутентификации. Если x_auth_token не указан, используется переменная среды `OME_X_AUTH_TOKEN`. Пример: export OME_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

Для idrac_reset задание запускает только операцию сброса iDRAC и не отслеживает весь цикл сброса.
Запускайте этот модуль в системе, имеющей прямой доступ к Dell OpenManage Enterprise.
Этот модуль поддерживает check_mode.

Примеры

---
- name: Refresh Inventory
  dellemc.openmanage.ome_devices:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_action: refresh_inventory
    device_service_tags:
      - SVCTAG1

- name: Clear iDRAC job queue
  dellemc.openmanage.ome_devices:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_action: clear_idrac_job_queue
    device_service_tags:
      - SVCTAG1

- name: Reset iDRAC using the service tag
  dellemc.openmanage.ome_devices:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_action: reset_idrac
    device_service_tags:
      - SVCTAG1

- name: Remove devices using servicetags
  dellemc.openmanage.ome_devices:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: absent
    device_service_tags:
      - SVCTAG1
      - SVCTAF2

- name: Remove devices using IDs
  dellemc.openmanage.ome_devices:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: absent
    device_ids:
      - 10235

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

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

Ключ	Описание
error_info dictionary	Сведения об ошибке HTTP. Возвращается: при ошибке HTTP Пример: `{"error": {"@Message.ExtendedInfo": [{"Message": "Unable to complete the operation because the requested URI is invalid.", "MessageArgs": [], "MessageId": "CGEN1002", "RelatedProperties": [], "Resolution": "Enter a valid URI and retry the operation.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}`
job dictionary	Сведения о задании для операции с устройствами. Возвращается: при успешном выполнении Пример: {"Builtin": false, "CreatedBy": "admin", "Editable": true, "ExecutionHistories@odata.navigationLink": "/api/JobService/Jobs(14874)/ExecutionHistories", "Id": 14874, "JobDescription": "The Refresh inventory task initiated from OpenManage Ansible Modules for devices with the ids '13216'.", "JobName": "Refresh inventory", "JobStatus": {"@odata.type": "#JobService.JobStatus", "Id": 2020, "Name": "Scheduled"}, "JobType": {"@odata.type": "#JobService.JobType", "Id": 8, "Internal": false, "Name": "Inventory_Task"}, "LastExecutionDetail": {"@odata.id": "/api/JobService/Jobs(14874)/LastExecutionDetail"}, "LastRunStatus": {"@odata.type": "#JobService.JobStatus", "Id": 2060, "Name": "Completed"}, "Params": [{"JobId": 14874, "Key": "action", "Value": "CONFIG_INVENTORY"}, {"JobId": 14874, "Key": "isCollectDriverInventory", "Value": "true"}], "Schedule": "startnow", "State": "Enabled", "Targets": [{"Data": "", "Id": 13216, "JobId": 14874, "TargetType": {"Id": 1000, "Name": "DEVICE"}}], "UpdatedBy": null, "UserGenerated": true, "Visible": true}
msg string	Общий статус операции с устройствами. Возвращается: всегда Пример: `"Successfully removed the device(s)."`

Авторы

Jagadeesh N V(@jagadeeshnv)
ShivamSh3(@ShivamSh3)

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

© 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_devices_module.html