dellemc.openmanage.ome_server_interface_profiles модуль — Настройка профилей интерфейсов серверов

Примечание

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

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

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

Для использования в книге задач укажите: dellemc.openmanage.ome_server_interface_profiles.

Новая в dellemc.openmanage 5.1.0

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

Обзор

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

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
ca_path путь добавлен в dellemc.openmanage 5.0.0	Файл Privacy Enhanced Mail (PEM) содержащий сертификат CA, используемый для валидации.
device_id список / элементы=целое число	Идентификатор устройства Сервера в рамках фабрики шасси. device_id и device_service_tag взаимно исключающие.
device_service_tag список / элементы=строка	Тег сервиса устройства Сервера в рамках фабрики шасси. device_service_tag и device_id взаимно исключающие.
hostname строка / обязательно	IP-адрес или имя хоста OpenManage Enterprise Modular.
job_wait логическое значение	Предоставляет возможность ожидания завершения задания. Варианты: `false` `true` ← (по умолчанию)
job_wait_timeout целое число	Максимальное время ожидания job_wait в секундах. Задание отслеживается только в течение этого времени. Этот параметр применим, когда job_wait `true`. По умолчанию: `120`
nic_configuration список / элементы=словарь	Конфигурация NIC для применяемых Серверов.
nic_identifier строка / обязательно	Идентификатор NIC или номер порта. `Note` Это не будет проверено.
tagged_networks словарь	Список меченных сетей. Сеть не может быть добавлена как помеченная сеть, если она уже назначена непомеченной сети.
names список / элементы=строка / обязательно	Список имён сетей, которые будут помечены как помеченные сети. Список names можно получить с помощью dellemc.openmanage.ome_network_vlan_info
state строка	Указывает, нужно ли добавлять или удалять список сетей. `present` для добавления сети в список меченных `absent` для удаления сети из списка меченных Варианты: `"present"` ← (по умолчанию) `"absent"`
team логическое значение	Объединить два или более портов. Порты должны быть подключены к одной паре коммутаторов Ethernet. team применим только если nic_teaming `LACP`. Варианты: `false` `true`
untagged_network целое число	Максимальный или минимальный идентификатор VLAN сети, которая будет непомеченной. untagged_network можно получить с помощью dellemc.openmanage.ome_network_vlan_info Если untagged_network нужно сбросить, нужно отправить `0` `Note` Сеть не может быть добавлена как непомеченная, если она уже назначена помеченной сети.
nic_teaming строка	Опции объединения сетевых адаптеров. `NoTeaming` сетевые адаптеры не объединены и не обеспечивают балансировку нагрузки или резервирование. `LACP` использовать LACP для объединения сетевых адаптеров. `Other` использовать другую технологию для объединения сетевых адаптеров. Варианты: `"LACP"` `"NoTeaming"` `"Other"`
password строка	Пароль OpenManage Enterprise Modular. Если пароль не указан, используется переменная окружения `OME_PASSWORD`. Пример: export OME_PASSWORD=пароль
port целое число	Порт HTTPS OpenManage Enterprise Modular. По умолчанию: `443`
timeout целое число добавлен в dellemc.openmanage 5.0.0	Таймаут уровня сокета в секундах. По умолчанию: `30`

username string	Имя пользователя модуля OpenManage Enterprise Modular. Если имя пользователя не указано, используется переменная среды `OME_USERNAME`. Пример: export OME_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

Примечания

Примечание

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

Примеры

---
- name: Modify Server Interface Profile for the server using the service tag
  dellemc.openmanage.ome_server_interface_profiles:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_service_tag:
      - SVCTAG1
      - SVCTAG2
    nic_teaming: LACP
    nic_configuration:
      - nic_identifier: NIC.Mezzanine.1A-1-1
        team: false
        untagged_network: 2
        tagged_networks:
          names:
            - vlan1
      - nic_identifier: NIC.Mezzanine.1A-2-1
        team: true
        untagged_network: 3
        tagged_networks:
          names:
            - range120-125

- name: Modify Server Interface Profile for the server using the device id
  dellemc.openmanage.ome_server_interface_profiles:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_id:
      - 34523
      - 48999
    nic_teaming: NoTeaming
    nic_configuration:
      - nic_identifier: NIC.Mezzanine.1A-1-1
        team: false
        untagged_network: 2
        tagged_networks:
          names:
            - vlan2
      - nic_identifier: NIC.Mezzanine.1A-2-1
        team: true
        untagged_network: 3
        tagged_networks:
          names:
            - range120-125

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

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

Ключ	Описание
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."}}`
job_id целое число	Идентификатор задачи применения профилей интерфейсов сервера. Возвращается: при применении профилей интерфейса Пример: `14123`
msg строка	Статус общей операции с интерфейсом сервера. Возвращается: всегда Пример: `"Successfully triggered apply server profiles job."`

Авторы

Jagadeesh N V (@jagadeeshnv)

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

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