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

Примечание

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

Вам, возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

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

Для использования в плейбуке укажите: community.network.ce_ip_interface.

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

Обзор

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

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

Параметры

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

Примечания

Примечание

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

Примеры

- name: Ip_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 ipv4 address is configured on 10GE1/0/22
    community.network.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
    community.network.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
    community.network.ce_ip_interface:
      interface: 10GE1/0/22
      version: v6
      state: present
      provider: '{{ cli }}'

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

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

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

Ключ	Описание
changed логический	проверка, были ли внесены изменения на устройстве Возвращается: всегда Пример: `true`
end_state словарь	k/v пары атрибутов IP после выполнения модуля Возвращается: всегда Пример: `{"interface": "10GE1/0/22", "ipv4": [{"addrType": "main", "ifIpAddr": "20.20.20.20", "subnetMask": "255.255.255.0"}]}`
existing словарь	k/v пары существующих атрибутов IP на интерфейсе Возвращается: всегда Пример: `{"interface": "10GE1/0/22", "ipv4": [{"addrType": "main", "ifIpAddr": "11.11.11.11", "subnetMask": "255.255.0.0"}]}`
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"]`

Авторы

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_ip_interface_module.html