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.
Для этого модуля требуется, чтобы служба netconf system была включена на управляемом удалённом устройстве.
Рекомендуемое соединение netconf.
Этот модуль также работает с local подключениями для устаревших playbooks.

Примеры

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

Статус

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

Авторы

QijunPan (@QijunPan)

Подсказка

Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать его, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/ce_interface_module.html