Модуль community.network.ce_interface — Управляет физическими атрибутами интерфейсов на коммутаторах HUAWEI CloudEngine.

Примечание

Этот модуль является частью коллекции community.network (версия 5.0.3).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.network.

Чтобы использовать его в книге задач, укажите: community.network.ce_interface.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

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

Псевдонимы: network.cloudengine.ce_interface

Параметры

Параметр	Комментарии
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 булево	Указывает, является ли интерфейс под-интерфейсом второго уровня. Выбори: `false` ← (по умолчанию) `true`
mode строка	Управление состоянием интерфейса второго или третьего уровня. Выбори: `"layer2"` `"layer3"`
state строка	Указывает желаемое состояние ресурса. Выбори: `"present"` ← (по умолчанию) `"absent"` `"default"`

Примечания

Примечание

Этот модуль также используется для создания логических интерфейсов, таких как vlanif и loopbacks.
Для этого модуля требуется, чтобы на управляемом удалённом устройстве была включена служба netconf.
Рекомендуемое соединение — netconf.
Этот модуль также работает с подключениями local для устаревших книг задач.

Примеры

- name: Interface module test
  hosts: cloudengine
  connection: local
  gather_facts: false
  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
    community.network.ce_interface:
      interface: 10GE1/0/22
      description: 'Configured by Ansible'
      mode: layer3
      provider: '{{ cli }}'

  - name: Admin down an interface
    community.network.ce_interface:
      interface: 10GE1/0/22
      admin_state: down
      provider: '{{ cli }}'

  - name: Remove all tunnel interfaces
    community.network.ce_interface:
      interface_type: tunnel
      state: absent
      provider: '{{ cli }}'

  - name: Remove all logical interfaces
    community.network.ce_interface:
      interface_type: '{{ item }}'
      state: absent
      provider: '{{ cli }}'
    with_items:
      - loopback
      - eth-trunk
      - nve

  - name: Admin up all 10GE interfaces
    community.network.ce_interface:
      interface_type: 10GE
      admin_state: up
      provider: '{{ cli }}'

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Описание
changed булево	проверка, были ли внесены изменения на устройстве Возвращается: всегда Пример: `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 пары параметров, переданных в модуль Возвращается: всегда Пример: `{"admin_state": "down", "interface": "10GE1/0/10"}`
updates список / элементы=строка	список команд, отправленных на устройство Возвращается: всегда Пример: `["interface 10GE1/0/10", "shutdown"]`

Авторы

QijunPan (@QijunPan)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/network/ce_interface_module.html