ce_interface - Управляет физическими атрибутами интерфейсов на коммутаторах HUAWEI CloudEngine.

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

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

Обзор

Управляет физическими атрибутами интерфейсов на коммутаторах HUAWEI CloudEngine.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
admin_state	Варианты: up down	Указывает состояние управления интерфейсом. Значение является перечислением. up, Интерфейс находится в административном состоянии «Включено». down, Интерфейс находится в административном состоянии «Выключено».
description		Указывает описание интерфейса. Значение — строка длиной от 1 до 242 символов, чувствительная к регистру, поддерживаются пробелы, но не вопросительные знаки (?).
interface		Полное имя интерфейса, например, 40GE1/0/10, Tunnel1.
interface_type	Варианты: ge 10ge 25ge 4x10ge 40ge 100ge vlanif loopback meth eth-trunk nve tunnel ethernet fcoe-port fabric-port stack-port null	Тип интерфейса для настройки на устройстве.
l2sub bool	Варианты: нет ← да	Указывает, является ли интерфейс под-интерфейсом второго уровня.
mode	Варианты: layer2 layer3	Управление состоянием интерфейса второго или третьего уровня.
state	Варианты: present ← absent default	Указывает желаемое состояние ресурса.

Примечания

Примечание

Этот модуль также используется для создания логических интерфейсов, таких как 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 после выполнения модуля Пример: {'admin_state': 'down', 'description': 'None', 'interface': '10GE1/0/10', 'mode': 'layer2'}
existing dict	всегда	k/v пары существующего switchport Пример: {'admin_state': 'up', 'description': 'None', 'interface': '10GE1/0/10', 'mode': 'layer2'}
proposed dict	всегда	k/v пары параметров, переданных в модуль Пример: {'interface': '10GE1/0/10', 'admin_state': 'down'}
updates list	всегда	список команд, отправленных на устройство Пример: ['interface 10GE1/0/10', 'shutdown']

Статус

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

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

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

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

Автор

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