community.network.ce_ip_interface – Управляет атрибутами L3 для интерфейсов IPv4 и IPv6 на коммутаторах HUAWEI CloudEngine.
Примечание
Этот плагин является частью коллекции community.network (версия 1.3.0).
Для его установки используйте: ansible-galaxy collection install community.network.
Чтобы использовать его в книге задач, укажите: community.network.ce_ip_interface.
Обзор
- Управляет атрибутами третьего уровня для интерфейсов 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 boolean | всегда | Проверяет, были ли внесены изменения на устройстве Пример: True |
| end_state словарь | всегда | Ключевые пары атрибутов IP после выполнения модуля Пример: {'interface': '10GE1/0/22', 'ipv4': [{'addrType': 'main', 'ifIpAddr': '20.20.20.20', 'subnetMask': '255.255.255.0'}]} |
| existing словарь | всегда | Ключевые пары существующих атрибутов IP на интерфейсе Пример: {'interface': '10GE1/0/22', 'ipv4': [{'addrType': 'main', 'ifIpAddr': '11.11.11.11', 'subnetMask': '255.255.0.0'}]} |
| proposed словарь | всегда | Ключевые пары параметров, переданных в модуль Пример: {'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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/network/ce_ip_interface_module.html