community.network.ce_ip_interface – Управляет атрибутами L3 для интерфейсов IPv4 и IPv6 на коммутаторах HUAWEI CloudEngine.
Примечание
Этот плагин входит в коллекцию community.network (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.network.
Для использования в книге задач укажите: community.network.ce_ip_interface.
Описание
- Управляет атрибутами уровня 3 для интерфейсов IPv4 и IPv6 на коммутаторах HUAWEI CloudEngine.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| addr строка | Адрес IPv4 или IPv6. | |
| interface строка / обязательный | Полное имя интерфейса, например, 40GE1/0/22, vlanif10. | |
| ipv4_type строка |
| Указывает тип адреса. Значение является перечислением. main, основной IP-адрес. sub, вторичный IP-адрес. |
| mask строка | Маска подсети для IPv4 или IPv6 адреса в десятичном формате. | |
| state строка |
| Указывает желаемое состояние ресурса. |
| version строка |
| Версия IP-адреса. |
Примечания
Примечание
- Интерфейс должен уже быть портом L3 при использовании этого модуля.
- Логические интерфейсы (loopback, vlanif) должны быть созданы предварительно.
-
maskдолжно быть вставлено в десятичном формате (например, 24) как для IPv6, так и для IPv4. - Один интерфейс может иметь несколько настроенных IPv6.
- Для работы этого модуля требуется, чтобы служба netconf была включена на управляемом удалённом устройстве.
- Рекомендуемое подключение
netconf. - Этот модуль также работает с
localподключениями для устаревших книг задач.
Примеры
- 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
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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/ce_ip_interface_module.html