ce_interface - Управляет физическими атрибутами интерфейсов на коммутаторах HUAWEI CloudEngine.
Новая версия с 2.4.
Обзор
- Управляет физическими атрибутами интерфейсов на коммутаторах HUAWEI CloudEngine.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| admin_state |
None | Определяет состояние управления интерфейсом. Значение — перечисление. up, Интерфейс находится в административном состоянии «Включен». down, Интерфейс находится в административном состоянии «Выключен». |
| description | Значение по умолчанию: None | Указывает описание интерфейса. Значение — строка длиной от 1 до 242 символов, регистрозависимая, поддерживаются пробелы, но не вопросительные знаки (?). |
| interface | Значение по умолчанию: None | Полное имя интерфейса, например, 40GE1/0/10, Tunnel1. |
| interface_type |
None | Тип интерфейса для настройки на устройстве. |
| l2sub | Значение по умолчанию: no | Указывает, является ли интерфейс под-интерфейсом второго уровня. |
| mode |
None | Управление состоянием интерфейса второго или третьего уровня. |
| state обязательно |
| Укажите желаемое состояние ресурса. |
Примечания
Примечание
- Этот модуль также используется для создания логических интерфейсов, таких как vlanif и loopback.
Примеры
- 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 boolean | всегда | проверка, было ли внесено изменение на устройстве Пример: True |
| end_state dict | всегда | k/v пары switchport после выполнения модуля Пример: {'interface': '10GE1/0/10', 'admin_state': 'down', 'description': 'None', 'mode': 'layer2'} |
| existing dict | всегда | k/v пары существующего switchport Пример: {'interface': '10GE1/0/10', 'admin_state': 'up', 'description': 'None', 'mode': 'layer2'} |
| proposed dict | всегда | k/v пары параметров, переданных в модуль Пример: {'interface': '10GE1/0/10', 'admin_state': 'down'} |
| updates список | всегда | список команд, отправленных на устройство Пример: ['interface 10GE1/0/10', 'shutdown'] |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Автор
- QijunPan (@CloudEngine-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.5/modules/ce_interface_module.html