модуль dellemc.openmanage.ome_device_network_services — настройка параметров сетевых служб шасси в 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_network_services.

Добавлено в dellemc.openmanage 4.3.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.
password строка	Пароль OpenManage Enterprise Modular. Если пароль не указан, используется переменная среды `OME_PASSWORD`. Пример: export OME_PASSWORD=password
port целое число	HTTPS-порт OpenManage Enterprise Modular. По умолчанию: `443`
remote_racadm_settings словарь	Параметры настройки удаленного RACADM.
enabled логическое значение / обязательный	Включает или отключает параметры удаленного RACADM. Варианты: `false` `true`
snmp_settings словарь	Параметры настройки SNMP.
community_name строка	Строка сообщества SNMP. Обязателен, если для enabled задано значение `true`.
enabled логическое значение / обязательный	Включает или отключает параметры SNMP. Варианты: `false` `true`
port_number целое число	Номер порта SNMP.
ssh_settings словарь	Параметры настройки SSH.
enabled логическое значение / обязательный	Включает или отключает параметры SSH. Варианты: `false` `true`
idle_timeout число с плавающей точкой	Время ожидания SSH в минутах.
max_auth_retries целое число	Количество повторных попыток при сбое сеанса SSH.
max_sessions целое число	Количество сеансов SSH.
port_number целое число	Номер порта службы SSH.
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 network services settings of a chassis using the device ID
  dellemc.openmanage.ome_device_network_services:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_id: 25011
    snmp_settings:
      enabled: true
      port_number: 161
      community_name: public
    ssh_settings:
      enabled: false
    remote_racadm_settings:
      enabled: false

- name: Update network services settings of a chassis using the device service tag.
  dellemc.openmanage.ome_device_network_services:
    hostname: "192.168.0.2"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_service_tag: GHRT2RL
    snmp_settings:
      enabled: false
    ssh_settings:
      enabled: true
      port_number: 22
      max_sessions: 1
      max_auth_retries: 3
      idle_timeout: 1
    remote_racadm_settings:
      enabled: false

- name: Update network services settings of the host chassis.
  dellemc.openmanage.ome_device_network_services:
    hostname: "192.168.0.3"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    snmp_settings:
      enabled: false
    ssh_settings:
      enabled: false
    remote_racadm_settings:
      enabled: true

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

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

Ключ	Описание
error_info словарь	Сведения об ошибке HTTP. Возвращается: при ошибке HTTP Пример: `{"error": {"@Message.ExtendedInfo": [{"Message": "Unable to update the network configuration because the SNMP PortNumber is already in use.", "MessageArgs": ["SNMP PortNumber"], "MessageId": "CAPP1042", "RelatedProperties": [], "Resolution": "Enter a different port number and retry the operation.", "Severity": "Informational"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}`
msg строка	Общий статус параметров сетевых служб. Возвращается: всегда Пример: `"Successfully updated the network services settings."`
network_services_details словарь	Возвращается при успешном обновлении параметров сетевых служб. Возвращается: при успешном выполнении Пример: `{"EnableRemoteRacadm": true, "SettingType": "NetworkServices", "SnmpConfiguration": {"PortNumber": 161, "SnmpEnabled": true, "SnmpV1V2Credential": {"CommunityName": "public"}}, "SshConfiguration": {"IdleTimeout": 60, "MaxAuthRetries": 3, "MaxSessions": 1, "PortNumber": 22, "SshEnabled": false}}`

Авторы

Felix Stephen (@felixs88)
Kritika Bhateja (@Kritika-Bhateja-03)

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

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