netapp.ontap.na_ontap_aggregate модуль — Управление агрегатами NetApp ONTAP.

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 22.12.0).

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

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

Для использования в книге задач укажите: netapp.ontap.na_ontap_aggregate.

Новая в netapp.ontap 2.6.0

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Создание, удаление или управление агрегатами ONTAP.

Требования

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

Ansible 2.9 или более поздней версии — рекомендуется 2.12 или более поздней версии.
Python3 — 3.9 или более поздней версии рекомендуется.
При использовании ZAPI, netapp-lib 2018.11.13 или более поздней версии (устанавливается с помощью «pip install netapp-lib»), сильно рекомендуется netapp-lib 2020.3.12, так как она обеспечивает лучшую обработку ошибок при подключении.
физическая или виртуальная кластерная система Data ONTAP, модули поддерживают Data ONTAP 9.1 и более поздние версии, поддержка REST требует ONTAP 9.6 или более поздней версии

Параметры

Параметр	Комментарии
allow_flexgroups boolean добавлено в netapp.ontap 22.3.0	Этот необязательный параметр позволяет подключать хранилище объектов к агрегату, содержащему компоненты FlexGroup. Значение по умолчанию — false. Смешивание FabricPools и non-FabricPools в пределах FlexGroup не рекомендуется. Все агрегаты, содержащие компоненты FlexGroup, должны быть подключены к хранилищу объектов. Варианты: `false` `true`
cert_filepath string добавлено в netapp.ontap 20.6.0	путь к файлу сертификата клиента SSL (.pem). не поддерживается с python 2.6.
disk_class string добавлено в netapp.ontap 21.16.0	Класс дисков, используемый для построения агрегата. `capacity_flash` указан в swagger, но отклонен ONTAP как недействительный. Варианты: `"capacity"` `"performance"` `"archive"` `"solid_state"` `"array"` `"virtual"` `"data_center"` `"capacity_flash"`
disk_count integer	Количество дисков для размещения в агрегате, включая диски чётности. Диски в этом вновь созданном агрегате берутся из пула резервных дисков. Самые маленькие диски в этом пуле сначала присоединяются к агрегату, если не указан аргумент `disk-size`. Должен быть указан либо `disk-count`, либо `disks`. Диапазон [0..2^31-1]. Обязательно, когда `state=present`. Изменяется только в том случае, если указанное значение disk_count больше текущего значения disk_count. Нельзя создать группу RAID с 1 диском при использовании типа RAID raid4. Если disk_count % raid_size == 1, будет добавлено только disk_count/raid_size * raid_size. Если disk_count равен 6, raid_type равен raid4, raid_size равен 4, будут добавлены все 6 дисков. Если disk_count равен 5, raid_type равен raid4, raid_size равен 4, будет добавлено 5/4 * 4 = 4. 1 не будет добавлено. С REST, `nodes` требуется, если присутствует `disk_count`.
disk_size integer добавлено в netapp.ontap 2.7.0	Размер диска, используемый в размере блока 4K. Будут использоваться диски, размер которых находится в пределах 10% от указанного размера. С REST это преобразуется в байты с использованием 4096. Используйте `disk_size_with_unit` для пропуска преобразования.
disk_size_with_unit string	Размер диска, используемый в указанной единице измерения. Это положительное целое число, за которым следует единица измерения T/G/M/K. Например, 72G, 1T и 32M. Или единица измерения может быть опущена для байтов (REST также принимает B). Этот параметр игнорируется, если указан конкретный список дисков через параметр «диски». Необходимо использовать только один из параметров «disk-size» или «disk-size-with-unit». С REST это преобразуется в байты, предполагая K=1024.
disk_type string добавлено в netapp.ontap 2.7.0	Тип дисков, используемый для построения агрегата. Не поддерживается с REST — см. `disk_class`. SSD-NVM, SSD-CAP были добавлены с ONTAP 9.6. VMLUN был добавлен с ONTAP 9.9. Варианты: `"ATA"` `"BSAS"` `"FCAL"` `"FSAS"` `"LUN"` `"MSATA"` `"SAS"` `"SSD"` `"SSD-CAP"` `"SSD-NVM"` `"VMDISK"` `"VMLUN"` `"VMLUN-SSD"`
disks list / elements=string добавлено в netapp.ontap 2.8.0	Конкретный список дисков для использования в новом агрегате. Для создания «зеркального» агрегата с конкретным списком дисков необходимо указать параметры «диски» и «mirror_disks». Кроме того, в обоих списках должно быть указано одинаковое количество дисков. Не поддерживается с REST.
encryption boolean добавлено в netapp.ontap 21.14.0	включить ли программное шифрование. это эквивалентно -encrypt-with-aggr-key при использовании CLI. требуется лицензия VE. Варианты: `false` `true`
feature_flags dictionary добавлено в netapp.ontap 20.5.0	Включить или отключить новую функцию. Это можно использовать для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут изменяться без предварительного уведомления. Неизвестные ключи игнорируются.
force_ontap_version string добавлено в netapp.ontap 21.23.0	Переопределить версию ONTAP кластера при использовании REST. Поведение не определено, если версия не соответствует целевому кластеру. Это предоставляется как временное решение, когда версию кластера нельзя прочитать из-за проблем с разрешениями. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues. Это должно быть в формате 9.10 или 9.10.1, где каждый элемент является целым числом. Когда `use_rest` установлен в автоматический режим, это может принудительно переключиться на ZAPI в зависимости от версии и возможностей платформы. Игнорируется с ZAPI.
from_name string добавлено в netapp.ontap 2.7.0	Имя агрегата, которое будет переименовано.
hostname string / required	Имя хоста или IP-адрес экземпляра ONTAP.
http_port integer	Переопределить порт по умолчанию (80 или 443) этим портом

