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, основной IP-адрес. sub, вторичный IP-адрес. |
| mask | Маска подсети для адреса IPv4 или IPv6 в десятичном формате. |
|
| state |
|
Указывает желаемое состояние ресурса. |
| version |
|
Версия IP-адреса. |
Примечания
Примечание
- Интерфейс должен быть портом L3 при использовании данного модуля.
- Логические интерфейсы (loopback, vlanif) должны быть созданы предварительно.
-
maskдолжен быть вставлен в десятичном формате (например, 24) как для IPv6, так и для IPv4. - Один интерфейс может иметь несколько конфигураций IPv6.
Примеры
- 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 dict |
всегда | пара пары ключ-значение атрибутов IP после выполнения модуля
Пример:
{'ipv4': [{'ifIpAddr': '20.20.20.20', 'subnetMask': '255.255.255.0', 'addrType': 'main'}], 'interface': '10GE1/0/22'}
|
| existing dict |
всегда | пара пары ключ-значение существующих атрибутов IP на интерфейсе
Пример:
{'ipv4': [{'ifIpAddr': '11.11.11.11', 'subnetMask': '255.255.0.0', 'addrType': 'main'}], 'interface': '10GE1/0/22'}
|
| proposed dict |
всегда | пара пары ключ-значение параметров, переданных в модуль
Пример:
{'addr': '20.20.20.20', 'interface': '10GE1/0/22', 'mask': '24'}
|
| updates list |
всегда | команды, отправленные на устройство
Пример:
['interface 10GE1/0/22', 'ip address 20.20.20.20 24']
|
Статус
Данный модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратно совместимым.
Техническое обслуживание
Данный модуль помечен как общедоступный, что означает, что его поддерживает сообщество Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- QijunPan (@CloudEngine-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.6/modules/ce_ip_interface_module.html