netapp_e_volume – NetApp E-Series управление хранилищами объёмов (стандартные и тонкие)
Новая версия 2.2.
Обзор
- Создание или удаление томов (стандартных и тонких) для массивов хранения 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. | |
| data_assurance_enabled boolean |
| Определяет, включено ли обеспечение целостности данных (DA) для тома. Доступно только при создании нового тома и на хранилище с дисками, поддерживающими функцию DA. |
| metadata словарь добавлено в 2.8 | Словарь, содержащий метаданные для использования, пользователя, расположения и т. д. тома (словарь определяется произвольно пользователем для любого необходимого применения). Если workload_name существует на массиве хранения, но метаданные отличаются, определение рабочей нагрузки будет обновлено. (Изменения обновят все связанные тома!)
workload_name должно быть указано при определении metadata. | |
| name - / обязательно | Имя тома для управления. | |
| read_ahead_enable boolean добавлено в 2.8 |
| Указывает, включена ли автоматическая предварительная загрузка данных из кэша. Этот параметр не влияет на тонко выделенные тома, так как архитектура тонких томов не может извлечь выгоду из предварительной загрузки. |
| read_cache_enable boolean добавлено в 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 boolean |
| Следует ли включить существующий кэш SSD на томе (ошибка, если кэш SSD не определен). Значение по умолчанию — игнорировать существующее значение кэша SSD. |
| ssid - | Значение по умолчанию: 1 | Идентификатор массива для управления. Это значение должно быть уникальным для каждого массива. |
| state - / обязательно |
| Должен ли указанный том существовать |
| storage_pool_name - | Требуется только при запросе state=='present'. Имя хранилища, в котором должен находиться том. | |
| thin_provision boolean |
| Следует ли тонко выделять том. Тонкие тома можно создавать только при 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 added in 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 string | всегда | Состояние тома Пример: Стандартный том [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.8/modules/netapp_e_volume_module.html
