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

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 22.12.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 или более поздняя версия рекомендуется.
При использовании ZAPI, netapp-lib 2018.11.13 или более поздняя версия (установка с помощью ‘pip install netapp-lib’), сильно рекомендуется netapp-lib 2020.3.12, так как она предоставляет более подробные сообщения об ошибках при подключении.
физическая или виртуальная кластерная система Data ONTAP, модули поддерживают Data ONTAP 9.1 и выше, поддержка REST требует ONTAP 9.6 или более поздней версии.

Параметры

Параметр	Комментарии
cert_filepath строка добавлено в netapp.ontap 20.6.0	путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6.
feature_flags словарь добавлено в netapp.ontap 20.5.0	Включить или выключить новую функцию. Это можно использовать для включения экспериментальной функции или выключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются.
force_ontap_version строка добавлено в 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 строка добавлено в netapp.ontap 2.15.0	если используется с `from_name`, будет пытаться найти домен широковещательной передачи `from_name` в `from_ipspace`, действие разделения будет либо переименовывать broadcast_domain и ipspace, либо создавать новый домен широковещательной передачи. Если `from_name` отсутствует, будет пытаться найти `name` домен широковещательной передачи в `from_ipspace` и изменить ipspace с использованием `ipspace`. Поддерживается только с REST.
from_name строка добавлено в netapp.ontap 2.8.0	Укажите имя домена широковещательной передачи, которое будет разделено на новый домен широковещательной передачи.
hostname строка / обязательно	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределить стандартный порт (80 или 443) на указанный порт.
https логическое значение	Включить или выключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации SSL-сертификатом, так как она требует SSL. Варианты: `false` ← (по умолчанию) `true`
ipspace строка	Укажите необходимый ipspace для домена широковещательной передачи. С помощью ZAPI, ipspace домена не может быть изменен после создания домена. С помощью REST, ipspace домена может быть изменен. Этот параметр требуется при использовании REST.
key_filepath строка добавлено в netapp.ontap 20.6.0	путь к файлу SSL-ключа клиента.
mtu целое число	Укажите необходимый mtu для домена широковещательной передачи.
name псевдонимы: broadcast_domain строка / обязательно	Укажите имя домена широковещательной передачи.
ontapi целое число	Версия api ontap для использования
password псевдонимы: pass строка	Пароль для указанного пользователя.
ports список / элементы=строка	Укажите порты, связанные с этим доменом широковещательной передачи. Должны быть разделены запятыми. Представляет ожидаемое состояние списка портов в любой момент времени. Добавьте порт, если он указан в ожидаемом состоянии, но отсутствует в текущем состоянии. Удалите порт, если он указан в текущем состоянии, но отсутствует в ожидаемом состоянии. Для действия разделения это порты, которые нужно разделить с текущего домена широковещательной передачи и добавить в новый домен широковещательной передачи. Если все порты удалены или разделены с домена широковещательной передачи, домен широковещательной передачи будет удален автоматически. При использовании REST, если точное соответствие портов найдено с `from_name`, действие разделения переименует домен широковещательной передачи, используя `name`. При использовании REST, если частичное соответствие портов с `from_name`, действие разделения создаст новый домен широковещательной передачи, используя `name`, и переместит частично соответствующие порты из `from_name` в `name`. При использовании REST, если `ports` не находится в `from_name`, действие разделения создаст новый домен широковещательной передачи, используя `name`, с `ports`.
state строка	Указывает, должен ли указанный домен широковещательной передачи существовать или нет. Варианты: `"present"` ← (по умолчанию) `"absent"`

use_rest string	Использовать REST или ZAPI. always – всегда будет использовать REST API, если модуль его поддерживает. Выдаётся предупреждение, если модуль не поддерживает REST. Выдаётся ошибка, если параметр модуля не поддерживается в REST. never – всегда будет использовать ZAPI, если модуль его поддерживает. Может быть выдана ошибка, если параметр REST не поддерживается в ZAPI. auto – попытается использовать REST API, если модуль его поддерживает и параметры модулей поддерживаются. В противном случае использует ZAPI. По умолчанию: `"auto"`
username aliases: user string	Может быть учётной записью уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Для получения дополнительной информации, пожалуйста, ознакомьтесь с документацией https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации базовая аутентификация, используя имя пользователя и пароль, аутентификация с помощью сертификата 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"]

Авторы

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

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

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