https boolean	Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании проверки подлинности с помощью SSL-сертификата, так как это требует SSL. Choices: `false` ← (default) `true`
ignore_pool_checks boolean added in netapp.ontap 20.8.0	действительно только когда используется параметр disks. Диски в плексе должны принадлежать одному и тому же резервному пулу, а зеркальные диски - другому резервному пулу. Если установлено значение true, эти проверки игнорируются. Игнорируется с REST, так как disks не поддерживается. Choices: `false` `true`
is_mirrored boolean added in netapp.ontap 2.8.0	Указывает, что новый агрегат должен быть зеркальным (иметь два плекса). Если установлено значение true, указанные диски будут разделены между двумя плексами. По умолчанию новый агрегат не будет зеркальным. Этот параметр не может использоваться, когда определенный список дисков предоставляется с помощью параметров ‘disks’ или ‘mirror_disks’. Choices: `false` `true`
key_filepath string added in netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
mirror_disks list / elements=string added in netapp.ontap 2.8.0	Список зеркальных дисков для использования. Он должен содержать такое же количество дисков, которое указано в ‘disks’. Не поддерживается с REST.
name string / required	Имя агрегата для управления.
nodes list / elements=string	Узел(ы) для создания агрегата. Если узел не указан, будет использован домашний LIF управления. Только ZAPI — если указано несколько узлов, будет создана полоса агрегатов. В REST может быть указан только один узел. Если присутствует disk_count, необходимо указать имя узла.
object_store_name string added in netapp.ontap 2.9.0	Имя конфигурации хранилища объектов, подключенного к агрегату.
ontapi integer	Используемая версия API ONTAP
password aliases: pass string	Пароль для указанного пользователя.
raid_size integer added in netapp.ontap 2.7.0	Задает максимальное количество дисков на группу RAID.
raid_type string added in netapp.ontap 2.7.0	Указывает тип групп RAID, которые будут использоваться в новом агрегате. raid_0 доступен только в ONTAP Select. Choices: `"raid4"` `"raid_dp"` `"raid_tec"` `"raid_0"`
service_state string	Должен ли указанный агрегат быть включен или отключен. Создает агрегат, если он не существует. Поддерживается с версии 9.11.1 или более поздней в REST. Choices: `"online"` `"offline"`
snaplock_type string added in netapp.ontap 20.1.0	Тип SnapLock для создаваемого агрегата. Choices: `"compliance"` `"enterprise"` `"non_snaplock"`
spare_pool string added in netapp.ontap 2.8.0	Указывает резервный пул, из которого следует выбирать резервные диски для использования при создании нового агрегата. Не поддерживается с REST. Choices: `"Pool0"` `"Pool1"`
state string	Должен ли указанный агрегат существовать или нет. Choices: `"present"` ← (default) `"absent"`
tags list / elements=string added in netapp.ontap 22.6.0	Теги — это необязательный способ отслеживания использования ресурса. Значения тегов должны быть отформатированы как строки ключ:значение, например [“team:csi”, “environment:test”]
time_out integer added in netapp.ontap 2.8.0	время ожидания создания агрегата в секундах. по умолчанию установлено 100 секунд. Default: `100`

