Модуль netapp.ontap.na_ontap_broadcast_domain — управление доменами широковещательной рассылки NetApp ONTAP.

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 23.5.0).

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

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

Чтобы использовать его в плейбуке, укажите: netapp.ontap.na_ontap_broadcast_domain.

Добавлено в netapp.ontap 2.6.0

Краткое описание
Требования
Параметры
Примечания
Примеры

Краткое описание

Изменение домена широковещательной рассылки ONTAP.

Требования

Следующие требования должны быть выполнены на узле, на котором выполняется этот модуль.

Ansible 2.9 или более поздней версии — рекомендуется версия 2.12 или более поздняя.
Python3 — рекомендуется версия 3.9 или более поздняя.
netapp-lib требуется только при использовании ZAPI (установите с помощью «pip install netapp-lib»). Обратите внимание, что netapp-lib объявлена устаревшей и больше не поддерживается. Используйте на свой страх и риск.
Физическая или виртуальная кластерная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии; для поддержки REST требуется ONTAP 9.6 или более поздняя версия.

Параметры

Параметр	Комментарии
cert_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
feature_flags dictionary добавлено в netapp.ontap 20.5.0	Включение или отключение новой функции. Этот параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут изменяться без предварительного уведомления. Неизвестные ключи игнорируются.
force_ontap_version string добавлено в netapp.ontap 21.23.0	Переопределение версии ONTAP кластера при использовании REST. Поведение не определено, если версия не соответствует целевому кластеру. Этот параметр предусмотрен в качестве обходного решения, если версию кластера невозможно прочитать из-за проблем с разрешениями. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues. Укажите версию в формате 9.10 или 9.10.1, где каждый элемент является целым числом. Если для `use_rest` задано значение auto, это может привести к переключению на ZAPI с учетом версии и возможностей платформы. Игнорируется при использовании ZAPI.
from_ipspace string добавлено в netapp.ontap 2.15.0	При использовании с `from_name` выполняется попытка найти домен широковещательной рассылки `from_name` в `from_ipspace`; действие разделения переименует broadcast_domain и ipspace либо создаст новый домен широковещательной рассылки. Если `from_name` отсутствует, выполняется попытка найти домен широковещательной рассылки `name` в `from_ipspace` и изменить ipspace с помощью `ipspace`. Поддерживается только с REST.
from_name string добавлено в netapp.ontap 2.8.0	Укажите имя домена широковещательной рассылки, который требуется разделить, создав новый домен.
hostname string / обязательно	Имя хоста или IP-адрес экземпляра ONTAP.
http_port integer	Переопределение порта по умолчанию (80 или 443) этим портом.
https boolean	Включение и отключение HTTPS. Игнорируется при использовании REST, так как поддерживается только HTTPS. Игнорируется при использовании аутентификации с помощью SSL-сертификата, поскольку для нее требуется SSL. Варианты: `false` ← (по умолчанию) `true`
ipspace string	Укажите требуемое пространство IP-адресов для домена широковещательной рассылки. При использовании ZAPI пространство IP-адресов домена нельзя изменить после его создания. При использовании REST пространство IP-адресов домена можно изменить. Этот параметр обязателен при использовании REST.
key_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
mtu integer	Укажите требуемое значение MTU для домена широковещательной рассылки.
name псевдонимы: broadcast_domain string / обязательно	Укажите имя домена широковещательной рассылки.
ontapi integer	Версия API ONTAP, которую следует использовать.
password псевдонимы: pass string	Пароль указанного пользователя.
ports list / элементы=string	Укажите порты, связанные с этим доменом широковещательной рассылки. Значения следует разделять запятыми. Параметр задает ожидаемое состояние списка портов на любой момент времени. Добавляет порт, если он указан в ожидаемом состоянии, но отсутствует в текущем. Удаляет порт, если он указан в текущем состоянии, но отсутствует в ожидаемом. При разделении указывает порты, которые нужно отделить от текущего домена широковещательной рассылки и добавить в новый домен. Если все порты удалены из домена широковещательной рассылки или перенесены при разделении, домен будет удален автоматически. При использовании REST, если найдено точное совпадение портов с `from_name`, действие разделения переименует домен широковещательной рассылки с помощью `name`. При использовании REST, если найдено частичное совпадение портов с `from_name`, действие разделения создаст новый домен широковещательной рассылки с помощью `name` и переместит совпавшие порты из `from_name` в `name`. При использовании REST, если `ports` отсутствует в `from_name`, действие разделения создаст новый домен широковещательной рассылки с помощью `name` и `ports`.
state string	Должен ли указанный домен широковещательной рассылки существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_lambda boolean добавлено в netapp.ontap 23.2.0	Указывает, следует ли использовать функцию прокси AWS Lambda для подключения к системе ONTAP. Поддерживается только с REST. Варианты: `false` ← (по умолчанию) `true`
use_rest string	Использовать REST или ZAPI. always — всегда использовать REST API, если модуль поддерживает REST. Если модуль не поддерживает REST, выдается предупреждение. Если параметр модуля не поддерживается в REST, выдается ошибка. never — всегда использовать ZAPI, если модуль поддерживает ZAPI. Если параметр REST не поддерживается в ZAPI, может быть выдана ошибка. auto — пытаться использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае использовать ZAPI. По умолчанию: `"always"`
username псевдонимы: user string	Это может быть учетная запись с областью действия кластера или SVM — в зависимости от того, требуется ли API уровня кластера или уровня SVM. Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация с помощью SSL-сертификата с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация по сертификату должна быть включена.
validate_certs boolean	Если задано значение `no`, сертификаты SSL не будут проверяться. Устанавливайте это значение только для `False` на ресурсах под личным контролем, использующих самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
HTTPS включен по умолчанию и рекомендуется к использованию. Чтобы включить HTTP в кластере, выполните следующие команды: «set -privilege advanced;» «system services web modify -http-enabled true;»

