Модуль cisco.nxos.nxos_snapshot – Управление снимками рабочих состояний выбранных функций.

Примечание

Этот модуль является частью коллекции cisco.nxos (версия 8.1.0).

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

Для установки используйте: ansible-galaxy collection install cisco.nxos.

Чтобы использовать её в playbook, укажите: cisco.nxos.nxos_snapshot.

Новое в cisco.nxos 1.0.0

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Создавайте снимки рабочих состояний выбранных функций, добавляйте новые команды show для создания снимков, удаляйте и сравнивайте существующие снимки.

Псевдонимы: snapshot

Параметры

Параметр	Комментарии
action string / обязательный	Определите, какое действие со снимком будет выполнять модуль. Варианты: `"add"` `"compare"` `"create"` `"delete"` `"delete_all"`
compare_option string	Параметры снимка, которые будут использоваться при `action=compare`. Варианты: `"summary"` `"ipv4routes"` `"ipv6routes"`
comparison_results_file string	Имя файла, в котором будет сохранено сравнение снимков при `action=compare`.
description string	Описание снимка, которое будет использоваться при `action=create`.
element_key1 string	Укажите теги, используемые для различения записей строк, которые будут использоваться при `action=add`.
element_key2 string	Укажите теги, используемые для различения записей строк, которые будут использоваться при `action=add`.
path string	Укажите путь к файлу, где будет сохранен новый созданный снимок или сравнение снимков, которое будет использоваться при `action=create` и `save_snapshot_locally=true` или `action=compare`. Значение по умолчанию: `"./"`
row_id string	Указывает тег каждой записи строки выходных данных команды show в формате XML, который будет использоваться при `action=add`.
save_snapshot_locally boolean	Укажите, нужно ли локально сохранить новый созданный снимок, который будет использоваться при `action=create`. Варианты: `false` ← (по умолчанию) `true`
section string	Используется для именования вывода команды show, который будет использоваться при `action=add`.
show_command string	Укажите новую команду show, которая будет использоваться при `action=add`.
snapshot1 string	Первый снимок, который будет использоваться при `action=compare`.
snapshot2 string	Второй снимок, который будет использоваться при `action=compare`.
snapshot_name string	Имя снимка, которое будет использоваться при `action=create` или `action=delete`.

Примечания

Примечание

Тестировалось на NXOSv 7.3.(0)D1(1) на VIRL
Не поддерживается для Cisco MDS
transport=cli может вызывать ошибки тайм-аута.
Параметры element_key1 и element_key2 указывают теги, используемые для различения записей строк. В большинстве случаев для различения записей строк необходимо указать только параметр element_key1.
action=compare всегда будет хранить отчет о сравнении в локальном файле.
Для получения информации об использовании CLI и NX-API см. руководство :ref:`NXOS Platform Options guide <nxos_platform_options>`
Для получения дополнительной информации об использовании Ansible для управления сетевыми устройствами см. :ref:`Ansible Network Guide <network_guide>`
Для получения дополнительной информации об использовании Ansible для управления устройствами Cisco см. страницу интеграции Cisco <https://www.ansible.com/integrations/networks/cisco>`_.

Примеры

# Create a snapshot and store it locally
- cisco.nxos.nxos_snapshot:
    action: create
    snapshot_name: test_snapshot
    description: Done with Ansible
    save_snapshot_locally: true
    path: /home/user/snapshots/

# Delete a snapshot
- cisco.nxos.nxos_snapshot:
    action: delete
    snapshot_name: test_snapshot

# Delete all existing snapshots
- cisco.nxos.nxos_snapshot:
    action: delete_all

# Add a show command for snapshots creation
- cisco.nxos.nxos_snapshot:
    section: myshow
    show_command: show ip interface brief
    row_id: ROW_intf
    element_key1: intf-name

# Compare two snapshots
- cisco.nxos.nxos_snapshot:
    action: compare
    snapshot1: pre_snapshot
    snapshot2: post_snapshot
    comparison_results_file: compare_snapshots.txt
    compare_option: summary
    path: ../snapshot_reports/

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

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

Ключ	Описание
commands list / elements=string	команды, отправленные на устройство Возвращается: в подробном режиме Пример: `["snapshot create post_snapshot Post-snapshot"]`

Авторы

Gabriele Gerbino (@GGabriele)

Ссылки на коллекцию

© 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/nxos/nxos_snapshot_module.html