Модуль netapp.ontap.na_ontap_interface – Настройка LIF NetApp ONTAP

address

string

Указывает IP-адрес LIF.

ZAPI - Обязательно, когда state=present и is_ipv4_link_local если false и subnet_name не установлен.

REST - Обязательно, когда state=present и interface_type является IP.

admin_status

string

Указывает административный статус LIF.

Варианты:

• "up"
• "down"

broadcast_domain

string

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

Имя broadcast_domain может использоваться для указания местоположения на IP-интерфейсе с REST, как альтернатива node или port.

Используется только при создании IP-интерфейса для выбора узла, игнорируется, если интерфейс уже существует.

Если broadcast domain не найден, убедитесь, что проверили значение ipspace.

home_port и broadcast_domain являются взаимоисключающими. home_node может присутствовать или отсутствовать.

Не поддерживается для FC-интерфейса.

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

cert_filepath

string

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

Путь к файлу клиентского сертификата SSL (.pem).

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

current_node

string

Указывает текущий узел LIF.

По умолчанию это home_node

current_port

string

Указывает текущий порт LIF.

data_protocol

string

Протокол данных, для которого настроен FC-интерфейс.

Игнорируется с ZAPI или для IP-интерфейсов.

Требуется для создания интерфейса типа FC.

Варианты:

• "fcp"
• "fc_nvme"

dns_domain_name

string

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

Указывает уникальное, полное доменное имя зоны DNS этого LIF.

Поддерживается с ONTAP 9.9.0 или более поздней версии в REST.

Не поддерживается для FC-интерфейсов.

fail_if_subnet_conflicts

boolean

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

Создание или обновление IP-интерфейса завершается ошибкой, если указанный IP-адрес попадает в диапазон адресов именованной подсети.

Установите это значение в false, чтобы использовать указанный IP-адрес и назначить подсеть, владеющую этим адресом, интерфейсу.

Этот параметр поддерживается только с REST и требует ONTAP 9.11.1 или более поздней версии.

Варианты:

• false
• true

failover_group

string

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

Указывает группу failover для LIF.

Не поддерживается с REST.

failover_policy

string

Указывает политику failover для LIF.

При использовании REST эти значения сопоставляются с «home_port_only», «default», «home_node_only», «sfo_partners_only», «broadcast_domain_only».

Варианты:

• "disabled"
• "system-defined"
• "local-only"
• "sfo-partner-only"
• "broadcast-domain-wide"

failover_scope

string

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

Указывает область failover для LIF.

Только REST и только для IP-интерфейсов. Не поддерживается для FC-интерфейсов.

Варианты:

• "home_port_only"
• "default"
• "home_node_only"
• "sfo_partners_only"
• "broadcast_domain_only"

feature_flags

dictionary

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

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

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

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

firewall_policy

string

Указывает политику брандмауэра для LIF.

Этот параметр устарел в REST.

С REST модуль пытается вывести service_policy и может выдать ошибку.

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 установлено на auto, это может принудительно переключиться на ZAPI в зависимости от версии и возможностей платформы.

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

force_subnet_association

boolean

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

Установите это значение в true, чтобы получить адрес из именованной подсети и назначить подсеть LIF.

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

Варианты:

• false
• true

from_name

string

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

имя интерфейса, который нужно переименовать

home_node

string

Указывает домашний узел LIF.

По умолчанию, первый узел из кластера считается домашним узлом.

home_port

string

Указывает домашний порт LIF.

Требуется ONTAP 9.8 или более поздней версии с интерфейсами FC при использовании REST.

При использовании REST, для создания IP-интерфейсов требуется хотя бы один из параметров home_port, home_node или broadcast_domain.

При использовании REST, для создания FC-интерфейсов требуется либо home_port, либо current_port.

При использовании ZAPI, для создания IP и FC интерфейсов требуется home_port.

home_port и broadcast_domain взаимоисключающие (REST и IP-интерфейсы).

hostname

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

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

http_port

integer

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

https

boolean

Включить и отключить https.

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

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

Варианты:

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

ignore_zapi_options

list / elements=string

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

игнорировать неподдерживаемые параметры, которые не должны быть актуальны.

Игнорируется при использовании ZAPI.

Варианты:

• "failover_group"
• "force_subnet_association" ← (по умолчанию)
• "listen_for_dns_query"

По умолчанию: ["force_subnet_association"]

interface_name

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

Указывает имя логического интерфейса (LIF).

interface_type

string

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

тип интерфейса.

IP предполагается, если присутствуют адрес или маска.

IP-интерфейсы включают кластер, межкластерный, управляющий и NFS, CIFS, iSCSI интерфейсы.

FC-интерфейсы включают FCP и NVME-FC интерфейсы.

Игнорируется при использовании ZAPI.

Требуется при использовании REST, но может быть получено из устаревших параметров, таких как role, protocols, и firewall_policy.

