ce_ip_interface – Управляет атрибутами L3 для интерфейсов IPv4 и IPv6 на коммутаторах HUAWEI CloudEngine

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

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

Обзор

Управляет атрибутами уровня 3 для интерфейсов IPv4 и IPv6 на коммутаторах HUAWEI CloudEngine.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
addr -		Адрес IPv4 или IPv6.
interface - / обязательно		Полное имя интерфейса, например, 40GE1/0/22, vlanif10.
ipv4_type -	Варианты: main ← sub	Указывает тип адреса. Значение — перечисление. main, основной IP-адрес. sub, вторичный IP-адрес.
mask -		Маска подсети для адреса IPv4 или IPv6 в десятичном формате.
state -	Варианты: present ← absent	Указывает желаемое состояние ресурса.
version -	Варианты: v4 ← v6	Версия IP-адреса.

Примечания

Примечание

Интерфейс должен быть портом L3 при использовании данного модуля.
Логические интерфейсы (loopback, vlanif) необходимо создать предварительно.
mask должно быть введено в десятичном формате (например, 24) как для IPv6, так и для IPv4.
Один интерфейс может иметь несколько настроек IPv6.
Для работы этого модуля требуется включенная служба netconf на управляемом удалённом устройстве.
Рекомендуемое подключение netconf.
Этот модуль также работает с local подключениями для устаревших playbooks.

Примеры

- name: ip_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 ipv4 address is configured on 10GE1/0/22
    ce_ip_interface:
      interface: 10GE1/0/22
      version: v4
      state: present
      addr: 20.20.20.20
      mask: 24
      provider: '{{ cli }}'

  - name: Ensure ipv4 secondary address is configured on 10GE1/0/22
    ce_ip_interface:
      interface: 10GE1/0/22
      version: v4
      state: present
      addr: 30.30.30.30
      mask: 24
      ipv4_type: sub
      provider: '{{ cli }}'

  - name: Ensure ipv6 is enabled on 10GE1/0/22
    ce_ip_interface:
      interface: 10GE1/0/22
      version: v6
      state: present
      provider: '{{ cli }}'

  - name: Ensure ipv6 address is configured on 10GE1/0/22
    ce_ip_interface:
      interface: 10GE1/0/22
      version: v6
      state: present
      addr: 2001::db8:800:200c:cccb
      mask: 64
      provider: '{{ cli }}'

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

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

Ключ	Возвращаемое значение	Описание
changed boolean	всегда	проверка, были ли внесены изменения на устройстве Пример: True
end_state словарь	всегда	k/v пары атрибутов IP после выполнения модуля Пример: {'ipv4': [{'ifIpAddr': '20.20.20.20', 'subnetMask': '255.255.255.0', 'addrType': 'main'}], 'interface': '10GE1/0/22'}
existing словарь	всегда	k/v пары существующих атрибутов IP на интерфейсе Пример: {'ipv4': [{'ifIpAddr': '11.11.11.11', 'subnetMask': '255.255.0.0', 'addrType': 'main'}], 'interface': '10GE1/0/22'}
proposed словарь	всегда	k/v пары параметров, переданных в модуль Пример: {'addr': '20.20.20.20', 'interface': '10GE1/0/22', 'mask': '24'}
updates список	всегда	команды, отправленные на устройство Пример: ['interface 10GE1/0/22', 'ip address 20.20.20.20 24']

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом 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.8/modules/ce_ip_interface_module.html