Примеры

- name: Create broadcast domain
  netapp.ontap.na_ontap_broadcast_domain:
    state: present
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    name: ansible_domain
    mtu: 1000
    ipspace: Default
    ports: ["khutton-vsim1:e0d-12", "khutton-vsim1:e0d-13"]
- name: Modify broadcast domain
  netapp.ontap.na_ontap_broadcast_domain:
    state: present
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    name: ansible_domain
    mtu: 1100
    ipspace: Default
    ports: ["khutton-vsim1:e0d-12", "khutton-vsim1:e0d-13"]
- name: Split broadcast domain
  netapp.ontap.na_ontap_broadcast_domain:
    state: present
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    from_name: ansible_domain
    name: new_ansible_domain
    mtu: 1200
    ipspace: Default
    ports: khutton-vsim1:e0d-12
- name: Delete broadcast domain
  netapp.ontap.na_ontap_broadcast_domain:
    state: absent
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    name: ansible_domain
    ipspace: Default
- name: Create broadcast domain REST
  netapp.ontap.na_ontap_broadcast_domain:
    state: present
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    name: ansible_domain
    mtu: 1200
    ipspace: Default
    ports: ["khutton-vsim1:e0d-12", "khutton-vsim1:e0d-13", "khutton-vsim1:e0d-14"]
- name: Rename broadcast domain if exact match of ports REST
  netapp.ontap.na_ontap_broadcast_domain:
    state: present
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    from_name: ansible_domain
    name: new_ansible_domain
    mtu: 1200
    ipspace: Default
    ports: ["khutton-vsim1:e0d-12", "khutton-vsim1:e0d-13", "khutton-vsim1:e0d-14"]
- name: If partial match, remove e0d-12 from new_ansible_domain & create new domain ansible_domain with port e0d-12 REST
  netapp.ontap.na_ontap_broadcast_domain:
    state: present
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    from_name: new_ansible_domain
    name: ansible_domain
    mtu: 1200
    ipspace: Default
    ports: ["khutton-vsim1:e0d-12"]
- name: Modify both broadcast domain and ipspace REST.
  netapp.ontap.na_ontap_broadcast_domain:
    state: present
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    from_name: ansible_domain
    from_ipspace: Default
    name: ansible_domain_ip1
    ipspace: ipspace_1
    mtu: 1200
    ports: ["khutton-vsim1:e0d-12"]
- name: Modify ipspace only REST.
  netapp.ontap.na_ontap_broadcast_domain:
    state: present
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    from_ipspace: ipspace_1
    name: ansible_domain_ip1
    ipspace: Default
    mtu: 1200
    ports: ["khutton-vsim1:e0d-12"]
- name: Delete broadcast domain new_ansible_domain.
  netapp.ontap.na_ontap_broadcast_domain:
    state: absent
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    name: new_ansible_domain
    mtu: 1200
    ipspace: Default
    ports: ["khutton-vsim1:e0d-13", "khutton-vsim1:e0d-14"]

Авторы

Команда NetApp Ansible (@carchi8py)

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

© 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/netapp/ontap/na_ontap_broadcast_domain_module.html