dellemc.openmanage.ome_identity_pool модуль — Управление настройками пула идентификаторов в OpenManage Enterprise

Примечание

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

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

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

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

Введено в dellemc.openmanage 2.1.0

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

Обзор

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

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
ca_path путь добавлен в dellemc.openmanage 5.0.0	Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA, используемый для проверки.
ethernet_settings словарь	Применимо для создания и изменения пула идентификаторов с использованием параметров Ethernet. starting_mac_address и identity_count необходимы для создания пула идентификаторов.
identity_count целое число	Количество MAC-адресов.
starting_mac_address строка	Начальный MAC-адрес для настроек Ethernet.
fc_settings словарь	Применимо для создания и изменения пула идентификаторов с использованием настроек Fibre Channel (FC). Этот параметр позволяет OpenManage Enterprise генерировать адрес Worldwide port name (WWPN) и Worldwide node name (WWNN). Значение 0x2001 используется как начальный адрес для генерации WWPN, а 0x2000 для WWNN. starting_address и identity_count необходимы для создания пула идентификаторов.
identity_count целое число	Количество MAC-адресов. identity_count требуется для создания настроек FC.
starting_address строка	Начальный MAC-адрес для настроек FC. starting_address требуется для создания настроек FC.
fcoe_settings словарь	Применимо для создания и изменения пула идентификаторов с использованием настроек FCoE. starting_mac_address и identity_count необходимы для создания пула идентификаторов.
identity_count целое число	Количество MAC-адресов.
starting_mac_address строка	Начальный MAC-адрес для настроек FCoE.
hostname строка / обязательно	Адрес IP или имя хоста OpenManage Enterprise или OpenManage Enterprise Modular.
iscsi_settings словарь	Применимо для создания и изменения пула идентификаторов с использованием настроек iSCSI. starting_mac_address, identity_count, iqn_prefix, ip_range и subnet_mask необходимы для создания пула идентификаторов.
identity_count целое число	Количество MAC-адресов.
initiator_config словарь	Применимо для создания и изменения пула идентификаторов с использованием настроек iSCSI Initiator.
iqn_prefix строка	Предположение IQN.
initiator_ip_pool_settings словарь	Применимо для создания и изменения пула идентификаторов с использованием параметров пула IP-адресов iSCSI Initiator.
gateway строка	IP-адрес шлюза.
ip_range строка	Диапазон IP-адресов, не являющихся многоадресными.
primary_dns_server строка	IP-адрес основного DNS-сервера.
secondary_dns_server строка	IP-адрес вторичного DNS-сервера.
subnet_mask строка	Маска подсети для ip_range.
starting_mac_address строка	Начальный MAC-адрес для настроек iSCSI. Этот параметр обязателен для настроек iSCSI.
new_pool_name строка	После создания пула идентификаторов pool_name можно изменить на new_pool_name. Этот параметр игнорируется при создании пула идентификаторов.

пароль строка	Пароль OpenManage Enterprise или OpenManage Enterprise Modular. Если пароль не указан, используется переменная среды `OME_PASSWORD`. Пример: export OME_PASSWORD=пароль
описание_пула строка	Описание идентификационного пула.
имя_пула строка / обязательно	Этот параметр обязателен для состояния при создании, изменении и удалении идентификационного пула.
порт целое число	HTTPS-порт OpenManage Enterprise или OpenManage Enterprise Modular. По умолчанию: `443`
состояние строка	`present` изменяет существующий идентификационный пул. Если указанное имя пула (pool_name) не существует, создается идентификационный пул. - `absent` удаляет существующий идентификационный пул. Варианты: `"present"` ← (по умолчанию) `"absent"`
таймаут целое число добавлен в dellemc.openmanage 5.0.0	Таймаут уровня сокета в секундах. По умолчанию: `30`
имя_пользователя строка	Имя пользователя OpenManage Enterprise или OpenManage Enterprise Modular. Если имя пользователя не указано, используется переменная среды `OME_USERNAME`. Пример: export OME_USERNAME=имя_пользователя
проверять_сертификаты логический тип добавлен в dellemc.openmanage 5.0.0	Если `false`, сертификаты SSL не будут проверены. Настраивайте `false` только на сайтах, контролируемых лично, где используются самозаверяющие сертификаты. До версии сборки `5.0.0`, проверять_сертификаты был `false` по умолчанию. Варианты: `false` `true` ← (по умолчанию)
x_токен_аутентификации строка добавлен в dellemc.openmanage 9.3.0	Токен аутентификации. Если x_токен_аутентификации не указан, используется переменная среды `OME_X_AUTH_TOKEN`. Пример: export OME_X_AUTH_TOKEN=x_токен_аутентификации

