ce_interface - Управляет физическими атрибутами интерфейсов на коммутаторах HUAWEI CloudEngine.
Новое в версии 2.4.
Обзор
- Управляет физическими атрибутами интерфейсов на коммутаторах HUAWEI CloudEngine.
Параметры
| параметр | обязателен | значение по умолчанию | выбор | комментарии |
|---|---|---|---|---|
| admin_state | нет |
| Указывает состояние управления интерфейсом. Значение — перечисление. up, интерфейс находится в административном состоянии ВКЛЮЧЕНО. down, интерфейс находится в административном состоянии ВЫКЛЮЧЕНО. | |
| description | нет | Указывает описание интерфейса. Значение — строка от 1 до 242 символов, чувствительная к регистру, пробелы разрешены, но знаки вопроса (?) — нет. | ||
| interface | нет | Полное имя интерфейса, например, 40GE1/0/10, Tunnel1. | ||
| interface_type | нет |
| Тип интерфейса для конфигурации на устройстве. | |
| l2sub | нет | Указывает, является ли интерфейс под-интерфейсом второго уровня. | ||
| mode | нет |
| Управляет состоянием интерфейса второго или третьего уровня. | |
| state | да | present |
| Указывает желаемое состояние ресурса. |
Примеры
- name: interface module test
hosts: cloudengine
connection: local
gather_facts: no
vars:
cli:
host: "{{ inventory_hostname }}"
port: "{{ ansible_ssh_port }}"
username: "{{ username }}"
password: "{{ password }}"
transport: cli
tasks:
- name: Ensure an interface is a Layer 3 port and that it has the proper description
ce_interface:
interface: 10GE1/0/22
description: 'Configured by Ansible'
mode: layer3
provider: '{{ cli }}'
- name: Admin down an interface
ce_interface:
interface: 10GE1/0/22
admin_state: down
provider: '{{ cli }}'
- name: Remove all tunnel interfaces
ce_interface:
interface_type: tunnel
state: absent
provider: '{{ cli }}'
- name: Remove all logical interfaces
ce_interface:
interface_type: '{{ item }}'
state: absent
provider: '{{ cli }}'
with_items:
- loopback
- eth-trunk
- nve
- name: Admin up all 10GE interfaces
ce_interface:
interface_type: 10GE
admin_state: up
provider: '{{ cli }}'
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для данного модуля:
| имя | описание | возвращено | тип | пример |
|---|---|---|---|---|
| changed | проверка, были ли внесены изменения на устройстве | всегда | булево | True |
| end_state | k/v пары switchport после выполнения модуля | всегда | словарь | {'interface': '10GE1/0/10', 'admin_state': 'down', 'description': 'None', 'mode': 'layer2'} |
| existing | k/v пары существующего switchport | всегда | словарь | {'interface': '10GE1/0/10', 'admin_state': 'up', 'description': 'None', 'mode': 'layer2'} |
| proposed | k/v пары параметров, переданных в модуль | всегда | словарь | {'interface': '10GE1/0/10', 'admin_state': 'down'} |
| updates | список команд, отправленных устройству | всегда | список | ['interface 10GE1/0/10', 'shutdown'] |
Примечания
Примечание
- Этот модуль также используется для создания логических интерфейсов, таких как vlanif и loopback.
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратно совместимым.
Для получения помощи в разработке модулей, если вы заинтересованы, прочитайте Информацию о сообществе и содействие, Тестирование 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/ce_interface_module.html