Модуль dellemc.openmanage.ome_firmware_baseline – Создание, изменение или удаление эталонного образа микропрограммного обеспечения на OpenManage Enterprise или OpenManage Enterprise Modular

Примечание

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

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

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

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

Новая функция в dellemc.openmanage 2.0.0

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

Описание

Этот модуль позволяет создавать, изменять или удалять эталонный образ микропрограммного обеспечения на OpenManage Enterprise или OpenManage Enterprise Modular.

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
baseline_description строка	Описание создаваемой эталонной конфигурации.
baseline_id целое число добавлен в dellemc.openmanage 3.4.0	ID существующей эталонной конфигурации. Этот параметр взаимоисключающий с baseline_name.
baseline_name строка	Имя эталонной конфигурации. Этот параметр взаимоисключающий с baseline_id.
ca_path путь добавлен в dellemc.openmanage 5.0.0	Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA, используемый для проверки.
catalog_name строка	Имя каталога, который будет связан с эталонной конфигурацией.
device_group_names список / элементы=строка	Список имён групп. Этот параметр взаимоисключающий с device_ids и device_service_tags.
device_ids список / элементы=целое число	Список идентификаторов устройств. Этот параметр взаимоисключающий с device_service_tags и device_group_names.
device_service_tags список / элементы=строка	Список тегов служб устройств. Этот параметр взаимоисключающий с device_ids и device_group_names.
downgrade_enabled булево	Указывает, разрешено ли понижение версии микропрограммы для устройств в эталонной конфигурации. Это значение будет установлено в `true` по умолчанию, если оно не указано при создании эталонной конфигурации. Варианты: `false` `true`
filter_no_reboot_required булево добавлен в dellemc.openmanage 8.1.0	Выбор только компонентов без необходимости перезагрузки позволяет создать эталонную конфигурацию микропрограммы/драйвера, которая состоит только из компонентов целевых устройств, не требующих перезагрузки целевых устройств. Варианты: `false` `true`
hostname строка / обязательный	IP-адрес или имя хоста OpenManage Enterprise или OpenManage Enterprise Modular.
is_64_bit булево	Указывает, содержит ли хранилище 64-битные DUP. Это значение будет установлено в `true` по умолчанию, если оно не указано при создании эталонной конфигурации. Варианты: `false` `true`
job_wait булево добавлен в dellemc.openmanage 3.4.0	Предоставляет возможность ожидания завершения задания. Этот параметр применим, когда state равен `present`. Варианты: `false` `true` ← (по умолчанию)
job_wait_timeout целое число добавлен в dellemc.openmanage 3.4.0	Максимальное время ожидания job_wait в секундах. Задание отслеживается только в течение этого времени. Этот параметр применим, когда job_wait равен `true`. По умолчанию: `600`
new_baseline_name строка добавлен в dellemc.openmanage 3.4.0	Новое имя эталонной конфигурации.
password строка	Пароль OpenManage Enterprise или OpenManage Enterprise Modular. Если пароль не предоставлен, используется переменная окружения `OME_PASSWORD`. Пример: export OME_PASSWORD=пароль
port целое число	Порт HTTPS OpenManage Enterprise или OpenManage Enterprise Modular. По умолчанию: `443`
state строка добавлен в dellemc.openmanage 3.4.0	`present` создаёт или изменяет эталонную конфигурацию. `absent` удаляет существующую эталонную конфигурацию. Варианты: `"present"` ← (по умолчанию) `"absent"`

END_OF_DOCUMENT_MARKER

timeout integer added in dellemc.openmanage 5.0.0	Тайм-аут уровня сокета в секундах. По умолчанию: `30`
username string	Имя пользователя OpenManage Enterprise или OpenManage Enterprise Modular. Если имя пользователя не указано, используется переменная среды `OME_USERNAME`. Пример: export OME_USERNAME=username
validate_certs boolean added in dellemc.openmanage 5.0.0	Если `false`, сертификаты SSL не будут проверены. Настраивайте `false` только на сайтах, контролируемых вами лично, где используются самозаверяемые сертификаты. До версии сборки `5.0.0`, validate_certs `false` по умолчанию. Варианты: `false` `true` ← (по умолчанию)
x_auth_token string added in dellemc.openmanage 9.3.0	Токен аутентификации. Если x_auth_token не указан, используется переменная среды `OME_X_AUTH_TOKEN` Пример: export OME_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

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

