Модуль cisco.aci.aci_maintenance_policy – Управление политиками технического обслуживания прошивки (maint:MaintP)
Примечание
Этот модуль входит в коллекцию cisco.aci (версия 2.10.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.aci.
Чтобы использовать его в плейбуке, укажите: cisco.aci.aci_maintenance_policy.
Обзор
- Управление политиками технического обслуживания, которые определяют поведение во время обновления ACI.
Параметры
Параметр | Комментарии |
|---|---|
admin_state псевдонимы: adminst строка | Административное состояние исполняемых политик. Вызовет немедленное обновление узлов, если APIC по умолчанию устанавливает Варианты:
|
annotation строка | Пользовательская строка для аннотирования объекта. Если значение не указано в задаче, будет использовано значение переменной среды Если значение не указано в задаче и переменной среды По умолчанию: |
certificate_name псевдонимы: cert_name строка | Имя сертификата X.509, прикрепленного к пользователю APIC AAA, используемому для аутентификации на основе подписи. Если предоставлено имя файла с расширением Если для Если значение не указано в задаче, будет использовано значение переменной среды |
description псевдонимы: descr строка | Описание политики технического обслуживания. |
download_state строка | Состояние загрузки исполняемых политик. APIC по умолчанию устанавливает Варианты:
|
graceful логическое | Указывает, будет ли система плавно выключать узлы во время обновления, что снизит потери трафика. APIC по умолчанию устанавливает Варианты:
|
host псевдонимы: hostname строка | IP-адрес или имя хоста APIC, разрешаемые хостом Ansible. Если значение не указано в задаче, будет использовано значение переменной среды |
ignore_compat псевдонимы: ignoreCompat логическое | Указывает, нужно ли игнорировать проверки совместимости. APIC по умолчанию устанавливает Варианты:
|
name псевдонимы: maintenance_policy строка | Имя политики технического обслуживания. |
name_alias строка | Псевдоним текущего объекта. Он относится к полю nameAlias в ACI. |
notify_condition строка | Указывает, при каком условии приостановки администратор будет уведомлен по электронной почте/сообщением, как настроено. Этот механизм уведомления независим от событий/ошибок. APIC по умолчанию устанавливает Варианты:
|
output_level строка | Влияет на вывод этого модуля ACI.
Если значение не указано в задаче, будет использовано значение переменной среды Варианты:
|
output_path строка | Путь к файлу, который будет использоваться для выгрузки объектов конфигурации ACI JSON, сгенерированных модулем. Если значение не указано в задаче, будет использовано значение переменной среды |
password строка | Пароль для аутентификации. Этот параметр взаимоисключает Если значение не указано в задаче, будут использованы переменные среды |
port целое число | Номер порта, используемый для подключения REST. Значение по умолчанию зависит от параметра Если значение не указано в задаче, будет использовано значение переменной среды |
private_key aliases: cert_key string | Либо файл закрытого ключа в формате PEM, либо содержимое закрытого ключа, используемого для аутентификации на основе подписи. Это значение также влияет на используемый по умолчанию Этот параметр несовместим с Если значение не указано в задании, вместо него будет использовано значение переменной среды |
run_mode aliases: runmode string | Определяет, останавливает ли система выполнение на ошибке или просто продолжает её обрабатывать. APIC по умолчанию использует значение Варианты:
|
scheduler string | Имя планировщика, применяемого к политике. |
smu_operation string | Указывает операцию SMU. Варианты:
|
smu_operation_flags string | Указывает флаги операции SMU. Указывает, нужно ли перезагружать узел немедленно или пропустить автоматическую перезагрузку при установке/удалении SMU. Варианты:
|
sr_upgrade boolean | Обновление SR-прошивки. Варианты:
|
sr_version string | Версия SR каталога совместимости. |
state string | Используйте Используйте Варианты:
|
suppress_previous aliases: no_previous, ignore_previous boolean | Если Если значение не указано в задании, вместо него будет использовано значение переменной среды Значение по умолчанию - ПРЕДУПРЕЖДЕНИЕ - Это приводит к тому, что предыдущее возвращаемое значение становится пустым. Предыдущее состояние объекта не будет проверяться, и обновление POST будет содержать все свойства. Варианты:
|
suppress_verification aliases: no_verification, no_verify, suppress_verify, ignore_verify, ignore_verification boolean | Если Если значение не указано в задании, вместо него будет использовано значение переменной среды Значение по умолчанию - ПРЕДУПРЕЖДЕНИЕ - Это приводит к установке текущего возвращаемого значения в предлагаемое значение. Текущий объект, включая значения по умолчанию, не будет проверяться в одном задании. Варианты:
|
timeout integer | Таймаут уровня сокета в секундах. Если значение не указано в задании, вместо него будет использовано значение переменной среды Значение по умолчанию - 30. |
use_proxy boolean | Если Если значение не указано в задании, вместо него будет использовано значение переменной среды Значение по умолчанию - true. Варианты:
|
use_ssl boolean | Если Если значение не указано в задании, вместо него будет использовано значение переменной среды Значение по умолчанию - true для локального соединения. Варианты:
|
username aliases: user string | Имя пользователя для аутентификации. Если значение не указано в задании, вместо него будут использованы значения переменных среды Значение по умолчанию - admin. |
validate_certs boolean | Если Это значение следует установить в Если значение не указано в задаче, вместо него будет использовано значение переменной среды Значение по умолчанию — true. Варианты:
|
version string | Версия каталога совместимости. |
version_check_override string | Переопределение проверки версии. Это директива игнорирования проверки версии при следующем инсталляции. Проверка версии, выполняемая во время окна обслуживания, проверяет, соответствует ли желаемая версия текущей версии. Если версии не совпадают, установка выполняется. Если версии совпадают, установка не выполняется. Переопределение проверки версии — это одноразовое переопределение, которое выполняет установку независимо от совпадения версий. APIC по умолчанию устанавливает значение Варианты:
|
Примечания
Примечание
- Для данного модуля требуется планировщик, который может быть создан с помощью модуля cisco.aci.aci_fabric_scheduler или через пользовательский интерфейс.
См. также
См. также
- cisco.aci.aci_fabric_scheduler
-
Этот модуль создает планировщики ACI (trig:SchedP).
- APIC Management Information Model reference
-
Дополнительная информация об внутренней классе APIC maint:MaintP.
- Руководство по Cisco ACI
-
Подробная информация о том, как управлять вашей инфраструктурой ACI с помощью Ansible.
- Разработка модулей Cisco ACI
-
Подробное руководство по написанию собственных модулей Cisco ACI для внесения вклада.
Примеры
- name: Create a maintenance policy
cisco.aci.aci_maintenance_policy:
host: apic
username: admin
password: SomeSecretPassword
name: my_maintenance_policy
scheduler: simpleScheduler
state: present
delegate_to: localhost
- name: Delete a maintenance policy
cisco.aci.aci_maintenance_policy:
host: apic
username: admin
password: SomeSecretPassword
name: my_maintenance_policy
state: absent
delegate_to: localhost
- name: Query all maintenance policies
cisco.aci.aci_maintenance_policy:
host: apic
username: admin
password: SomeSecretPassword
state: query
delegate_to: localhost
register: query_result
- name: Query a specific maintenance policy
cisco.aci.aci_maintenance_policy:
host: apic
username: admin
password: SomeSecretPassword
name: my_maintenance_policy
state: query
delegate_to: localhost
register: query_result
Значения возврата
Общие значения возврата описаны здесь, следующие являются полями, уникальными для этого модуля:
Ключ | Описание |
|---|---|
current список / элементы=строка | Существующая конфигурация с APIC после завершения модуля Возвращено: успех Пример: |
error словарь | Информация об ошибке, возвращенная с APIC Возвращено: ошибка Пример: |
filter_string строка | Строка фильтра, используемая для запроса Возвращено: ошибка или отладка Пример: |
method строка | HTTP-метод, используемый для запроса к APIC Возвращено: ошибка или отладка Пример: |
previous список / элементы=строка | Исходная конфигурация с APIC до запуска модуля Возвращено: информация Пример: |
proposed словарь | Собраная конфигурация из переданных пользователем параметров Возвращено: информация Пример: |
raw строка | Необработанный результат, возвращенный API REST APIC (xml или json) Возвращено: ошибка разбора Пример: |
response строка | HTTP-ответ с APIC Возвращено: ошибка или отладка Пример: |
sent список / элементы=строка | Фактическая/минимальная конфигурация, отправленная на APIC Возвращено: информация Пример: |
status целое число | HTTP-статус с APIC Возвращено: ошибка или отладка Пример: |
url строка | Используемый HTTP-url для запроса к APIC Возвращено: ошибка или отладка Пример: |
Ссылки на коллекции
© 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/cisco/aci/aci_maintenance_policy_module.html