aos_logical_device - Управление логическим устройством AOS
Новая версия 2.3.
Обзор
- Модуль Apstra AOS Logical Device позволяет легко управлять логическими устройствами. Вы можете создавать, удалять логические устройства по имени, идентификатору или с помощью файла JSON. Этот модуль идемпотентен и поддерживает режим проверки. Он использует API AOS REST.
Требования (к хосту, на котором выполняется модуль)
- aos-pyez >= 0.6.0
Параметры
| параметр | обязательный | значение по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| content | нет | Структура данных логического устройства для создания. Данные могут быть в формате YAML/JSON или напрямую в виде переменной. Эта структура данных такая же, как и та, что возвращается при успешном выполнении в value. | ||
| id | нет | Идентификатор AOS логического устройства для управления (не может использоваться для создания нового логического устройства). Только один из параметров name, id или content может быть задан. | ||
| name | нет | Имя логического устройства для управления. Только один из параметров name, id или content может быть задан. | ||
| session | да | Существующая сессия AOS, полученная модулем aos_login. | ||
| state | нет | present |
| Указывает ожидаемое состояние логического устройства (существует или отсутствует). |
Примеры
- name: "Delete a Logical Device by name"
aos_logical_device:
session: "{{ aos_session }}"
name: "my-logical-device"
state: absent
- name: "Delete a Logical Device by id"
aos_logical_device:
session: "{{ aos_session }}"
id: "45ab26fc-c2ed-4307-b330-0870488fa13e"
state: absent
# Save a Logical Device to a file
- name: "Access Logical Device 1/3"
aos_logical_device:
session: "{{ aos_session }}"
name: "my-logical-device"
state: present
register: logical_device
- name: "Save Logical Device into a JSON file 2/3"
copy:
content: "{{ logical_device.value | to_nice_json }}"
dest: logical_device_saved.json
- name: "Save Logical Device into a YAML file 3/3"
copy:
content: "{{ logical_device.value | to_nice_yaml }}"
dest: logical_device_saved.yaml
- name: "Load Logical Device from a JSON file"
aos_logical_device:
session: "{{ aos_session }}"
content: "{{ lookup('file', 'resources/logical_device_saved.json') }}"
state: present
- name: "Load Logical Device from a YAML file"
aos_logical_device:
session: "{{ aos_session }}"
content: "{{ lookup('file', 'resources/logical_device_saved.yaml') }}"
state: present
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимостью.
Для получения помощи в разработке модулей, если это необходимо, пожалуйста, ознакомьтесь с Информацией сообщества и сотрудничеством, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/aos_logical_device_module.html