aci_config_rollback — Предоставляет функциональность отката и предварительного просмотра отката (config:ImportP)

Новая в версии 2.4.

Описание
Параметры
Примечания
Примеры
Значения возврата
Статус
- Автор

Описание

Предоставляет функциональность отката и предварительного просмотра отката для Cisco ACI сетей.
Откат конфигурации выполняется с использованием снимков aci_snapshot с помощью класса configImportP.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
certificate_name	Значение по умолчанию: C(private_key) basename	Имя сертификата X.509, прикрепленного к пользователю APIC AAA, используемому для аутентификации на основе подписи. По умолчанию устанавливается в `private_key` basename без расширения. Псевдонимы: cert_name
compare_export_policy		Политика экспорта, к которой связан `compare_snapshot`.
compare_snapshot		Имя снимка для сравнения с `snapshot`.
description		Описание для политики импорта. Псевдонимы: descr
export_policy обязательно		Политика экспорта, к которой связан `snapshot`.
fail_on_decrypt	Варианты: no yes ←	Определяет, должен ли APIC прервать откат, если не удаётся расшифровать защищённые данные. APIC по умолчанию устанавливает новые политики импорта в `yes`.
host обязательно		IP-адрес или имя хоста APIC, разрешаемый управляющим хостом Ansible. Псевдонимы: hostname
import_mode	Варианты: atomic ← best-effort	Определяет, как APIC должен обработать импорт. APIC по умолчанию устанавливает новые политики импорта в `atomic`.
import_policy		Имя политики импорта для использования при откате конфигурации.
import_type	Варианты: merge replace ←	Определяет, как текущая и снимковая конфигурация должны сравниваться для замены. APIC по умолчанию устанавливает новые политики импорта в `replace`.
output_level	Варианты: debug info normal ←	Влияет на вывод данного модуля ACI. `normal` означает стандартный вывод, включая `current` dict. `info` означает информативный вывод, включая `previous`, `proposed` и `sent` dicts. `debug` означает отладочный вывод, включая `filter_string`, `method`, `response`, `status` и `url` информацию.
password обязательно		Пароль для аутентификации.
port	Значение по умолчанию: 443 (для https) и 80 (для http)	Номер порта, используемый для подключения REST.
private_key		Файл в формате PEM, содержащий ваш закрытый ключ, используемый для аутентификации на основе подписи. Имя ключа (без расширения) используется как имя сертификата в ACI, если не указано `certificate_name`. Псевдонимы: cert_key
snapshot обязательно		Имя снимка, на который нужно откатиться, или базовый снимок для сравнения. Модуль `aci_snapshot` может быть использован для запроса списка доступных снимков.
state	Варианты: preview rollback ←	Используйте `preview` для предварительного просмотра различий между двумя снимками. Используйте `rollback` для восстановления конфигурации до предыдущего снимка.
timeout	Значение по умолчанию: 30	Таймаут уровня сокета в секундах.
use_proxy	Варианты: no yes ←	Если `no`, прокси не будет использоваться, даже если он определён в переменной окружения на целевых хостах.
use_ssl	Варианты: no yes ←	Если `no`, вместо стандартного HTTPS соединения будет использовано HTTP соединение.
username обязательно	Значение по умолчанию: admin	Имя пользователя для аутентификации. Псевдонимы: user
validate_certs	Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Это должно быть установлено только на `no` используемых на контролируемых лично сайтах с самозаверяющимися сертификатами.

Примечания

Примечание

Дополнительную информацию о внутреннем классе APIC config:ImportP можно найти в справочнике по модели управления информацией APIC.
По умолчанию, если переменная окружения <protocol>_proxy установлена на целевом хосте, запросы будут отправлены через этот прокси. Это поведение можно переопределить, задав переменную для этой задачи (см. установку окружения), или используя опцию use_proxy.
HTTP-перенаправления могут перенаправлять с HTTP на HTTPS, поэтому следует убедиться, что ваша прокси-среда для обоих протоколов корректна.

Примеры

---
- name: Create a Snapshot
  aci_config_snapshot:
    host: apic
    username: admin
    password: SomeSecretPassword
    state: present
    export_policy: config_backup

- name: Query Existing Snapshots
  aci_config_snapshot:
    host: apic
    username: admin
    password: SomeSecretPassword
    state: query
    export_policy: config_backup

- name: Compare Snapshot Files
  aci_config_rollback:
    host: apic
    username: admin
    password: SomeSecretPassword
    state: preview
    export_policy: config_backup
    snapshot: run-2017-08-28T06-24-01
    compare_export_policy: config_backup
    compare_snapshot: run-2017-08-27T23-43-56

- name: Rollback Configuration
  aci_config_rollback:
    host: apic
    username: admin
    password: SomeSecretPassword
    state: rollback
    import_policy: rollback_config
    export_policy: config_backup
    snapshot: run-2017-08-28T06-24-01

- name: Rollback Configuration
  aci_config_rollback:
    host: apic
    username: admin
    password: SomeSecretPassword
    state: rollback
    import_policy: rollback_config
    export_policy: config_backup
    snapshot: run-2017-08-28T06-24-01
    description: Rollback 8-27 changes
    import_mode: atomic
    import_type: replace
    fail_on_decrypt: yes

Значения возврата

Общие значения возврата описаны в документации. Следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
error словарь	ошибка	Информация об ошибке, возвращенная APIC Пример: {'text': 'unknown managed object class foo', 'code': '122'}
filter_string строка	ошибка или отладка	Строка фильтра, используемая для запроса Пример: ?rsp-prop-include=config-only
method строка	ошибка или отладка	Метод HTTP, используемый для запроса к APIC Пример: POST
preview строка	при state = preview	Предварительный просмотр различий между двумя снимками
raw строка	ошибка парсинга	Необработанный вывод, возвращённый APIC REST API (xml или json) Пример: <?xml version="1.0" encoding="UTF-8"?><imdata totalCount="1"><error code="122" text="unknown managed object class foo"/></imdata>
response строка	ошибка или отладка	HTTP-ответ от APIC Пример: OK (30 байт)
status целое число	ошибка или отладка	HTTP-статус от APIC Пример: 200
url строка	ошибка или отладка	HTTP-URL, используемый для запроса к APIC Пример: https://10.11.12.13/api/mo/uni/tn-production.json

Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.

Автор

Jacob McGill (@jmcgill298)

Подсказка

Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/aci_config_rollback_module.html