Модуль netapp.ontap.na_ontap_cifs_unix_symlink_mapping – Модуль NetApp ONTAP для управления отображением символьных ссылок UNIX для клиентов CIFS.

Примечание

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

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

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

Чтобы использовать его в книге задач, укажите: netapp.ontap.na_ontap_cifs_unix_symlink_mapping.

Впервые появился в netapp.ontap 22.9.0

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

Описание

Создание/модификация/удаление отображения символьных ссылок UNIX для клиента CIFS.

Требования

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

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 string added in netapp.ontap 20.6.0	путь к файлу клиентского SSL-сертификата (.pem). не поддерживается с python 2.6.
cifs_path string	Указывает путь CIFS в целевом расположении, на которое указывает символическая ссылка. Обратите внимание, что это значение указывается с использованием пути в стиле UNIX. Оно должно начинаться и заканчиваться прямым слешем (/).
cifs_server string	Указывает целевой CIFS-сервер (DNS-имя, IP-адрес или имя NetBIOS). Это поле является обязательным, если местоположение символической ссылки — «widelink».
feature_flags dictionary added in netapp.ontap 20.5.0	Включить или отключить новую функцию. Это может использоваться для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут изменяться без уведомления. Неизвестные ключи игнорируются.
force_ontap_version string added in 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.
home_directory boolean	Укажите, является ли целевая общая папка домашней директорией. Значение по умолчанию — false. Варианты: `false` ← (default) `true`
hostname string / required	Имя хоста или IP-адрес экземпляра ONTAP.
http_port integer	Переопределить порт по умолчанию (80 или 443) этим портом
https boolean	Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании проверки подлинности SSL-сертификата, так как она требует SSL. Варианты: `false` ← (default) `true`
key_filepath string added in netapp.ontap 20.6.0	путь к файлу клиентского SSL-ключа.
locality string	Указывает, является ли символическая ссылка CIFS локальной или глобальной. Настройка по умолчанию — локальная. Поддерживаются следующие значения: local — локальная символическая ссылка отображается только на ту же самую общую папку CIFS. widelink — глобальная символическая ссылка отображается на любую общую папку CIFS в сети. Варианты: `"local"` ← (default) `"widelink"`
ontapi integer	Версия API ontap для использования
password aliases: pass string	Пароль для указанного пользователя.
share_name string	Указывает имя общей папки CIFS на целевом сервере CIFS, на которую указывает символическая ссылка UNIX.
state string	Должно ли существовать указанное сопоставление символических ссылок или нет. Варианты: `"present"` ← (default) `"absent"`
unix_path string / required	Указывает префикс пути UNIX, который должен соответствовать для сопоставления. Он должен начинаться и заканчиваться прямым слешем (/).
use_rest string	Использовать REST или ZAPI. always — всегда будет использовать REST API, если модуль поддерживает REST. Предупреждение выдается, если модуль не поддерживает REST. Ошибка выдается, если параметр модуля не поддерживается в REST. never — всегда будет использовать ZAPI, если модуль поддерживает ZAPI. Ошибка может быть выдана, если параметр REST не поддерживается в ZAPI. auto — попытается использовать REST API, если модуль поддерживает REST и параметры модулей поддерживаются. В противном случае возвращается к ZAPI. По умолчанию: `"auto"`

логин псевдонимы: user строка	Может быть учетной записью уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Для получения дополнительной информации, пожалуйста, ознакомьтесь с документацией https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации: аутентификация по протоколу basic, используя имя пользователя и пароль; аутентификация по SSL-сертификату, используя файл ssl-клиентского сертификата и, необязательно, файл закрытого ключа. Для использования сертификата сертификат должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификатам.
validate_certs булево	Если установлено в `no`, SSL-сертификаты не будут проверены. Это должно быть установлено только в `False` на сайтах с собственным сертификатом. Варианты: `false` `true` ← (по умолчанию)
vserver строка / обязательно	Имя vserver для использования.

Примечания

Примечание

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

Примеры

- name: Create a UNIX symlink mapping for CIFS share
  netapp.ontap.na_ontap_cifs_unix_symlink_mapping:
    state: present
    vserver: "{{ svm }}"
    unix_path: "/example1/"
    share_name: "share1"
    cifs_path: "/path1/test_dir/"
    cifs_server: "CIFS"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

- name: Update a specific UNIX symlink mapping for a SVM
  netapp.ontap.na_ontap_cifs_unix_symlink_mapping:
    state: present
    vserver: "{{ svm }}"
    unix_path: "/example1/"
    share_name: "share2"
    cifs_path: "/path2/test_dir/"
    cifs_server: "CIFS"
    locality: "widelink"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

- name: Remove a specific UNIX symlink mapping for a SVM
  netapp.ontap.na_ontap_cifs_unix_symlink_mapping:
    state: absent
    vserver: "{{ svm }}"
    unix_path: "/example1/"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

Авторы

Команда NetApp Ansible (@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_cifs_unix_symlink_mapping_module.html