Spec-Zone.ru › Ansible

Модуль dellemc.unity.nasserver — управление NAS-серверами в системе хранения Unity

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: dellemc.unity.nasserver.

Добавлено в dellemc.unity 1.1.0

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

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

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

Требования

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

  • Устройство Dell Unity Storage версии 5.3 или более поздней.
  • Ansible-core 2.17 или более поздней версии.
  • Python 3.11, 3.12 или 3.13.
  • Storops Python SDK 1.2.12.

Параметры

Параметр

Комментарии

allow_unmapped_user

логическое значение

Этот флаг используется для обязательного отключения доступа в случае сбоя сопоставления пользователя.

Если true, доступ включается в случае сбоя сопоставления пользователя.

Если false, доступ отключается в случае сбоя сопоставления пользователя.

Параметр можно указать при изменении NAS-сервера.

Возможные значения:

  • false
  • true

current_unix_directory_service

строка

Служба каталогов, используемая для запроса сведений об идентификаторах UNIX (например, UID, GID, сетевых группах).

Параметр можно указать при изменении NAS-сервера.

Возможные значения:

  • "NONE"
  • "NIS"
  • "LOCAL"
  • "LDAP"
  • "LOCAL_THEN_NIS"
  • "LOCAL_THEN_LDAP"

default_unix_user

строка

Имя пользователя Unix по умолчанию, которому предоставляется доступ в случае сбоя сопоставления пользователя Windows с пользователем Unix.

Параметр можно указать при изменении NAS-сервера.

default_windows_user

строка

Имя пользователя Windows по умолчанию, которому предоставляется доступ в случае сбоя сопоставления пользователя Unix с пользователем Windows.

Параметр можно указать при изменении NAS-сервера.

enable_windows_to_unix_username_mapping

логическое значение

Этот параметр указывает, включено ли сопоставление имен пользователей Unix и Windows в обоих направлениях.

Параметр можно указать при изменении NAS-сервера.

Возможные значения:

  • false
  • true

is_backup_only

логическое значение

Указывает, используется ли NAS-сервер только для резервного копирования.

Параметр можно указать при изменении NAS-сервера.

Возможные значения:

  • false
  • true

is_multiprotocol_enabled

логическое значение

Этот параметр указывает, включен ли режим совместного доступа с поддержкой нескольких протоколов.

Параметр можно указать при изменении NAS-сервера.

Возможные значения:

  • false
  • true

is_packet_reflect_enabled

логическое значение

Если пакет необходимо отразить, для этого параметра следует задать значение true.

Параметр можно указать при изменении NAS-сервера.

Возможные значения:

  • false
  • true

is_replication_destination

логическое значение

Указывает, является ли NAS-сервер целевым сервером репликации.

Параметр можно указать при изменении NAS-сервера.

Возможные значения:

  • false
  • true

nas_server_id

строка

Идентификатор NAS-сервера.

Для выполнения задачи требуется указать либо nas_server_name, либо nas_server_id.

Параметры nas_server_name и nas_server_id являются взаимоисключающими.

nas_server_name

строка

Имя NAS-сервера.

Для выполнения задачи требуется указать либо nas_server_name, либо nas_server_id.

Параметры nas_server_name и nas_server_id являются взаимоисключающими.

nas_server_new_name

строка

Новое имя NAS-сервера.

Параметр можно указать при изменении NAS-сервера.

password

строка / обязательный

Пароль сервера управления Unity.

port

целое число

Номер порта для связи с сервером управления Unity.

По умолчанию: 443

replication_params

словарь

Параметры, необходимые для включения репликации.

destination_nas_server_name

строка

Имя целевого NAS-сервера.

Значение по умолчанию — имя исходного NAS-сервера с префиксом «DR_».

destination_pool_id

строка

Идентификатор пула для выделения целевых LUN.

Взаимоисключающий с destination_pool_name.

destination_pool_name

строка

Имя пула для выделения целевых LUN.

Взаимоисключающий с destination_pool_id.

destination_sp

строка

Процессор хранения целевого NAS-сервера

Возможные значения:

  • "SPA"
  • "SPB"

is_backup

логическое значение

Указывает, является ли целевой NAS-сервер сервером резервного копирования.

Возможные значения:

  • false
  • true

new_replication_name

строка

Имя, в которое нужно переименовать сеанс репликации.

remote_system

словарь

Сведения об удаленной системе, для которой настраивается репликация.

Параметр remote_system следует указать, если для replication_type задано значение remote.

