Модуль dellemc.unity.cifsserver – Управление сервером CIFS в системе хранения Unity

Примечание

Этот модуль является частью коллекции dellemc.unity (версия 2.0.0).

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

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

Для использования в playbook укажите: dellemc.unity.cifsserver.

Новое в dellemc.unity 1.4.0

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

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

Управление сервером CIFS в системе хранения Unity включает в себя создание сервера CIFS, получение сведений о сервере CIFS и удаление сервера CIFS.

Требования

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

Устройство хранения данных Dell Unity версии 5.1 или выше.
Ansible-core 2.14 или выше.
Python 3.9, 3.10 или 3.11.
Storops Python SDK 1.2.11.

Параметры

Параметр	Комментарии
cifs_server_id string	Идентификатор сервера CIFS.
cifs_server_name string	Имя сервера CIFS.
domain string	Имя домена, в котором сервер SMB зарегистрирован в Active Directory.
domain_password string	Пароль домена Active Directory.
domain_username string	Имя пользователя домена Active Directory.
interfaces list / elements=string	Список IP-интерфейсов файлов, которые обслуживают протокол CIFS сервера SMB.
local_password string	Пароль администратора автономного сервера SMB.
nas_server_id string	Идентификатор сервера NAS, на котором будет размещен сервер CIFS.
nas_server_name string	Имя сервера NAS, на котором будет размещен сервер CIFS.
netbios_name string	Имя компьютера сервера SMB в сети Windows.
password string / required	Пароль сервера управления Unity.
port integer	Номер порта, через который осуществляется связь с сервером управления Unity. По умолчанию: `443`
state string / required	Определяет, должен ли существовать сервер CIFS или нет. Варианты: `"absent"` `"present"`
unispherehost string / required	IP-адрес или FQDN сервера управления Unity.
unjoin_cifs_server_account boolean	Оставить учетную запись сервера SMB незарегистрированной в Active Directory после удаления. `false` указывает на то, что учетная запись сервера SMB должна оставаться зарегистрированной после удаления. `true` указывает на то, что учетная запись сервера SMB должна быть отменена регистрации в Active Directory перед удалением. Варианты: `false` `true`
username string / required	Имя пользователя сервера управления Unity.
validate_certs aliases: verifycert boolean	Булева переменная, указывающая, следует ли проверять SSL-сертификат или нет. `true` - Указывает, что SSL-сертификат должен быть проверен. `false` - Указывает, что SSL-сертификат не должен быть проверен. Варианты: `false` `true` ← (по умолчанию)
workgroup string	Рабочая группа автономного сервера SMB.

Примечания

Примечание

Поддерживается check_mode.
Модули, представленные в этой коллекции под названием «dellemc.unity», созданы для поддержки платформы хранения данных Dell Unity.

Примеры

- name: Create CIFS server belonging to Active Directory
  dellemc.unity.cifsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "test_nas1"
    cifs_server_name: "test_cifs"
    domain: "ad_domain"
    domain_username: "domain_username"
    domain_password: "domain_password"
    state: "present"

- name: Get CIFS server details using CIFS server ID
  dellemc.unity.cifsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    cifs_server_id: "cifs_37"
    state: "present"

- name: Get CIFS server details using NAS server name
  dellemc.unity.cifsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "test_nas1"
    state: "present"

- name: Delete CIFS server
  dellemc.unity.cifsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    cifs_server_id: "cifs_37"
    unjoin_cifs_server_account: true
    domain_username: "domain_username"
    domain_password: "domain_password"
    state: "absent"

- name: Create standalone CIFS server
  dellemc.unity.cifsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    netbios_name: "ANSIBLE_CIFS"
    workgroup: "ansible"
    local_password: "Password123!"
    nas_server_name: "test_nas1"
    state: "present"

- name: Get CIFS server details using netbios name
  dellemc.unity.cifsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    netbios_name: "ANSIBLE_CIFS"
    state: "present"

- name: Delete standalone CIFS server
  dellemc.unity.cifsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    cifs_server_id: "cifs_40"
    state: "absent"

Значения возврата

Общие значения возврата документированы здесь, следующие являются полями, уникальными для данного модуля:

Ключ	Описание
changed boolean	Изменился ли ресурс или нет. Возвращается: всегда Пример: `true`
cifs_server_details словарь	Подробности сервера CIFS. Возвращается: Когда сервер CIFS существует Пример: {"description": null, "domain": "xxx.xxx.xxx.com", "existed": true, "file_interfaces": {"UnityFileInterfaceList": [{"UnityFileInterface": {"hash": -9223363258905013637, "id": "if_43"}}]}, "hash": -9223363258905010379, "health": {"UnityHealth": {"hash": 8777949765559}}, "id": "cifs_40", "is_standalone": false, "last_used_organizational_unit": "ou=Computers,ou=Dell NAS servers", "name": "ansible_cifs", "nas_server": {"UnityNasServer": {"hash": 8777949765531, "id": "nas_18"}}, "netbios_name": "ANSIBLE_CIFS", "smb_multi_channel_supported": true, "smb_protocol_versions": ["1.0", "2.0", "2.1", "3.0"], "smbca_supported": true, "workgroup": null}
description строка	Описание сервера SMB. Возвращается: успех
domain строка	Имя домена, в котором сервер SMB зарегистрирован в Active Directory. Возвращается: успех
file_interfaces словарь	Интерфейсы файлов, связанные с сервером NAS. Возвращается: успех
UnityFileInterfaceList список / элементы=строка	Список интерфейсов файлов, связанных с сервером NAS. Возвращается: успех
UnityFileInterface словарь	Подробности интерфейса файла, связанного с сервером NAS. Возвращается: успех
id строка	Уникальный идентификатор интерфейса файла. Возвращается: успех
id строка	Уникальный идентификатор экземпляра сервера CIFS. Возвращается: успех
is_standalone boolean	Указывает, является ли сервер SMB автономным. Возвращается: успех
name строка	Указанное пользователем имя сервера SMB. Возвращается: успех
nasServer словарь	Информация о сервере NAS в системе хранения. Возвращается: успех
UnityNasServer словарь	Информация о сервере NAS в системе хранения. Возвращается: успех
id строка	Уникальный идентификатор экземпляра сервера NAS. Возвращается: успех
netbios_name строка	Имя компьютера сервера SMB в сети Windows. Возвращается: успех
smb_multi_channel_supported boolean	Указывает, поддерживается ли функция многоканального SMB 3.0+. Возвращается: успех
smb_protocol_versions список / элементы=строка	Поддерживаемые протоколы SMB, такие как 1.0, 2.0, 2.1, 3.0 и т. д. Возвращается: успех
smbca_supported boolean	Указывает, поддерживает ли сервер SMB непрерывную доступность. Возвращается: успех
workgroup строка	Группа рабочих станций сети Windows для сервера SMB. Возвращается: успех

Авторы

Akash Shendge (@shenda1)

Ссылки на сборку

© 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/dellemc/unity/cifsserver_module.html