модуль netapp.ontap.na_ontap_vserver_peer – одноранговая связь Vserver в NetApp ONTAP

Примечание

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

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

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

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

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

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

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

Создание и удаление одноранговых связей Vserver

Требования

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

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 или более поздней версии.

Параметры

Параметр	Комментарии
applications list / elements=string	Список приложений, которые могут использовать одноранговую связь. Поддержка FlexCache доступна начиная с ONTAP 9.5.
cert_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
dest_hostname string	УСТАРЕЛО — используйте `peer_options`. Имя хоста или IP-адрес назначения. Обязательно для создания одноранговой связи Vserver с удаленным кластером.
dest_password string	УСТАРЕЛО — используйте `peer_options`. Пароль назначения. Необязателен, если совпадает с паролем источника.
dest_username string	УСТАРЕЛО — используйте `peer_options`. Имя пользователя назначения. Необязательно, если совпадает с именем пользователя источника.
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.
hostname string / обязательный	Имя хоста или IP-адрес экземпляра ONTAP.
http_port integer	Переопределение порта по умолчанию (80 или 443) этим портом
https boolean	Включение и отключение HTTPS. Игнорируется при использовании REST, поскольку поддерживается только HTTPS. Игнорируется при использовании аутентификации с помощью сертификата SSL, поскольку для нее требуется SSL. Варианты: `false` ← (по умолчанию) `true`
key_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
lambda_config dictionary добавлено в netapp.ontap 23.4.0	Параметры конфигурации прокси-функции AWS Lambda. Этот параметр и его вложенные параметры поддерживаются только в REST.
aws_profile string	Имя профиля AWS, используемого для аутентификации.
aws_region string / обязательный	Имя региона AWS.
function_name string / обязательный	Имя вызываемой функции AWS Lambda.
local_name_for_peer string	Указывает локальное имя однорангового Vserver в связи. Используйте этот параметр, если видите сообщение «Error creating vserver peer … Vserver name conflicts with one of the following».
local_name_for_source string	Указывает локальное имя исходного Vserver в связи. Используйте этот параметр, если видите сообщение «Error accepting vserver peer … System generated a name for the peer Vserver because of a naming conflict».
ontapi integer	Используемая версия API ONTAP
password псевдонимы: pass string	Пароль указанного пользователя.
peer_cluster string	Указывает имя однорангового кластера. Обязательно для создания одноранговой связи Vserver с удаленным кластером.
peer_options dictionary добавлено в netapp.ontap 21.8.0	IP-адрес и параметры подключения одноранговой системы. Если какой-либо из этих параметров не указан, используется соответствующий параметр источника.
cert_filepath string	Путь к файлу сертификата клиента SSL (.pem).
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.
hostname string / обязательный	Имя хоста или IP-адрес экземпляра ONTAP.
http_port integer	Переопределение порта по умолчанию (80 или 443) этим портом
https boolean	Включение и отключение HTTPS. Варианты: `false` `true`
key_filepath string	Путь к файлу ключа клиента SSL.
lambda_config dictionary добавлено в netapp.ontap 23.4.0	Параметры конфигурации прокси-функции AWS Lambda. Этот параметр и его вложенные параметры поддерживаются только в REST.
aws_profile string	Имя профиля AWS, используемого для аутентификации.
aws_region string / обязательный	Имя региона AWS.
function_name string / обязательный	Имя вызываемой функции AWS Lambda.
ontapi integer	Используемая версия API ONTAP
password псевдонимы: pass string	Пароль указанного пользователя.
use_lambda boolean добавлено в netapp.ontap 23.4.0	Указывает, следует ли использовать прокси-функцию AWS Lambda для подключения к системе ONTAP. Поддерживается только в REST. Варианты: `false` `true`
use_rest string	REST API, если целевая система поддерживает его для всех необходимых модулю ресурсов и атрибутов. В противном случае будет выполнен переход на ZAPI. always — всегда использовать REST API never — всегда использовать ZAPI auto — попытаться использовать REST API
username псевдонимы: user string	Имя пользователя при использовании базовой аутентификации.
validate_certs boolean	Если задано значение `no`, сертификаты SSL не проверяются. Задавайте это значение только для `False` на сайтах под вашим контролем, использующих самоподписанные сертификаты. Варианты: `false` `true`
peer_vserver string / обязательный	Указывает имя однорангового Vserver в связи.
state string	Должна ли указанная одноранговая связь Vserver существовать. Варианты: `"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` ← (по умолчанию)
vserver string / обязательный	Указывает имя исходного Vserver в связи.

Примечания

Примечание

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

Примеры

- name: Source vserver peer create
  netapp.ontap.na_ontap_vserver_peer:
    state: present
    peer_vserver: ansible2
    peer_cluster: ansibleCluster
    local_name_for_peer: peername
    local_name_for_source: sourcename
    vserver: ansible
    applications: ['snapmirror']
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    peer_options:
      hostname: "{{ netapp_dest_hostname }}"

- name: vserver peer delete
  netapp.ontap.na_ontap_vserver_peer:
    state: absent
    peer_vserver: ansible2
    vserver: ansible
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Source vserver peer create - different credentials
  netapp.ontap.na_ontap_vserver_peer:
    state: present
    peer_vserver: ansible2
    peer_cluster: ansibleCluster
    local_name_for_peer: peername
    local_name_for_source: sourcename
    vserver: ansible
    applications: ['snapmirror']
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    peer_options:
      hostname: "{{ netapp_dest_hostname }}"
      cert_filepath: "{{ cert_filepath }}"
      key_filepath: "{{ key_filepath }}"

Авторы

Команда 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_vserver_peer_module.html