dellemc.openmanage.ome_smart_fabric модуль — Создание, изменение или удаление ткани в OpenManage Enterprise Modular

Примечание

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

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

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

Для использования в плейбуке укажите: dellemc.openmanage.ome_smart_fabric.

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

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

Описание

Этот модуль позволяет создавать ткань, а также изменять или удалять существующую ткань в OpenManage Enterprise Modular.

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
ca_path путь добавлен в dellemc.openmanage 5.0.0	Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA, используемый для валидации.
description строка	Укажите краткое описание создаваемой или изменяемой ткани.
fabric_design строка	Укажите топологию ткани. Смотрите API https://www.dell.com/support/manuals/en-in/poweredge-mx7000/omem_1_20_10_ug/smartfabric-network-topologies, чтобы узнать о ее топологии. fabric_design является обязательным для создания ткани. Варианты: `"2xMX5108n_Ethernet_Switches_in_same_chassis"` `"2xMX9116n_Fabric_Switching_Engines_in_same_chassis"` `"2xMX9116n_Fabric_Switching_Engines_in_different_chassis"`
hostname строка / обязательно	IP-адрес или имя хоста OpenManage Enterprise Modular.
name строка / обязательно	Укажите имя ткани для создания, удаления или изменения.
new_name строка	Укажите имя ткани для изменения.
override_LLDP_configuration строка	Включите эту настройку, чтобы разрешить включение адреса управления тканью в сообщения LLDP. Примечания: OpenManage Enterprise Modular 1.0 не поддерживает этот параметр. Некоторые решения программного обеспечения для сетевых соединений требуют передачи одного адреса управления всеми коммутаторами Ethernet для представления всей ткани. Включите эту функцию только при подключении к такому решению. Варианты: `"Enabled"` `"Disabled"`
password строка	Пароль OpenManage Enterprise Modular. Если пароль не указан, используется переменная среды `OME_PASSWORD`. Пример: export OME_PASSWORD=password
port целое число	Порт HTTPS OpenManage Enterprise Modular. По умолчанию: `443`
primary_switch_service_tag строка	Тег сервиса первого коммутатора. primary_switch_service_tag является обязательным для создания ткани. primary_switch_service_tag должен соответствовать модели, выбранной в fabric_design.
secondary_switch_service_tag строка	Тег сервиса второго коммутатора. secondary_switch_service_tag является обязательным для создания ткани. secondary_switch_service_tag должен соответствовать модели, выбранной в fabric_design.
state строка	`present` создает новую ткань или изменяет существующую. `absent` удаляет существующую ткань. Примечания: Операция создания, изменения или удаления ткани занимает около 15-20 минут. Рекомендуется не начинать другую операцию, пока текущая не завершится. Варианты: `"present"` ← (по умолчанию) `"absent"`
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: Create a fabric
  dellemc.openmanage.ome_smart_fabric:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: present
    name: "fabric1"
    description: "fabric desc"
    fabric_design: "2xMX9116n_Fabric_Switching_Engines_in_different_chassis"
    primary_switch_service_tag: "SVTG123"
    secondary_switch_service_tag: "PXYT456"
    override_LLDP_configuration: "Enabled"

- name: Modify a fabric
  dellemc.openmanage.ome_smart_fabric:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: present
    name: "fabric1"
    new_name: "fabric_gold1"
    description: "new description"

- name: Delete a fabric
  dellemc.openmanage.ome_smart_fabric:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: "absent"
    name: "fabric1"

Значения возврата

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

Ключ	Описание
additional_info словарь	Дополнительные сведения об операции с Fabric. Возвращается: при state=present и наличии дополнительной информации в ответе. Пример: `{"error": {"@Message.ExtendedInfo": [{"Message": "Fabric update is successful. The OverrideLLDPConfiguration attribute is not provided in the payload, so it preserves the previous value.", "MessageArgs": [], "RelatedProperties": [], "Resolution": "Please update the Fabric with the OverrideLLDPConfiguration as Disabled or Enabled if necessary.", "Severity": "Informational"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}`
error_info словарь	Подробности об ошибке HTTP. Возвращается: при ошибке HTTP Пример: {"error": {"@Message.ExtendedInfo": [{"Message": "Unable to perform operation, because the fabric manager was not reachable.", "MessageArgs": [], "RelatedProperties": [], "Resolution": "Make sure of the following and retry the operation: 1) There is at least one advanced I/O Module in power-on mode. For example, MX9116n Ethernet Switch and MX5108n Ethernet Switch. However, if an advanced I/O Module is available in the power-on mode, make sure that the network profile is not set when the fabric manager is in the switch-over mode. 2) If the issue persists, wait for few minutes and retry the operation.", "Severity": "Warning"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}
fabric_id строка	Возвращает идентификатор при создании, изменении или удалении Fabric. Возвращается: при успехе Пример: `"1312cceb-c3dd-4348-95c1-d8541a17d776"`
msg строка	Общий статус операции с Fabric. Возвращается: всегда Пример: `"Fabric creation operation is initiated."`

Авторы

Sajna Shetty(@Sajna-Shetty)

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

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