Варианты:

• "fc"
• "ip"

ipspace

string

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

Имя ipspace требуется при использовании REST для кластерных интерфейсов. Оно необязательно для интерфейсов уровня SVM.

Игнорируется при использовании ZAPI.

Игнорируется для FC-интерфейса.

is_auto_revert

boolean

Если True, данные LIF вернутся к своему домашнему узлу в определенных обстоятельствах, таких как запуск,

и возможность миграции балансировки нагрузки автоматически отключена.

Варианты:

• false
• true

is_dns_update_enabled

boolean

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

Указывает, включена ли динамическая обновление DNS для данного LIF. Динамические обновления будут отправляться для данного LIF, если обновления включены на уровне Vserver.

Поддерживается с ONTAP 9.9.1 или более поздних версий в REST.

Не поддерживается для FC-интерфейсов.

Варианты:

• false
• true

is_ipv4_link_local

boolean

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

Указывает, что LIF должен получить ipv4 link local адрес.

Случай использования этого параметра - при создании кластерных LIF для автоматического назначения ipv4 link local адреса.

Не поддерживается в REST

Варианты:

• false
• true

key_filepath

string

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

путь к файлу ключа SSL-клиента.

listen_for_dns_query

boolean

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

Если True, этот IP-адрес будет слушать запросы DNS для указанной зоны DNS.

Не поддерживается с REST.

Варианты:

• false
• true

netmask

string

Указывает маску подсети LIF.

ZAPI - Требуется, когда state=present и is_ipv4_link_local, если false, и subnet_name не задан.

REST - Требуется, когда state=present и interface_type - IP.

ontapi

integer

Версия API ontap, которую нужно использовать

password

aliases: pass

string

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

probe_port

целое число

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

Порт зондирования для балансировщика нагрузки облака — действует только в среде Azure.

Не поддерживается с ZAPI или с интерфейсами FC.

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

protocols

список / элементы=строка

Указывает список протоколов данных, настроенных на LIF. По умолчанию значениями в этом элементе являются nfs, cifs и fcache.

Другие поддерживаемые протоколы — iscsi и fcp. LIF можно настроить так, чтобы он не поддерживал никаких протоколов данных, указав «none».

Значения протокола none, iscsi, fc-nvme или fcp не могут комбинироваться с другими протоколами данных.

Параметры address, netmask и firewall_policy не поддерживаются для параметра «fc-nvme».

Этот параметр игнорируется с REST, хотя его можно использовать для получения interface_type или data_protocol.

role

строка

Указывает роль LIF.

При установке роли «intercluster» или «cluster» настройка протокола не поддерживается.

При создании роли «cluster» имя узла будет отображаться в качестве префикса в имени LIF.

Например, если указанное имя — clif, а имя узла — node1, имя LIF отображается в ONTAP как node1_clif.

Возможные значения: ‘undef’, ‘cluster’, ‘data’, ‘node-mgmt’, ‘intercluster’, ‘cluster-mgmt’.

Требуется при state=present, если не присутствует service_policy и версия ONTAP не ниже 9.8.

Этот параметр устарел в REST.

С REST модуль пытается получить service_policy и может выдавать ошибку.

service_policy

строка

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

Начиная с ONTAP 9.5, можно настроить политики обслуживания LIF для идентификации отдельной службы или списка служб, которые будут использовать LIF.

В ONTAP 9.5 можно назначать политики обслуживания только для LIF в admin SVM.

В ONTAP 9.6 дополнительно можно назначать политики обслуживания для LIF в data SVM.

При указании политики обслуживания для LIF не требуется указывать протокол данных и роль для LIF.

Обратите внимание, что роль все же требуется из-за проблемы с ZAPI. Это ограничение устранено в ONTAP 9.8.

Поддерживается создание LIF с указанием роли и протоколов данных.

state

строка

Определяет, должен ли указанный интерфейс существовать или нет.

Варианты:

• "present" ← (по умолчанию)
• "absent"

subnet_name

строка

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

Подсеть, из которой выделяется адрес IP-интерфейса.

Если параметр не используется, необходимо указать IP-адрес и маску.

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

Для REST необходимо установить ipspace.

use_rest

строка

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

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

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

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

По умолчанию: "auto"

username

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

строка

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

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

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

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

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

validate_certs

логическое

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

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

Варианты:

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

vserver

строка

Имя vserver для использования.

Требуется с ZAPI.

Требуется с REST для интерфейсов FC (серверы данных).

Требуется с REST для SVM-интерфейсов IP (серверы данных).

Недействительно с REST для IP-интерфейсов уровня кластера.

Для облегчения перехода от ZAPI к REST, vserver игнорируется, когда роль установлена в ‘cluster’, ‘node-mgmt’, ‘intercluster’, ‘cluster-mgmt’.

Удалите этот параметр, чтобы подавить предупреждение.