Spec-Zone.ru › Ansible

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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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 создавать адрес WWPN (имя порта World Wide) и WWNN (имя узла World Wide).

Значение 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.

iqn_prefix

строка

Адреса с префиксом IQN.

initiator_ip_pool_settings

словарь

Применяется при создании и изменении пула идентификаторов с использованием настроек IP-пула инициатора iSCSI.

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.

При создании пула идентификаторов этот параметр игнорируется.

password

строка

Пароль OpenManage Enterprise или OpenManage Enterprise Modular.

Если пароль не указан, используется переменная среды OME_PASSWORD.

Пример: export OME_PASSWORD=password

pool_description

строка

Описание пула идентификаторов.

pool_name

строка / обязательный

Этот параметр обязателен для state при создании, изменении и удалении пула идентификаторов.

port

целое число

HTTPS-порт OpenManage Enterprise или OpenManage Enterprise Modular.

По умолчанию: 443

state

строка

present изменяет существующий пул идентификаторов. Если указанный I (pool_name) не существует, создаётся пул идентификаторов. - absent удаляет существующий пул идентификаторов.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

timeout

целое число

добавлено в dellemc.openmanage 5.0.0

Тайм-аут сокета в секундах.

По умолчанию: 30

username

строка

Имя пользователя OpenManage Enterprise или 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.
  • Этот модуль поддерживает 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"

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

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

Ключ

Описание

error_info

словарь

Сведения об ошибке 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."}}

msg

строка

Общий статус операции с пулом идентификаторов.

Возвращается: всегда

Пример: "Successfully created an identity pool."

pool_status

словарь

Сведения об операции пользователя, если state равно present.

Возвращается: при успешном выполнении

Пример: {"Id": 29, "IsSuccessful": true, "Issues": []}

Авторы

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

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

  • Отслеживание проблем
  • Домашняя страница
  • Репозиторий (исходный код)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API