Модуль netapp_eseries.santricity.netapp_e_volume – Управление томами хранения NetApp E-серии (стандартные и тонкие)

Примечание

Этот модуль входит в коллекцию netapp_eseries.santricity (версия 1.4.1).

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

Для установки используйте: ansible-galaxy collection install netapp_eseries.santricity.

Для использования в плейбуке укажите: netapp_eseries.santricity.netapp_e_volume.

Новое в netapp_eseries.santricity 2.2.0

Описание
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Создание или удаление томов (стандартных и тонких) для хранилищ NetApp E/EF-серии.

Параметры

Параметр	Комментарии
api_password строка / обязательно	Пароль для аутентификации с SANtricity Web Services Proxy или Embedded Web Services API.
api_url строка / обязательно	URL SANtricity Web Services Proxy или Embedded Web Services API. Пример https://prod-1.wahoo.acme.com/devmgr/v2
api_username строка / обязательно	Имя пользователя для аутентификации с SANtricity Web Services Proxy или Embedded Web Services API.
cache_without_batteries логическое добавлено в netapp_eseries.santricity 2.9.0	Указывает, следует ли использовать кэширование без резервного источника питания. Предупреждение, если cache_without_batteries==true и система хранения теряет питание, а резервного источника питания нет, данные будут потеряны! Варианты: `false` ← (по умолчанию) `true`
data_assurance_enabled логическое	Определяет, следует ли включить гарантию данных (DA) для тома. Доступно только при создании нового тома и на пуле хранения с дисками, поддерживающими функцию DA. Варианты: `false` ← (по умолчанию) `true`
initialization_timeout целое число добавлено в netapp_eseries.santricity 2.9.0	Продолжительность в секундах, после которой операция wait_for_initialization завершится. wait_for_initialization==True, чтобы это повлияло на операции модуля.
metadata словарь добавлено в netapp_eseries.santricity 2.8.0	Словарь, содержащий метаданные для использования, пользователя, местоположения и т. д. тома (словарь определяется произвольно для удобства пользователя). Если на массиве хранения существует workload_name, но метаданные отличаются, то определение рабочей нагрузки будет обновлено. (Изменения обновят все связанные тома!) workload_name должен быть указан при определении metadata.
name строка / обязательно	Имя тома для управления.
owning_controller строка добавлено в netapp_eseries.santricity 2.9.0	Указывает, какой контроллер будет основным владельцем тома. Если не указать, контроллер выберет владение. Варианты: `"A"` `"B"`
read_ahead_enable логическое добавлено в netapp_eseries.santricity 2.8.0	Указывает, включено ли автоматическое кэширование предварительной выборки чтения. Этот параметр не оказывает влияния на тонко распределенные тома, так как архитектура тонких томов не может извлечь выгоды из кэширования предварительной выборки. Варианты: `false` `true` ← (по умолчанию)
read_cache_enable логическое добавлено в netapp_eseries.santricity 2.8.0	Указывает, следует ли включить кэширование чтения для тома. Варианты: `false` `true` ← (по умолчанию)
segment_size_kb целое число	Размер сегмента тома Все значения в кибибайтах. Некоторые распространенные значения включают ‘8’, ‘16’, ‘32’, ‘64’, ‘128’, ‘256’ и ‘512’, но варианты зависят от системы. Получите окончательный список системы из netapp_eseries.santricity.netapp_e_facts в разделе segment_sizes. Если пул хранения — raidDiskPool, то размер сегмента должен составлять 128 кб. Миграции размера сегмента в этом модуле не допускаются. По умолчанию: `128`
size число с плавающей точкой / обязательно	Требуется только при state==’present’. Размер тома в size_unit. Размер виртуального тома в случае тонкого тома в size_unit. Максимальный размер виртуального тома тонко распределенного тома составляет 256 тб; однако могут существовать другие ограничения на уровне ОС.
size_unit строка	Единица измерения, используемая для интерпретации параметра размера. Варианты: `"bytes"` `"b"` `"kb"` `"mb"` `"gb"` ← (по умолчанию) `"tb"` `"pb"` `"eb"` `"zb"` `"yb"`
ssd_cache_enabled логическое	Включить существующий кэш SSD для тома (ошибка, если кэш SSD не определен). Значение по умолчанию — игнорировать существующее значение кэша SSD. Варианты: `false` ← (по умолчанию) `true`

