Spec-Zone.ru › Ansible

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

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: netapp.ontap.na_ontap_service_processor_network.

Добавлено в netapp.ontap 2.6.0

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

Краткое описание

  • Изменение сети сервисного процессора ONTAP

Требования

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

  • Ansible 2.9 или более поздней версии — рекомендуется версия 2.12 или более поздняя.
  • Python3 — рекомендуется версия 3.9 или более поздняя.
  • netapp-lib только при использовании ZAPI (установите с помощью ‘pip install netapp-lib’). Обратите внимание, что netapp-lib устарел и больше не поддерживается. Используйте на свой страх и риск.
  • Физическая или виртуальная кластерная система Data ONTAP; модули поддерживают Data ONTAP 9.1 и более поздние версии, для работы REST требуется ONTAP 9.6 или более поздняя версия.

Параметры

Параметр

Комментарии

address_type

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

Укажите класс адреса.

Варианты:

  • "ipv4"
  • "ipv6"

cert_filepath

string

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

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

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

dhcp

string

Укажите тип DHCP.

Установка значения dhcp=none требует указать все параметры ip_address, netmask, gateway_ip_address, причём хотя бы одно из их значений должно отличаться от текущего.

Варианты:

  • "v4"
  • "none"

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

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

gateway_ip_address

string

Укажите IP-адрес шлюза.

hostname

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

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

http_port

integer

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

https

boolean

Включение и отключение HTTPS.

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

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

Варианты:

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

ip_address

string

Укажите IP-адрес сервисного процессора.

is_enabled

boolean

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

Установка параметров ip_address, netmask или prefix_length, gateway_ip_address включит сеть SP в REST.

Варианты:

  • false
  • true

key_filepath

string

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

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

netmask

string

Укажите маску подсети сервисного процессора.

node

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

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

ontapi

integer

Версия API ONTAP, которую следует использовать

password

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

string

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

prefix_length

integer

Укажите длину префикса сервисного процессора.

state

string

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

Варианты:

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

use_lambda

boolean

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

Указывает, следует ли использовать функцию прокси-сервера AWS Lambda для подключения к системе ONTAP.

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

Варианты:

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

use_rest

string

Определяет, использовать REST или ZAPI.

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

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

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

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

username

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

string

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

Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html.

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

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

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

validate_certs

boolean

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

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

Варианты:

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

wait_for_completion

boolean

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

Установите этот параметр в ‘true’ для синхронного выполнения (ожидания успешного обновления состояния SP).

Установите этот параметр в ‘false’ для асинхронного выполнения.

При асинхронном выполнении работа завершается сразу после отправки запроса, без проверки состояния SP.

Варианты:

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

Примечания

Примечание

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

Примеры

- name: Modify Service Processor Network, enable dhcp - ipv4.
  netapp.ontap.na_ontap_service_processor_network:
    state: present
    address_type: ipv4
    is_enabled: true
    dhcp: v4
    node: "{{ netapp_node }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"

- name: Enable Service Processor Network configuration - ipv4.
  netapp.ontap.na_ontap_service_processor_network:
    state: present
    address_type: ipv4
    is_enabled: true
    dhcp: None
    ip_address: 10.10.10.1
    netmask: 0.0.0.0
    gateway_ip_address: 10.10.1.1
    wait_for_completion: true
    node: "{{ netapp_node }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"

- name: Disable Service Processor Network configuration - ipv4.
  netapp.ontap.na_ontap_service_processor_network:
    state: present
    address_type: ipv4
    is_enabled: false
    wait_for_completion: true
    node: "{{ netapp_node }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"

- name: Enable Service Processor Network configuration - ipv6.
  netapp.ontap.na_ontap_service_processor_network:
    state: present
    address_type: ipv6
    is_enabled: true
    ip_address: FD20:8B1E:B058:2014:25BE:67F9:0748:6D6B
    prefix_length: 64
    gateway_ip_address: FD20:8B1E:B058:2014:0000:0000:0000:0001
    wait_for_completion: true
    node: "{{ netapp_node }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"

- name: Disable Service Processor Network configuration - ipv6.
  netapp.ontap.na_ontap_service_processor_network:
    state: present
    address_type: ipv6
    is_enabled: false
    wait_for_completion: true
    node: "{{ netapp_node }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"

Авторы

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

Ссылки на коллекцию

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (исходный код)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/netapp/ontap/na_ontap_service_processor_network_module.html

Spec-Zone.ru

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