Модуль netapp.ontap.na_ontap_service_policy – настройка политики служб 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_policy.

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

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

Обзор

Добавление, изменение или удаление политик служб.
Для работы этого модуля требуется ONTAP 9.8 или более поздняя версия; поддерживается только REST.

Требования

На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.

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

Параметры

Параметр	Комментарии
additional_services list / elements=string добавлено в netapp.ontap 22.0.0	Вместо обновления `known_services` новые службы можно указать здесь.
cert_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
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; каждый компонент должен быть целым числом.
hostname string / обязательный	Имя узла или IP-адрес экземпляра ONTAP.
http_port integer	Заменяет порт по умолчанию (80 или 443) на указанный порт.
https boolean	Включение и отключение HTTPS. Игнорируется при использовании REST, поскольку поддерживается только HTTPS. Игнорируется при использовании аутентификации по сертификату SSL, поскольку для неё требуется SSL. Варианты: `false` ← (по умолчанию) `true`
ipspace string	Имя IP-пространства. Обязательно для политик служб уровня кластера. Необязательно для политик служб уровня SVM.
key_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
known_services list / elements=string добавлено в netapp.ontap 22.0.0	Список известных служб в версии 9.12.1. Возникает ошибка, если какая-либо служба из `services` отсутствует в этом списке или в `new_services`. При необходимости измените этот список, чтобы ограничить набор поддерживаемых служб. По умолчанию: ["cluster_core", "intercluster_core", "management_core", "management_autosupport", "management_bgp", "management_ems", "management_https", "management_http", "management_ssh", "management_portmap", "data_core", "data_nfs", "data_cifs", "data_flexcache", "data_iscsi", "data_s3_server", "data_dns_server", "data_fpolicy_client", "management_ntp_client", "management_dns_client", "management_ad_client", "management_ldap_client", "management_nis_client", "management_snmp_server", "management_rsh_server", "management_telnet_server", "management_ntp_server", "data_nvme_tcp", "backup_ndmp_control", "management_log_forwarding"]
name string / обязательный	Имя политики служб.
password псевдонимы: pass string	Пароль указанного пользователя.
scope string	Укажите «svm» для интерфейсов, принадлежащих SVM. В противном случае укажите «cluster». Если задан параметр vserver, предполагается значение svm. Если параметр vserver не задан, предполагается значение cluster. Варианты: `"cluster"` `"svm"`
services list / elements=string	Список служб, связываемых с этой политикой служб. Чтобы удалить все службы, используйте «no_service». Если указано no_service, другие значения не допускаются. Примечание. Не все версии ONTAP поддерживают все значения; могут добавляться новые. См. `known_services` и `additional_services`, чтобы устранить ошибки, связанные с неизвестными службами.
state string	Определяет, должна ли указанная политика служб существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_lambda boolean добавлено в netapp.ontap 23.4.0	Указывает, следует ли использовать прокси-функциональность AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Варианты: `false` ← (по умолчанию) `true`
use_rest string	Этот модуль поддерживает только REST. always — всегда использовать REST API. Если модуль не поддерживает REST, будет выдано предупреждение. По умолчанию: `"always"`
username псевдонимы: user string	Это может быть учётная запись уровня кластера или уровня SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Дополнительную информацию см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два способа аутентификации: Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация по сертификату SSL с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа. Для использования сертификата его необходимо установить в кластере ONTAP и включить аутентификацию по сертификату.
validate_certs boolean	Если задано значение `no`, сертификаты SSL проверяться не будут. Задавайте это значение только для `False` на контролируемых вами сайтах, использующих самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)
vserver string	Имя используемого vserver. Не указывайте этот параметр для учётных записей пользователей уровня кластера.

Примечания

Примечание

Этот модуль поддерживает check_mode.
Этот модуль не поддерживает «allowed-addresses», поскольку REST не поддерживает этот параметр. По умолчанию используется значение 0.0.0.0/0.
Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
HTTPS включён по умолчанию и рекомендуется к использованию. Чтобы включить HTTP в кластере, выполните следующие команды: «set -privilege advanced;» «system services web modify -http-enabled true;»

Примеры

- name: Create service policy
  netapp.ontap.na_ontap_service_policy:
    state: present
    name: "{{ service_policy_name }}"
    services:
      - data_core
      - data_nfs
    vserver: ansibleVServer
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete single service policy
  netapp.ontap.na_ontap_service_policy:
    state: absent
    name: "{{ service_policy_name }}"
    vserver: ansibleVServer
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Modify single service policy
  netapp.ontap.na_ontap_service_policy:
    state: present
    name: "{{ service_policy_name }}"
    services:
      - data_core
      - data_nfs
      - data_cifs
    vserver: ansibleVServer
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Modify service policy, remove services
  netapp.ontap.na_ontap_service_policy:
    state: present
    name: "{{ service_policy_name }}"
    services:
      - no_service
    vserver: "{{ vserver }}"

- name: Modify service policy at cluster level
  netapp.ontap.na_ontap_service_policy:
    state: present
    name: "{{ service_policy_name }}"
    ipspace: ansibleIpspace
    scope: cluster
    services:
      - management_core
      - management_autosupport
      - management_ems

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
cd_action string	Указывает, создан или удалён открытый ключ. Возвращается: success
modify dictionary	Атрибуты, изменённые при наличии ключа. Возвращается: success

Авторы

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