unmount_volumes boolean	Если установлено в «true», этот параметр указывает, что все тома, размещённые на заданном агрегате, должны быть размонтированы перед выполнением операции отключения. По умолчанию система отклонит любую попытку отключения агрегата, на котором размещено одно или несколько подключенных томов. Не поддерживается с REST, по умолчанию REST размонтирует тома при попытке отключения агрегата. Варианты: `false` `true`
use_rest string	Использовать REST или ZAPI. always – всегда будет использовать REST API, если модуль поддерживает REST. Выдается предупреждение, если модуль не поддерживает REST. Выдается ошибка, если опция модуля не поддерживается в REST. never – всегда будет использовать ZAPI, если модуль поддерживает ZAPI. Может быть выдана ошибка, если опция REST не поддерживается в ZAPI. auto – попробует использовать REST API, если модуль поддерживает REST и опции модуля поддерживаются. В противном случае переходит к ZAPI. По умолчанию: `"auto"`
username псевдонимы: user string	Может быть учетной записью уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Для получения дополнительной информации см. документацию https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации аутентификация по протоколу basic, используя имя пользователя и пароль, аутентификация по сертификату SSL, используя файл сертификата клиента ssl и, необязательно, файл закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификатам.
validate_certs boolean	Если установлено `no`, сертификаты SSL не будут проверены. Это следует устанавливать только в `False` в случае использования самозаверяемых сертификатов на контролируемых сайтах. Варианты: `false` `true` ← (по умолчанию)
wait_for_online boolean добавлено в netapp.ontap 2.8.0	Установите этот параметр в «true» для синхронного выполнения во время создания (подождать, пока состояние агрегата не станет online). Установите этот параметр в «false» для асинхронного выполнения. Для асинхронного выполнения выполнение завершается сразу после отправки запроса, без проверки состояния агрегата. Игнорируется при использовании REST (всегда ожидается). Варианты: `false` ← (по умолчанию) `true`

Примечания

Примечание

поддерживает режим check_mode.
поддерживает ZAPI и REST.
Модули, начинающиеся с na_ontap, разработаны для поддержки платформы хранения ONTAP.
https включен по умолчанию и рекомендуется. Чтобы включить http в кластере, необходимо выполнить следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’

Примеры

- name: Create Aggregates and wait 5 minutes until aggregate is online in ZAPI.
  netapp.ontap.na_ontap_aggregate:
    state: present
    service_state: online
    name: ansibleAggr
    disk_count: 10
    wait_for_online: True
    time_out: 300
    snaplock_type: non_snaplock
    use_rest: never
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Create Aggregates in REST.
  netapp.ontap.na_ontap_aggregate:
    state: present
    service_state: online
    name: ansibleAggr
    disk_count: 10
    nodes: ontap-node
    snaplock_type: non_snaplock
    use_rest: always
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Manage Aggregates in ZAPI, modify service state.
  netapp.ontap.na_ontap_aggregate:
    state: present
    service_state: offline
    unmount_volumes: true
    name: ansibleAggr
    disk_count: 10
    use_rest: never
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Manage Aggregates in REST, increase disk count.
  netapp.ontap.na_ontap_aggregate:
    state: present
    name: ansibleAggr
    disk_count: 20
    nodes: ontap-node
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Attach object store
  netapp.ontap.na_ontap_aggregate:
    state: present
    name: aggr4
    object_store_name: sgws_305
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Rename Aggregates
  netapp.ontap.na_ontap_aggregate:
    state: present
    service_state: online
    from_name: ansibleAggr
    name: ansibleAggr2
    disk_count: 20
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete Aggregates
  netapp.ontap.na_ontap_aggregate:
    state: absent
    service_state: offline
    unmount_volumes: true
    name: ansibleAggr
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Авторы

Команда NetApp Ansible (@carchi8py)

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

© 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/ontap/na_ontap_aggregate_module.html