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

Статус

Для этого модуля не гарантируется обратная совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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