ssid string	Идентификатор массива для управления. Это значение должно быть уникальным для каждого массива. Default: `"1"`
state string / required	Должен ли существовать указанный том Choices: `"present"` `"absent"`
storage_pool_name string	Требуется только при запрошенном state==’present’. Имя пула хранения, в котором должен находиться том.
thin_provision boolean	Должен ли том быть тонко выделенным. Тонкие тома могут быть созданы только тогда, когда raid_level==”raidDiskPool”. В общем, использование тонкой выделения не рекомендуется из-за влияния на производительность. Choices: `false` ← (default) `true`
thin_volume_expansion_policy string added in netapp_eseries.santricity 2.8.0	Это политика расширения тонкого тома. Когда thin_volume_expansion_policy==”automatic” и thin_volume_growth_alert_threshold превышено, thin_volume_max_repo_size будет автоматически расширен. Когда thin_volume_expansion_policy==”manual” и thin_volume_growth_alert_threshold превышено, система хранения будет ожидать вмешательства вручную. Политика расширения тонкого тома не может быть изменена для существующих тонких томов в этом модуле. В общем, вы почти всегда должны использовать thin_volume_expansion_policy==”automatic. Choices: `"automatic"` ← (default) `"manual"`
thin_volume_growth_alert_threshold integer added in netapp_eseries.santricity 2.8.0	Это пороговое значение использования репозитория тонкого выделения (в процентах). Когда процент используемого хранилища от максимального размера репозитория превышает это значение, будет выдано предупреждение, и будет выполнена thin_volume_expansion_policy. Значения должны быть между или равны 10 и 99. Default: `95`
thin_volume_max_repo_size float	Это максимальный размер, до которого будет разрешено увеличивать репозиторий тонкого тома. Имеет значение только когда thin_volume_expansion_policy==”automatic”. Когда процент thin_volume_repo_size от thin_volume_max_repo_size превышает thin_volume_growth_alert_threshold, будет выдано предупреждение, и массив хранения выполнит политику thin_volume_expansion_policy. Операции расширения, когда thin_volume_expansion_policy==”automatic”, увеличат максимальный размер репозитория. Значение по умолчанию будет таким же, как размер (в size_unit)
thin_volume_repo_size integer	Это значение (в size_unit) устанавливает выделенное пространство для репозитория тонкого выделения. Начальное значение должно быть между или равно 4 ГБ и 256 ГБ с шагом 4 ГБ. Во время операций расширения увеличение должно быть между или равно 4 ГБ и 256 ГБ с шагом 4 ГБ. Этот параметр не оказывает влияния во время расширения, если thin_volume_expansion_policy==”automatic”. В общем, вы почти всегда должны использовать thin_volume_expansion_policy==”automatic.
validate_certs boolean	Необходимо ли проверять сертификаты https? Choices: `false` `true` ← (default)
wait_for_initialization boolean added in netapp_eseries.santricity 2.8.0	Заставляет модуль ожидать завершения операций расширения, прежде чем продолжить. Choices: `false` ← (default) `true`
workload_name string added in netapp_eseries.santricity 2.8.0	Метка для рабочей нагрузки, определенной метаданными. Когда указаны workload_name и metadata, определенная рабочая нагрузка будет добавлена в массив хранения. Если workload_name существует в массиве хранения, но метаданные отличаются, определение рабочей нагрузки будет обновлено. (Изменения обновят все связанные тома!) Существующие рабочие нагрузки могут быть получены с помощью netapp_eseries.santricity.netapp_e_facts.
write_cache_enable boolean added in netapp_eseries.santricity 2.8.0	Указывает, следует ли включать кэширование записи для тома. Choices: `false` `true` ← (default)

Примечания

Примечание

Модули Ansible E-Series требуют наличия экземпляра прокси-сервера веб-служб (WSP) для управления системой хранения или системы хранения E-Series, которая поддерживает встроенный API веб-служб.
Встроенные веб-службы в настоящее время доступны на моделях оборудования E2800, E5700, EF570 и более новых.
netapp_eseries.santricity.netapp_e_storage_system может использоваться для настройки систем, управляемых экземпляром WSP.

Примеры

- name: Create simple volume with workload tags (volume meta data)
  netapp_e_volume:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
    state: present
    name: volume
    storage_pool_name: storage_pool
    size: 300
    size_unit: gb
    workload_name: volume_tag
    metadata:
      key1: value1
      key2: value2
- name: Create a thin volume
  netapp_e_volume:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
    state: present
    name: volume1
    storage_pool_name: storage_pool
    size: 131072
    size_unit: gb
    thin_provision: true
    thin_volume_repo_size: 32
    thin_volume_max_repo_size: 1024
- name: Expand thin volume's virtual size
  netapp_e_volume:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
    state: present
    name: volume1
    storage_pool_name: storage_pool
    size: 262144
    size_unit: gb
    thin_provision: true
    thin_volume_repo_size: 32
    thin_volume_max_repo_size: 1024
- name: Expand thin volume's maximum repository size
  netapp_e_volume:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
    state: present
    name: volume1
    storage_pool_name: storage_pool
    size: 262144
    size_unit: gb
    thin_provision: true
    thin_volume_repo_size: 32
    thin_volume_max_repo_size: 2048
- name: Delete volume
  netapp_e_volume:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
    state: absent
    name: volume

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

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

Ключ	Описание
msg строка	Состояние тома Возвращается: всегда Пример: `"Standard volume [workload_vol_1] has been created."`

Авторы

Kevin Hulquest (@hulquest)
Nathan Swartz (@ndswartz)

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

© 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_eseries/santricity/netapp_e_volume_module.html