Примечания

Примечание

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

Примеры

---
- name: Create an identity pool using ethernet, FCoE, iSCSI and FC settings
  dellemc.openmanage.ome_identity_pool:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: present
    pool_name: "pool1"
    pool_description: "Identity pool with Ethernet, FCoE, iSCSI and FC settings"
    ethernet_settings:
      starting_mac_address: "50:50:50:50:50:00"
      identity_count: 60
    fcoe_settings:
      starting_mac_address: "70:70:70:70:70:00"
      identity_count: 75
    iscsi_settings:
      starting_mac_address: "60:60:60:60:60:00"
      identity_count: 30
      initiator_config:
        iqn_prefix: "iqn.myprefix."
      initiator_ip_pool_settings:
        ip_range: "10.33.0.1-10.33.0.255"
        subnet_mask: "255.255.255.0"
        gateway: "192.168.4.1"
        primary_dns_server: "10.8.8.8"
        secondary_dns_server: "8.8.8.8"
    fc_settings:
      starting_address: "30:30:30:30:30:00"
      identity_count: 45

- name: Create an identity pool using only ethernet settings
  dellemc.openmanage.ome_identity_pool:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    pool_name: "pool2"
    pool_description: "create identity pool with ethernet"
    ethernet_settings:
      starting_mac_address: "aa-bb-cc-dd-ee-aa"
      identity_count: 80

- name: Modify an identity pool
  dellemc.openmanage.ome_identity_pool:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    pool_name: "pool2"
    new_pool_name: "pool3"
    pool_description: "modifying identity pool with ethernet and fcoe settings"
    ethernet_settings:
      starting_mac_address: "90-90-90-90-90-90"
      identity_count: 61
    fcoe_settings:
      starting_mac_address: "aabb.ccdd.5050"
      identity_count: 77

- name: Modify an identity pool using iSCSI and FC settings
  dellemc.openmanage.ome_identity_pool:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    ca_path: "/path/to/ca_cert.pem"
    pool_name: "pool_new"
    new_pool_name: "pool_new2"
    pool_description: "modifying identity pool with iscsi and fc settings"
    iscsi_settings:
      identity_count: 99
      initiator_config:
        iqn_prefix: "iqn1.myprefix2."
      initiator_ip_pool_settings:
        gateway: "192.168.4.5"
    fc_settings:
      starting_address: "10:10:10:10:10:10"
      identity_count: 98

- name: Delete an identity pool
  dellemc.openmanage.ome_identity_pool:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: "absent"
    pool_name: "pool2"

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

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

Ключ	Описание
информация_об_ошибке словарь	Подробности HTTP-ошибки. Возвращается: при HTTP-ошибке Пример: {"error": {"@Message.ExtendedInfo": [{"Message": "Unable to process the request because an error occurred: Ethernet-MAC Range overlap found (in this Identity Pool or in a different one) .", "MessageArgs": ["Ethernet-MAC Range overlap found (in this Identity Pool or in a different one)\""], "MessageId": "CGEN6001", "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."}}
сообщение строка	Общий статус операции с идентификационным пулом. Возвращается: всегда Пример: `"Successfully created an identity pool."`
статус_пула словарь	Подробности операции пользователя, когда состояние равно `present`. Возвращается: успешно Пример: `{"Id": 29, "IsSuccessful": true, "Issues": []}`

Авторы

Sajna Shetty(@Sajna-Shetty)
Deepak Joshi(@Dell-Deepak-Joshi))

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

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