netapp_e_volume – Управление томами NetApp E-серии (стандартными и тоннами)
Обзор
- Создание или удаление томов (стандартных и тонких) для хранилищ 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 логическое значение добавлено в 2.9 |
| Указывает, следует ли использовать кэширование без резервного питания. Предупреждение, cache_without_batteries==true и система хранения теряет питание, и нет резервного питания, данные будут потеряны! |
| data_assurance_enabled логическое значение |
| Определяет, следует ли включить гарантию данных (Data Assurance, DA) для тома. Доступно только при создании нового тома и на хранилище с дисками, поддерживающими функцию DA. |
| initialization_timeout целое число добавлено в 2.9 | Продолжительность в секундах, прежде чем операция wait_for_initialization завершится.
wait_for_initialization==True чтобы операция имела какой-либо эффект на операции модуля. | |
| metadata словарь добавлено в 2.8 | Словарь, содержащий метаданные для использования, пользователя, местоположения и т.д. тома (словарь произвольно определяется для того, что пользователь считает полезным). Если workload_name существует на массиве хранения, но метаданные отличаются, определение рабочей нагрузки будет обновлено. (Изменения обновит все связанные тома!)
workload_name должно быть указано при определении metadata. | |
| name - / обязательно | Имя тома для управления. | |
| owning_controller - добавлено в 2.9 |
| Указывает, какой контроллер будет основным владельцем тома. Если не указать, контроллер выберет владение. |
| read_ahead_enable логическое значение добавлено в 2.8 |
| Указывает, включено ли автоматическое кэширование предварительного чтения. Этот параметр не влияет на тонкопропорциональные тома, так как архитектура тонких томов не может извлечь выгоды из кэширования предварительного чтения. |
| read_cache_enable логическое значение добавлено в 2.8 |
| Указывает, следует ли включить кэширование чтения для тома. |
| segment_size_kb - | Значение по умолчанию: "128" | Размер сегмента тома Все значения в кибибайтах. Некоторые распространённые значения включают '8', '16', '32', '64', '128', '256' и '512', но варианты зависят от системы. Получите окончательный список системы из netapp_e_facts в разделе segment_sizes. Если хранилище является raidDiskPool, размер сегмента должен быть 128 КБ. Миграции размера сегмента в этом модуле не допускаются |
| size - / обязательно | Требуется только при state=='present'. Размер тома в size_unit. Размер виртуального тома в случае тонкого тома в size_unit. Максимальный размер виртуального тома тонкопропорционального тома составляет 256 ТБ; однако могут существовать другие ограничения на уровне ОС. | |
| size_unit - |
| Единица измерения, используемая для интерпретации параметра размера. |
| ssd_cache_enabled логическое значение |
| Включать ли существующий SSD-кеш на томе (не удаётся, если SSD-кеш не определён). Значение по умолчанию — игнорировать существующее значение SSD-кеша. |
| ssid строка | Значение по умолчанию: 1 | Идентификатор массива для управления. Это значение должно быть уникальным для каждого массива. |
| state - / обязательно |
| Следует ли создать указанный том. |
| storage_pool_name - | Требуется только при запросе state=='present'. Имя пула хранения, в котором должен находиться том. | |
| thin_provision логическое значение |
| Следует ли тонкопропорционально предоставить том. Тонкие тома могут быть созданы только при raid_level=="raidDiskPool". Как правило, использование тонкого распределения не рекомендуется из-за влияния на производительность. |
| thin_volume_expansion_policy - добавлено в 2.8 |
| Это политика расширения тонкого тома. Если 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". |
| thin_volume_growth_alert_threshold - добавлено в 2.8 | Значение по умолчанию: 95 | Это порог использования репозитория тонкого тома (в процентах). Когда процент используемого пространства хранилища от максимального размера репозитория превышает это значение, будет выдан предупреждающий сигнал, и будет выполнена политика thin_volume_expansion_policy. Значения должны быть от 10 до 99 включительно. |
| thin_volume_max_repo_size - | Значение по умолчанию: "то же, что и размер (в size_unit)" | Это максимальный объём, который будет разрешено расширить репозиторий тонкого тома. Имеет значение только при 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" увеличивают максимальный размер репозитория. |
| thin_volume_repo_size - | Это значение (в единицах size_unit) задаёт выделенное пространство для репозитория тонкопропорционального тома. Начальное значение должно составлять от 4 ГБ до 256 ГБ с шагом 4 ГБ. Во время операций расширения увеличение должно составлять от 4 ГБ до 256 ГБ с шагом 4 ГБ. Этот параметр не влияет на расширение, если thin_volume_expansion_policy=="automatic". Как правило, следует использовать thin_volume_expansion_policy=="automatic". |
| validate_certs boolean |
| Нужно ли проверять сертификаты https? |
| wait_for_initialization boolean добавлен в 2.8 |
| Принудительно заставляет модуль ждать завершения операций расширения, прежде чем продолжить. |
| workload_name - добавлен в 2.8 | Метка для рабочей нагрузки, определённой метаданными. При указании workload_name и metadata, определённая рабочая нагрузка будет добавлена в массив хранилищ. Если workload_name существует в массиве хранилищ, но метаданные отличаются, определение рабочей нагрузки будет обновлено. (Изменения обновит все связанные тома!) Существующие рабочие нагрузки можно получить с помощью netapp_e_facts. | |
| write_cache_enable boolean добавлен в 2.8 |
| Указывает, следует ли включить кэширование записи обратной записи для тома. |
Примечания
Примечание
- Модули Ansible E-Series требуют наличия экземпляра прокси-сервиса веб-служб (WSP) для управления системой хранения или системы хранения E-Series, которая поддерживает встроенный API веб-служб.
- Встроенные веб-службы в настоящее время доступны на моделях E2800, E5700, EF570 и более новых моделях оборудования.
- 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 строка | всегда | Состояние тома Пример: Стандартный том [workload_vol_1] был создан. |
Статус
- Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
- Данный модуль поддерживается сообществом Ansible. [community]
Авторы
- Kevin Hulquest (@hulquest)
- Nathan Swartz (@ndswartz)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/netapp_e_volume_module.html