модуль netapp.ontap.na_ontap_job_schedule — расписание заданий NetApp ONTAP

Примечание

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

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

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

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

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

Параметры

Параметр	Комментарии
cert_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
cluster string добавлено в netapp.ontap 21.22.0	По умолчанию используется локальный кластер. В конфигурации MetroCluster пользовательские расписания, принадлежащие локальному кластеру, реплицируются в кластер-партнёр. Аналогичным образом пользовательские расписания, принадлежащие кластеру-партнёру, реплицируются в локальный кластер. Как правило, в локальном кластере можно создавать, изменять и удалять только расписания, принадлежащие этому кластеру. Однако при переключении в конфигурации MetroCluster кластер, находящийся в состоянии переключения, может создавать, изменять и удалять расписания, принадлежащие кластеру-партнёру.
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.
hostname string / обязательный	Имя хоста или IP-адрес экземпляра ONTAP.
http_port integer	Переопределение порта по умолчанию (80 или 443) с помощью этого параметра
https boolean	Включение и отключение HTTPS. Игнорируется при использовании REST, поскольку поддерживается только HTTPS. Игнорируется при аутентификации с помощью SSL-сертификата, так как для неё требуется SSL. Варианты: `false` ← (по умолчанию) `true`
interval string добавлено в netapp.ontap 23.2.0	Интервал, с которым должно выполняться задание. Задаётся в виде строки длительности в формате ISO-8601. Этот параметр не работает с заданиями cron.
job_days_of_month list / элементы=integer добавлено в netapp.ontap 2.8.0	Дни месяца, в которые должно выполняться задание. День месяца для планирования cron в Job Manager. `-1` обозначает все дни месяца от 1 до 31. Диапазон: [-1..31]
job_days_of_week list / элементы=integer добавлено в netapp.ontap 2.8.0	Дни недели, в которые должно выполняться задание. День недели для планирования cron в Job Manager. Ноль обозначает воскресенье. `-1` обозначает все дни недели. Диапазон: [-1..6]
job_hours list / элементы=integer добавлено в netapp.ontap 2.8.0	Часы суток, в которые должно выполняться задание. Час для планирования cron в Job Manager. `-1` обозначает все часы. Диапазон: [-1..23]
job_minutes list / элементы=integer	Минуты каждого часа, в которые должно выполняться задание. Минута для планирования cron в Job Manager. `-1` обозначает все минуты. Диапазон: [-1..59] Обязательный параметр при создании.
job_months list / элементы=integer добавлено в netapp.ontap 2.8.0	Месяцы, в которые должно выполняться задание. Месяц для планирования cron в Job Manager. `-1` обозначает все месяцы. Диапазон: [-1..12]; значения 0 и 12 могут поддерживаться или не поддерживаться, см. `month_offset`
key_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
lambda_config dictionary добавлено в netapp.ontap 23.5.0	Параметры конфигурации прокси-функции AWS Lambda. Эти параметр и вложенные параметры поддерживаются только при использовании REST.
aws_profile string	Имя профиля AWS для аутентификации.
aws_region string / обязательный	Имя региона AWS.
function_name string / обязательный	Имя вызываемой функции AWS Lambda.
month_offset integer добавлено в netapp.ontap 21.9.0	Определяет, начинается ли отсчёт месяцев с января с 0 или 1. По умолчанию ZAPI использует диапазон 0..11, а REST — 1..12. По умолчанию при использовании ZAPI значение равно 0, а при использовании REST — 1. Если задано значение 0, значения 12 и выше отклоняются. Если задано значение 1, значения 0, 13 и выше отклоняются. Варианты: `0` `1`
name string / обязательный	Имя управляемого расписания заданий.
ontapi integer	Используемая версия API ONTAP
password псевдонимы: pass string	Пароль указанного пользователя.
state string	Определяет, должно ли указанное расписание заданий существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
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, если модуль его поддерживает. Если параметр 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. Поддерживаются два метода аутентификации Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация с помощью SSL-сертификата клиента и, при необходимости, файла закрытого ключа. Для использования сертификата его необходимо установить в кластере ONTAP и включить аутентификацию по сертификату.
validate_certs boolean	Если задано значение `no`, SSL-сертификаты не проверяются. Устанавливайте это значение в `False` только на контролируемых вами сайтах, использующих самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)
vserver string добавлено в netapp.ontap 23.2.0	Имя vserver.

Примечания

Примечание

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

Примеры

- name: Create Job for 11.30PM at 10th of every month
  netapp.ontap.na_ontap_job_schedule:
    state: present
    name: jobName
    job_minutes: 30
    job_hours: 23
    job_days_of_month: 10
    job_months: -1
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Create Job for 11.30PM at 10th of January, April, July, October for ZAPI and REST
  netapp.ontap.na_ontap_job_schedule:
    state: present
    name: jobName
    job_minutes: 30
    job_hours: 23
    job_days_of_month: 10
    job_months: 1,4,7,10
    month_offset: 1
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Create Job for 11.30PM at 10th of January, April, July, October for ZAPI and REST
  netapp.ontap.na_ontap_job_schedule:
    state: present
    name: jobName
    job_minutes: 30
    job_hours: 23
    job_days_of_month: 10
    job_months: 0,3,6,9
    month_offset: 0
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Create Job for 11.30PM at 10th of January when using REST and February when using ZAPI !!!
  netapp.ontap.na_ontap_job_schedule:
    state: present
    name: jobName
    job_minutes: 30
    job_hours: 23
    job_days_of_month: 10
    job_months: 1
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Create Interval Job using REST
  netapp.ontap.na_ontap_job_schedule:
    state: present
    name: jobName
    interval: P1DT2H3M4S
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete Job
  netapp.ontap.na_ontap_job_schedule:
    state: absent
    name: jobName
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Авторы

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