Spec-Zone.ru › Ansible

netapp.ontap.na_ontap_volume_efficiency модуль – NetApp ONTAP включает, отключает или изменяет эффективность тома

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробной информации.

Чтобы использовать его в книге задач, укажите: netapp.ontap.na_ontap_volume_efficiency.

Новое в netapp.ontap 21.2.0

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

Описание

  • Включить, изменить или отключить эффективность тома.
  • Требуется либо путь, либо имя тома.
  • Только пользователь с правами администратора может изменить эффективность тома.

Требования

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

  • 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 или более поздней версии

Параметры

Параметр

Комментарии

cert_filepath

строка

добавлен в netapp.ontap 20.6.0

путь к файлу SSL-сертификата клиента (.pem).

не поддерживается с python 2.6.

enable_compression

логическое

Указывает, следует ли включить сжатие.

Варианты:

  • false
  • true

enable_cross_volume_background_dedupe

логическое

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

Варианты:

  • false
  • true

enable_cross_volume_inline_dedupe

логическое

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

Варианты:

  • false
  • true

enable_data_compaction

логическое

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

Варианты:

  • false
  • true

enable_inline_compression

логическое

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

Варианты:

  • false
  • true

enable_inline_dedupe

логическое

Указывает, следует ли включить дедупликацию в режиме реального времени. Поддерживается только на системах AFF или гибридных агрегатах.

Варианты:

  • false
  • true

feature_flags

словарь

добавлен в netapp.ontap 20.5.0

Включить или выключить новую функцию.

Это можно использовать для включения экспериментальной функции или выключения новой функции, которая нарушает обратную совместимость.

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

force_ontap_version

строка

добавлен в netapp.ontap 21.23.0

Переопределить версию кластера ONTAP при использовании REST.

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

Это предлагается как обходной путь, когда версия кластера не может быть прочитана из-за проблем с правами. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues.

Это должно быть в формате 9.10 или 9.10.1, где каждый элемент — целое число.

Когда use_rest установлено в значение auto, это может принудительно переключиться на ZAPI в зависимости от версии и возможностей платформы.

Игнорируется с ZAPI.

hostname

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

Имя хоста или IP-адрес экземпляра ONTAP.

http_port

целое число

Переопределить порт по умолчанию (80 или 443) на этот порт

https

логическое

Включить и выключить https.

Игнорируется при использовании REST, так как поддерживается только https.

Игнорируется при аутентификации с помощью сертификата SSL, так как требуется SSL.

Варианты:

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

key_filepath

строка

добавлен в netapp.ontap 20.6.0

путь к файлу закрытого ключа SSL-клиента.

ontapi

целое число

Версия API ontap для использования

password

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

строка

Пароль для указанного пользователя.

path

строка

Указывает путь к тому.

Требуется либо path, либо volume_name.

Требуется ONTAP 9.9.1 или более поздняя версия с REST.

policy

строка

Указывает политику эффективности хранения для использования.

По умолчанию доступны следующие имена: ‘auto’, ‘default’, ‘inline-only’, ‘-‘.

Требуется ONTAP 9.7 или более поздняя версия с REST.

schedule

строка

Указывает график эффективности хранения.

Поддерживается только с ZAPI.

start_ve_build_metadata

boolean

added in netapp.ontap 21.4.0

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

Поддерживается только с ZAPI.

Choices:

  • false
  • true

start_ve_delete_checkpoint

boolean

added in netapp.ontap 21.4.0

Задает сканер для удаления существующей контрольной точки и начала операции с начала.

Поддерживается только с ZAPI.

Choices:

  • false
  • true

start_ve_qos_policy

string

added in netapp.ontap 21.4.0

Задает политику QoS для операции.

По умолчанию — best-effort в ZAPI.

Поддерживается только с ZAPI.

Choices:

  • "background"
  • "best-effort"

start_ve_queue_operation

boolean

added in netapp.ontap 21.4.0

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

Поддерживается только с ZAPI.

Choices:

  • false
  • true

start_ve_scan_all

boolean

added in netapp.ontap 21.4.0

Задает сканер для сканирования всего тома без применения оптимизации блоков общего доступа.

Поддерживается только с ZAPI.