remote_system_host

строка / обязательный

IP-адрес или полное доменное имя хоста удаленного Unity Unisphere.

remote_system_password

строка / обязательный

Пароль хоста удаленного Unity Unisphere.

remote_system_port

целое число

Порт, на котором размещен удаленный Unity Unisphere.

По умолчанию: 443

remote_system_username

строка / обязательный

Имя пользователя хоста удаленного Unity Unisphere.

remote_system_verifycert

логическое значение

Логическая переменная, указывающая, следует ли проверять SSL-сертификат хоста удаленного Unity Unisphere.

true — указывает, что SSL-сертификат необходимо проверить.

false — указывает, что SSL-сертификат проверять не следует.

Возможные значения:

  • false
  • true ← (значение по умолчанию)

replication_mode

строка

Режим репликации.

Для включения репликации этот параметр обязателен.

Возможные значения:

  • "asynchronous"
  • "manual"

replication_name

строка

Задаваемое пользователем имя сеанса репликации.

replication_type

строка

Тип репликации.

Возможные значения:

  • "local"
  • "remote"

rpo

целое число

Максимальное время ожидания перед синхронизацией исходного и целевого LUN системой.

Параметр rpo следует указать, если для replication_mode задано значение asynchronous.

Значение должно находиться в диапазоне от 5 до 1440.

replication_reuse_resource

логическое значение

Этот параметр указывает, следует ли использовать существующий NAS-сервер для репликации.

Возможные значения:

  • false
  • true

replication_state

строка

Состояние репликации.

Возможные значения:

  • "enable"
  • "disable"

state

строка / обязательный

Задайте состояние NAS-сервера на массиве.

Значение present означает, что после выполнения задачи NAS-сервер должен существовать в системе.

В этой версии удаление NAS-сервера не поддерживается. Поэтому, если для существующего NAS-сервера задано состояние absent, будет выдана ошибка.

Если NAS-сервер не существует и задано состояние absent, будет возвращено None.

Возможные значения:

  • "present"
  • "absent"

unispherehost

строка / обязательный

IP-адрес или полное доменное имя сервера управления Unity.

username

строка / обязательный

Имя пользователя сервера управления Unity.

validate_certs

псевдонимы: verifycert

логическое значение

Логическая переменная, указывающая, следует ли проверять SSL-сертификат.

true — указывает, что SSL-сертификат необходимо проверить.

false — указывает, что SSL-сертификат проверять не следует.

Возможные значения:

  • false
  • true ← (значение по умолчанию)

Примечания

Примечание

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

Примеры

- name: Get Details of NAS Server
  nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "{{nas_server_name}}"
    state: "present"

- name: Modify Details of NAS Server
  nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "{{nas_server_name}}"
    nas_server_new_name: "updated_sample_nas_server"
    is_replication_destination: false
    is_backup_only: false
    is_multiprotocol_enabled: true
    allow_unmapped_user: true
    default_unix_user: "default_unix_sample_user"
    default_windows_user: "default_windows_sample_user"
    enable_windows_to_unix_username_mapping: true
    current_unix_directory_service: "LDAP"
    is_packet_reflect_enabled: true
    state: "present"

- name: Enable replication for NAS Server on Local System
  nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_id: "nas_10"
    replication_reuse_resource: false
    replication_params:
      replication_name: "test_replication"
      destination_nas_server_name: "destination_nas"
      replication_mode: "asynchronous"
      rpo: 60
      replication_type: "local"
      destination_pool_name: "Pool_Ansible_Neo_DND"
      destination_sp: "SPA"
      is_backup: true
    replication_state: "enable"
    state: "present"

- name: Enable replication for NAS Server on Remote System
  nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    replication_reuse_resource: false
    replication_params:
      replication_name: "test_replication"
      destination_nas_server_name: "destination_nas"
      replication_mode: "asynchronous"
      rpo: 60
      replication_type: "remote"
      remote_system:
        remote_system_host: '10.10.10.10'
        remote_system_verifycert: false
        remote_system_username: 'test1'
        remote_system_password: 'test1!'
      destination_pool_name: "fastVP_pool"
      destination_sp: "SPA"
      is_backup: true
    replication_state: "enable"
    state: "present"

