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

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

Описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Описание

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

Параметры

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

Примечания

Примечание

Дополнительную информацию о внутреннем классе APIC config:ImportP см. в справочнике по модели управления информацией APIC.
Подробнее о том, как управлять своей инфраструктурой ACI с помощью Ansible, см. в руководстве по Cisco ACI.

Примеры

---
- 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 dict	ошибка	Информация об ошибке, возвращаемая APIC Пример: {'code': '122', 'text': 'неизвестный класс управляемого объекта foo'}
filter_string строка	ошибка или отладка	Строка фильтра, используемая для запроса Пример: ?rsp-prop-include=config-only
method строка	ошибка или отладка	HTTP-метод, используемый для запроса к APIC Пример: POST
preview строка	при состоянии preview	Предварительный просмотр между двумя моментами
raw строка	ошибка разбора	Необработанный вывод, возвращённый REST API APIC (xml или json) Пример: <?xml version="1.0" encoding="UTF-8"?><imdata totalCount="1"><error code="122" text="неизвестный класс управляемого объекта 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

Статус

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.

Список других модулей, поддерживаемых сообществом Ansible, см. здесь.

Автор

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.6/modules/aci_config_rollback_module.html