Choices:

  • false
  • true

start_ve_scan_old_data

boolean

added in netapp.ontap 21.4.0

Задает операцию сканирования файловой системы для обработки всех существующих данных.

Требуется ONTAP 9.11.1 или более поздняя версия с REST.

Choices:

  • false
  • true

state

string

Включена ли указанная эффективность тома или нет.

Choices:

  • "present" ← (default)
  • "absent"

stop_ve_all_operations

boolean

added in netapp.ontap 21.4.0

Указывает, что все запущенные и находящиеся в очереди операции должны быть остановлены.

Поддерживается только с ZAPI.

Choices:

  • false
  • true

storage_efficiency_mode

string

added in netapp.ontap 21.14.0

Режим эффективности хранения, используемый томом. Этот параметр поддерживается только на платформах AFF.

Требуется ONTAP 9.10.1 или более поздняя версия.

Choices:

  • "default"
  • "efficient"

use_rest

string

Использовать REST или ZAPI.

always – всегда будет использовать REST API, если модуль поддерживает REST. Предупреждение выдается, если модуль не поддерживает REST. Ошибка выдается, если параметр модуля не поддерживается в REST.

never – всегда будет использовать ZAPI, если модуль поддерживает ZAPI. Ошибка может быть выдана, если параметр REST не поддерживается в ZAPI.

auto – попытается использовать REST API, если модуль поддерживает REST и параметры модулей поддерживаются. В противном случае возвращается к ZAPI.

Default: "auto"

username

aliases: user

string

Это может быть учетная запись в масштабе кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM.

Для получения дополнительной информации, пожалуйста, прочитайте документацию https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/.

Поддерживаются два метода аутентификации

  1. базовая аутентификация, использующая имя пользователя и пароль,
  2. аутентификация сертификата SSL, использующая файл клиентского сертификата SSL и, при необходимости, файл закрытого ключа.

Для использования сертификата сертификат должен быть установлен в кластере ONTAP, и аутентификация сертификата должна быть включена.

validate_certs

boolean

Если установлено в no, сертификаты SSL проверяться не будут.

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

Choices:

  • false
  • true ← (default)

volume_efficiency

string

added in netapp.ontap 21.4.0

Запуск или остановка операции эффективности тома по заданному пути к тому.

Требуется ONTAP 9.11.1 или более поздняя версия с REST.

Choices:

  • "start"
  • "stop"

volume_name

string

added in netapp.ontap 22.3.0

Указывает имя тома.

vserver

string / обязательно

Указывает vserver для тома.

Примечания

Примечание

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

Примеры

- name: Enable Volume efficiency
  netapp.ontap.na_ontap_volume_efficiency:
    state: present
    vserver: "TESTSVM"
    path: "/vol/test_sis"
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    https: true
    validate_certs: false

- name: Disable Volume efficiency test
  netapp.ontap.na_ontap_volume_efficiency:
    state: absent
    vserver: "TESTSVM"
    path: "/vol/test_sis"
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    https: true
    validate_certs: false

- name: Modify storage efficiency schedule with ZAPI.
  netapp.ontap.na_ontap_volume_efficiency:
    state: present
    vserver: "TESTSVM"
    path: "/vol/test_sis"
    schedule: "mon-sun@0,1,23"
    enable_compression: true
    enable_inline_compression: true
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    https: true
    validate_certs: false

- name: Start volume efficiency
  netapp.ontap.na_ontap_volume_efficiency:
    state: present
    vserver: "TESTSVM"
    path: "/vol/test_sis"
    volume_efficiency: "start"
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    https: true
    validate_certs: false

- name: Stop volume efficiency
  netapp.ontap.na_ontap_volume_efficiency:
    state: present
    vserver: "TESTSVM"
    path: "/vol/test_sis"
    volume_efficiency: "stop"
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    https: true
    validate_certs: false

- name: modify volume efficiency with volume name in REST.
  netapp.ontap.na_ontap_volume_efficiency:
    state: present
    vserver: "TESTSVM"
    volume_name: "test_sis"
    volume_efficiency: "stop"
    enable_compression: True
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    https: true
    validate_certs: false

Авторы

  • Команда 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_volume_efficiency_module.html

Spec-Zone.ru

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