Модуль netapp.ontap.na_ontap_cifs_server — конфигурация CIFS-сервера NetApp ONTAP

Примечание

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

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

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

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

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

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

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

Создание, удаление и изменение CIFS-сервера.

Требования

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

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

Параметры

Параметр	Комментарии
admin_password string	Задает пароль администратора CIFS-сервера. При использовании со значением absent учетная запись будет удалена, если также указано значение admin_user_name.
admin_user_name string	Задает имя пользователя администратора CIFS-сервера. При использовании со значением absent учетная запись будет удалена, если также указано значение admin_password.
aes_netlogon_enabled boolean добавлено в netapp.ontap 21.20.0	Указывает, включен ли ключ сеанса AES для канала Netlogon. Поддерживается только с REST и требует ONTAP версии 9.10.1 или новее. Варианты: `false` `true`
cert_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
comment string добавлено в netapp.ontap 22.13.0	Описательный комментарий к CIFS-серверу. Клиенты SMB могут видеть комментарий CIFS-сервера при просмотре серверов в сети. Поддерживается только с REST.
default_site string добавлено в netapp.ontap 22.8.0	Указывает сайт в домене Active Directory, связанный с CIFS-сервером, если Data ONTAP не удается определить подходящий сайт. Поддерживается только с REST и требует ONTAP версии 9.13.1 или новее.
domain string	Полное доменное имя Windows Active Directory, к которому относится этот CIFS-сервер.
encrypt_dc_connection boolean добавлено в netapp.ontap 21.20.0	Указывает, требуется ли шифрование для подключений к контроллерам домена. Поддерживается только с REST и требует ONTAP версии 9.8 или новее. Для ZAPI используйте na_ontap_vserver_cifs_security. Варианты: `false` `true`
feature_flags dictionary добавлено в netapp.ontap 20.5.0	Включает или отключает новую функцию. Можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут измениться без предварительного уведомления. Неизвестные ключи игнорируются.
force boolean добавлено в netapp.ontap 2.7.0	Если состояние — present и этот параметр установлен, существующая в Active Directory учетная запись компьютера с именем, указанным в параметре «name», будет перезаписана и использована повторно. Если состояние — absent и этот параметр установлен, локальная конфигурация CIFS удаляется независимо от ошибок связи. Для REST требуется ONTAP версии 9.11. Варианты: `false` `true`
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_name string добавлено в netapp.ontap 21.19.0	Указывает существующее имя cifs_server. Этот параметр используется для переименования cifs_server. Поддерживается только в REST; для него требуется установить force в True. Требуется ONTAP версии 9.11.0. Если служба запущена, для переименования она будет остановлена и автоматически перезапущена. Если служба остановлена, после переименования она будет ненадолго перезапущена, а затем снова остановлена.
hostname string / обязательный	Имя хоста или IP-адрес экземпляра ONTAP.
http_port integer	Переопределяет порт по умолчанию (80 или 443), используя указанный порт
https boolean	Включает и отключает HTTPS. Игнорируется при использовании REST, поскольку поддерживается только HTTPS. Игнорируется при использовании аутентификации по сертификату SSL, поскольку для нее требуется SSL. Варианты: `false` ← (по умолчанию) `true`
is_multichannel_enabled boolean добавлено в netapp.ontap 22.10.0	Указывает, поддерживает ли CIFS-сервер функцию Multichannel. Поддерживается только с REST и требует ONTAP версии 9.10 или новее. Варианты: `false` `true`
kdc_encryption boolean добавлено в netapp.ontap 21.20.0	Указывает, включено ли шифрование AES-128 и AES-256 для всех видов связи на основе Kerberos с KDC Active Directory. Поддерживается только с REST. Для ZAPI используйте na_ontap_vserver_cifs_security. Варианты: `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.
ldap_referral_enabled boolean добавлено в netapp.ontap 21.20.0	Указывает, включено ли следование перенаправлениям LDAP для подключений AD LDAP. Поддерживается только с REST и требует ONTAP версии 9.10.1 или новее. Для ZAPI используйте na_ontap_vserver_cifs_security. Варианты: `false` `true`
lm_compatibility_level string добавлено в netapp.ontap 22.9.0	Указывает минимальный уровень безопасности CIFS-сервера, также известный как LMCompatibilityLevel. Поддерживается только с REST и требует ONTAP версии 9.8 или новее. Для ZAPI используйте na_ontap_vserver_cifs_security. Варианты: `"lm_ntlm_ntlmv2_krb"` `"ntlm_ntlmv2_krb"` `"ntlmv2_krb"` `"krb"`
name псевдонимы: cifs_server_name string / обязательный	Указывает имя cifs_server.
ontapi integer	Версия API ONTAP, которую следует использовать
ou string добавлено в netapp.ontap 2.7.0	Подразделение организации (OU) в Windows Active Directory, к которому относится этот CIFS-сервер.
password псевдонимы: pass string	Пароль указанного пользователя.
restrict_anonymous string добавлено в netapp.ontap 21.20.0	Указывает уровень доступа, предоставляемый анонимному пользователю. Поддерживается только с REST. Варианты: `"no_enumeration"` `"no_restriction"` `"no_access"`
service_state string	Административное состояние CIFS-сервера. Варианты: `"stopped"` `"started"`
session_security string добавлено в netapp.ontap 21.20.0	Указывает безопасность сеанса клиента для подключений AD LDAP. Поддерживается только с REST и требует ONTAP версии 9.10.1 или новее. Для ZAPI используйте na_ontap_vserver_cifs_security. Варианты: `"none"` `"sign"` `"seal"`
smb_encryption boolean добавлено в netapp.ontap 21.20.0	Определяет, требуется ли шифрование SMB для входящего трафика CIFS. Поддерживается только с REST. Для ZAPI используйте na_ontap_vserver_cifs_security. Варианты: `false` `true`
smb_signing boolean добавлено в netapp.ontap 21.20.0	Указывает, требуется ли подпись для входящего трафика CIFS. Поддерживается только с REST. Для ZAPI используйте na_ontap_vserver_cifs_security. Варианты: `false` `true`
state string	Указывает, должен ли существовать указанный cifs_server. Варианты: `"present"` ← (по умолчанию) `"absent"`
try_ldap_channel_binding boolean добавлено в netapp.ontap 21.20.0	Указывает, выполняется ли попытка привязки канала при использовании TLS/LDAPS. Поддерживается только с REST и требует ONTAP версии 9.10.1 или новее. Для ZAPI используйте na_ontap_vserver_cifs_security. Варианты: `false` `true`
use_lambda boolean добавлено в netapp.ontap 23.2.0	Указывает, следует ли использовать функцию прокси-сервера AWS Lambda для подключения к системе ONTAP. Поддерживается только с REST. Варианты: `false` ← (по умолчанию) `true`
use_ldaps boolean добавлено в netapp.ontap 21.20.0	Указывает, следует ли использовать LDAPS для защищенных подключений Active Directory LDAP. Поддерживается только с REST и требует ONTAP версии 9.10.1 или новее. Для ZAPI используйте na_ontap_vserver_cifs_security. Варианты: `false` `true`
use_rest string	Определяет, использовать REST или ZAPI. always — всегда использовать REST API, если модуль поддерживает REST. Если модуль не поддерживает REST, выдается предупреждение. Если параметр модуля не поддерживается в REST, выдается ошибка. never — всегда использовать ZAPI, если модуль поддерживает ZAPI. Может быть выдана ошибка, если параметр REST не поддерживается в ZAPI. auto — пытаться использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае используется ZAPI. По умолчанию: `"always"`
use_start_tls boolean добавлено в netapp.ontap 21.20.0	Указывает, следует ли использовать SSL/TLS для защищенного взаимодействия с серверами Active Directory LDAP. Поддерживается только с REST и требует ONTAP версии 9.10.1 или новее. Для ZAPI используйте na_ontap_vserver_cifs_security. Варианты: `false` `true`
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.
workgroup string	Имя NetBIOS домена или рабочей группы, к которой относится этот CIFS-сервер.

Примечания

Примечание

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

Примеры

- name: Create cifs_server
  netapp.ontap.na_ontap_cifs_server:
    state: present
    name: data2
    vserver: svm1
    service_state: stopped
    domain: "{{ id_domain }}"
    admin_user_name: "{{ domain_login }}"
    admin_password: "{{ domain_pwd }}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete cifs_server
  netapp.ontap.na_ontap_cifs_server:
    state: absent
    name: data2
    vserver: svm1
    admin_user_name: "{{ domain_login }}"
    admin_password: "{{ domain_pwd }}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Start cifs_server
  netapp.ontap.na_ontap_cifs_server:
    state: present
    name: data2
    vserver: svm1
    service_state: started
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Stop cifs_server
  netapp.ontap.na_ontap_cifs_server:
    state: present
    name: data2
    vserver: svm1
    service_state: stopped
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Rename cifs_server - REST
  netapp.ontap.na_ontap_cifs_server:
    state: present
    from_name: data2
    name: cifs
    vserver: svm1
    force: true
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Modify cifs_server security - REST
  netapp.ontap.na_ontap_cifs_server:
    state: present
    name: data2
    vserver: svm1
    service_state: stopped
    encrypt_dc_connection: true
    smb_encryption: true
    kdc_encryption: true
    smb_signing: true
    aes_netlogon_enabled: true
    ldap_referral_enabled: true
    session_security: seal
    try_ldap_channel_binding: false
    use_ldaps: true
    use_start_tls: true
    restrict_anonymous: no_access
    domain: "{{ id_domain }}"
    admin_user_name: "{{ domain_login }}"
    admin_password: "{{ domain_pwd }}"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Авторы

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