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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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 строка	Параметры объединения NIC в группу. `NoTeaming` NIC не объединяются в группу и не обеспечивают балансировку нагрузки или избыточность. `LACP` использовать LACP для объединения NIC в группу. `Other` использовать другую технологию для объединения NIC в группу. Варианты: `"LACP"` `"NoTeaming"` `"Other"`
password строка	Пароль OpenManage Enterprise Modular. Если пароль не указан, используется переменная среды `OME_PASSWORD`. Пример: export OME_PASSWORD=password
port целое число	HTTPS-порт OpenManage Enterprise Modular. По умолчанию: `443`
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

Примечания

Примечание

Этот модуль поддерживает 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)
Akash Shendge (@shenda1)

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

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