Примеры

---
- name: Create baseline for device IDs
  dellemc.openmanage.ome_firmware_baseline:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline_name: "baseline_name"
    baseline_description: "baseline_description"
    catalog_name: "catalog_name"
    device_ids:
      - 1010
      - 2020

- name: Create baseline for device IDs with no reboot required
  dellemc.openmanage.ome_firmware_baseline:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline_name: "baseline_name"
    baseline_description: "baseline_description"
    catalog_name: "catalog_name"
    filter_no_reboot_required: true
    device_ids:
      - 1010
      - 2020

- name: Create baseline for servicetags
  dellemc.openmanage.ome_firmware_baseline:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline_name: "baseline_name"
    baseline_description: "baseline_description"
    catalog_name: "catalog_name"
    device_service_tags:
      - "SVCTAG1"
      - "SVCTAG2"

- name: Create baseline for servicetags with no reboot required
  dellemc.openmanage.ome_firmware_baseline:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline_name: "baseline_name"
    baseline_description: "baseline_description"
    catalog_name: "catalog_name"
    filter_no_reboot_required: true
    device_service_tags:
      - "SVCTAG1"
      - "SVCTAG2"

- name: Create baseline for device groups without job tracking
  dellemc.openmanage.ome_firmware_baseline:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline_name: "baseline_name"
    baseline_description: "baseline_description"
    catalog_name: "catalog_name"
    device_group_names:
      - "Group1"
      - "Group2"
    job_wait: false

- name: Modify an existing baseline
  dellemc.openmanage.ome_firmware_baseline:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline_name: "existing_baseline_name"
    new_baseline_name: "new_baseline_name"
    baseline_description: "new baseline_description"
    catalog_name: "catalog_other"
    device_group_names:
      - "Group3"
      - "Group4"
      - "Group5"
    downgrade_enabled: false
    is_64_bit: true

- name: Modify no reboot filter in existing baseline
  dellemc.openmanage.ome_firmware_baseline:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline_name: "existing_baseline_name"
    new_baseline_name: "new_baseline_name"
    filter_no_reboot_required: true

- name: Delete a baseline
  dellemc.openmanage.ome_firmware_baseline:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: absent
    baseline_name: "baseline_name"

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

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

Ключ	Описание
baseline_id integer	Идентификатор удалённого бэйзлайна. Возвращается: Когда state `absent` Пример: `10123`
baseline_status dictionary	Подробности статуса бэйзлайна. Возвращается: success Пример: `{"CatalogId": 123, "Description": "BASELINE DESCRIPTION", "DeviceComplianceReports": [], "DowngradeEnabled": true, "FilterNoRebootRequired": true, "Id": 23, "Is64Bit": true, "Name": "my_baseline", "RepositoryId": 123, "RepositoryName": "catalog123", "RepositoryType": "HTTP", "Targets": [{"Id": 10083, "Type": {"Id": 1000, "Name": "DEVICE"}}, {"Id": 10076, "Type": {"Id": 1000, "Name": "DEVICE"}}], "TaskId": 11235, "TaskStatusId": 2060}`
error_info dictionary	Подробности ошибки http. Возвращается: при ошибке http Пример: `{"error": {"@Message.ExtendedInfo": [{"Message": "Unable to retrieve baseline list either because the device ID(s) entered are invalid", "Resolution": "Make sure the entered device ID(s) are valid and retry the operation.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}`
job_id integer	Идентификатор задачи бэйзлайна. Возвращается: когда задача бэйзлайна выполняется Пример: `10123`
msg string	Общий статус выполнения операции с бэйзлайном прошивки. Возвращается: всегда Пример: `"Successfully created the firmware baseline."`

Авторы

Jagadeesh N V(@jagadeeshnv)
Kritika Bhateja (@Kritika-Bhateja-03)

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

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