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 |
| Указывает тип адреса. Значение — перечисление. main — основной IP-адрес. sub — дополнительный IP-адрес. |
| mask | нет | Маска подсети для адреса IPv4 или IPv6 в десятичном формате. | ||
| state | нет | present |
| Указывает требуемое состояние ресурса. |
| version | нет | v4 |
| Версия IP-адреса. |
Примеры
- 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 | проверка, было ли внесено изменение на устройстве | всегда | булево | True |
| end_state | пара ключ-значение атрибутов IP после выполнения модуля | всегда | словарь | {'interface': '10GE1/0/22', 'ipv4': [{'subnetMask': '255.255.255.0', 'ifIpAddr': '20.20.20.20', 'addrType': 'main'}]} |
| existing | пара ключ-значение существующих атрибутов IP на интерфейсе | всегда | словарь | {'interface': '10GE1/0/22', 'ipv4': [{'subnetMask': '255.255.0.0', 'ifIpAddr': '11.11.11.11', 'addrType': 'main'}]} |
| proposed | пара ключ-значение параметров, переданных в модуль | всегда | словарь | {'interface': '10GE1/0/22', 'mask': '24', 'addr': '20.20.20.20'} |
| updates | команды, отправленные на устройство | всегда | список | ['interface 10GE1/0/22', 'ip address 20.20.20.20 24'] |
Примечания
Примечание
- Интерфейс должен уже быть портом L3 при использовании этого модуля.
- Логические интерфейсы (loopback, vlanif) должны быть созданы предварительно.
-
maskдолжен быть вставлен в десятичном формате (например, 24) для IPv6 и IPv4. - Один интерфейс может иметь несколько конфигураций IPv6.
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Для получения помощи в разработке модулей, если вы заинтересованы, пожалуйста, ознакомьтесь с Информация о сообществе и участие в разработке, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/ce_ip_interface_module.html