- name: Enable replication for NAS Server on Remote System in existing NAS Server
  nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    replication_reuse_resource: true
    replication_params:
      destination_nas_server_name: "destination_nas"
      replication_mode: "asynchronous"
      rpo: 60
      replication_type: "remote"
      replication_name: "test_replication"
      remote_system:
        remote_system_host: '10.10.10.10'
        remote_system_verifycert: false
        remote_system_username: 'test1'
        remote_system_password: 'test1!'
      destination_pool_name: "fastVP_pool"
    replication_state: "enable"
    state: "present"

- name: Modify replication on the nasserver
  nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    replication_params:
      replication_name: "test_repl"
      new_replication_name: "test_repl_updated"
      replication_mode: "asynchronous"
      rpo: 50
    replication_state: "enable"
    state: "present"

- name: Disable replication on the nasserver
  nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    replication_state: "disable"
    state: "present"

- name: Disable replication by specifying replication_name on the nasserver
  nasserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    replication_params:
      replication_name: "test_replication"
    replication_state: "disable"
    state: "present"

Возвращаемые значения

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

Ключ

Описание

changed

boolean

Изменился ли ресурс.

Возвращается: всегда

Пример: true

nas_server_details

dictionary

Сведения о NAS-сервере.

Возвращается: если NAS-сервер существует.

Пример: {"allow_unmapped_user": null, "cifs_server": {"UnityCifsServerList": [{"UnityCifsServer": {"hash": 8761756885270, "id": "cifs_34"}}]}, "current_sp": {"UnityStorageProcessor": {"hash": 8761756885273, "id": "spb"}}, "current_unix_directory_service": "NasServerUnixDirectoryServiceEnum.NIS", "default_unix_user": null, "default_windows_user": null, "existed": true, "file_dns_server": {"UnityFileDnsServer": {"hash": 8761756885441, "id": "dns_12"}}, "file_interface": {"UnityFileInterfaceList": [{"UnityFileInterface": {"hash": 8761756889908, "id": "if_37"}}]}, "filesystems": null, "hash": 8761757005084, "health": {"UnityHealth": {"hash": 8761756867588}}, "home_sp": {"UnityStorageProcessor": {"hash": 8761756867618, "id": "spb"}}, "id": "nas_10", "is_backup_only": false, "is_multi_protocol_enabled": false, "is_packet_reflect_enabled": false, "is_replication_destination": false, "is_replication_enabled": true, "is_windows_to_unix_username_mapping_enabled": null, "name": "dummy_nas", "pool": {"UnityPool": {"hash": 8761756885360, "id": "pool_7"}}, "preferred_interface_settings": {"UnityPreferredInterfaceSettings": {"hash": 8761756885438, "id": "preferred_if_10"}}, "replication_type": "ReplicationTypeEnum.REMOTE", "size_allocated": 3489660928, "tenant": null, "virus_checker": {"UnityVirusChecker": {"hash": 8761756885426, "id": "cava_10"}}}

allow_unmapped_user

boolean

Включение или отключение доступа в случае сбоя сопоставления пользователя.

Возвращается: при успешном выполнении

current_unix_directory_service

string

Служба каталогов, используемая для получения сведений об идентификаторах UNIX (например, UID, GID, сетевых группах).

Возвращается: при успешном выполнении

default_unix_user

string

Имя пользователя Unix по умолчанию, которому предоставляется доступ в случае сбоя сопоставления пользователей Windows с пользователями Unix.

Возвращается: при успешном выполнении

default_windows_user

string

Имя пользователя Windows по умолчанию, которому предоставляется доступ в случае сбоя сопоставления пользователей Unix с пользователями Windows.

Возвращается: при успешном выполнении

id

string

Идентификатор NAS-сервера.

Возвращается: при успешном выполнении

is_backup_only

boolean

Используется ли NAS-сервер только для резервного копирования.

Возвращается: при успешном выполнении

is_multi_protocol_enabled

boolean

Указывает, включён ли режим многопротокольного совместного доступа.

Возвращается: при успешном выполнении

is_packet_reflect_enabled

boolean

Указывает, нужно ли включить отражение пакетов.

Возвращается: при успешном выполнении

is_replication_destination

boolean

Значение true, если NAS-сервер является местом назначения репликации.

Возвращается: при успешном выполнении

is_windows_to_unix_username_mapping_enabled

boolean

Указывает, включено ли сопоставление имён пользователей Unix и Windows в одном или обоих направлениях.

Возвращается: при успешном выполнении

name

string

Имя NAS-сервера.

Возвращается: при успешном выполнении

Авторы

  • P Srinivas Rao (@srinivas-rao5)

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

  • Отслеживание проблем
  • Репозиторий (исходный код)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API