Модуль dellemc.enterprise_sonic.sonic_interfaces — настройка атрибутов интерфейсов, таких как Eth, LAG, VLAN и loopback. (создание интерфейса loopback, если он не существует.)

Примечание

Этот модуль входит в коллекцию dellemc.enterprise_sonic (версия 3.2.0).

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

Чтобы установить её, используйте: ansible-galaxy collection install dellemc.enterprise_sonic.

Чтобы использовать её в плейбуке, укажите: dellemc.enterprise_sonic.sonic_interfaces.

Добавлено в dellemc.enterprise_sonic 1.0.0

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

Обзор

Настройка атрибутов интерфейсов, таких как MTU, административное состояние и т. д., для интерфейсов Eth, LAG, VLAN и loopback. (создание интерфейса loopback, если он не существует.)

Параметры

Параметр	Комментарии
config list / elements=dictionary	Список конфигураций интерфейсов.
advertised_speed list / elements=string	Анонсируемые скорости интерфейса. Применимо только к интерфейсам Ethernet. Поддерживаемые скорости зависят от типа коммутатора. Скорости могут составлять 10, 100, 1000, 2500, 5000, 10000, 20000, 25000, 40000, 50000, 100000, 400000 или 800000.
auto_negotiate boolean	Автоматическое согласование параметров передачи с одноранговым интерфейсом. Применимо только к интерфейсам Ethernet. Варианты: `false` `true`
description string	Описание интерфейса.
enabled boolean	Административное состояние интерфейса. Варианты: `false` `true`
fec string	FEC интерфейса (коррекция ошибок при передаче данных). Применимо только к интерфейсам Ethernet. Варианты: `"FEC_RS"` `"FEC_FC"` `"FEC_DISABLED"` `"FEC_DEFAULT"` `"FEC_AUTO"`
mtu integer	MTU интерфейса. Не применимо к интерфейсам Loopback.
name string / обязательный	Имя интерфейса, например ‘Eth1/15’.
speed string	Скорость интерфейса. Применимо только к интерфейсам Ethernet. Поддерживаемые скорости зависят от типа коммутатора. Варианты: `"SPEED_10MB"` `"SPEED_100MB"` `"SPEED_1GB"` `"SPEED_2500MB"` `"SPEED_5GB"` `"SPEED_10GB"` `"SPEED_20GB"` `"SPEED_25GB"` `"SPEED_40GB"` `"SPEED_50GB"` `"SPEED_100GB"` `"SPEED_200GB"` `"SPEED_400GB"` `"SPEED_800GB"`
unreliable_los string	Тип мониторинга, используемый для генерации аварийного сигнала о потере обслуживания. Варианты: `"UNRELIABLE_LOS_MODE_ON"` `"UNRELIABLE_LOS_MODE_OFF"` `"UNRELIABLE_LOS_MODE_AUTO"`
state string	Состояние, в котором должна остаться конфигурация. Варианты: `"merged"` ← (по умолчанию) `"replaced"` `"overridden"` `"deleted"`

Примечания

Примечание

Проверено на Enterprise SONiC Distribution от Dell Technologies.
Поддерживает check_mode.

Примеры

# Using "deleted" state
#
# Before state:
# -------------
#
# show interface status | no-more
# ------------------------------------------------------------------------------------------
# Name                Description         Admin     Oper      AutoNeg     Speed        MTU
# ------------------------------------------------------------------------------------------
# Ethernet0           -                   up                              100000       9100
# Ethernet4           -                   up                              100000       9100
# Ethernet8           Ethernet-8          down                            100000       9100
# Ethernet12          Ethernet-12         down                on          -            5000
# Ethernet16          -                   down                            40000        9100
#
# show running-configuration interface Ethernet 8
# !
# interface Ethernet8
#  mtu 9100
#  speed 100000
#  fec AUTO
#  shutdown
#
- name: Configure interfaces
  sonic_interfaces:
    config:
      - name: Ethernet8
      - name: Ethernet12
      - name: Ethernet16
    state: deleted
#
# After state:
# -------------
#
# show interface status | no-more
# ------------------------------------------------------------------------------------------
# Name                Description         Admin     Oper      AutoNeg     Speed        MTU
# ------------------------------------------------------------------------------------------
# Ethernet0           -                   up                              100000       9100
# Ethernet4           -                   up                              100000       9100
# Ethernet8           -                   up                              100000       9100
# Ethernet12          -                   up                              100000       9100
# Ethernet16          -                   up                              100000       9100
#
# show running-configuration interface Ethernet 8
# !
# interface Ethernet8
#  mtu 9100
#  speed 100000
#  shutdown
#
# Using "deleted" state
#
# Before state:
# -------------
#
# show interface status | no-more
# ------------------------------------------------------------------------------------------
# Name                Description         Admin     Oper      AutoNeg     Speed        MTU
# ------------------------------------------------------------------------------------------
# Ethernet0           -                   up                              100000       9100
# Ethernet4           -                   up                              100000       9100
# Ethernet8           -                   down                            100000       9100
# Ethernet12          -                   down                            1000         9100
# Ethernet16          -                   down                            100000       9100
#
- name: Configure interfaces
  sonic_interfaces:
    config:

    state: deleted
#
# After state:
# -------------
#
# show interface status | no-more
# ------------------------------------------------------------------------------------------
# Name                Description         Admin     Oper      AutoNeg     Speed        MTU
# ------------------------------------------------------------------------------------------
# Ethernet0           -                   up                              100000       9100
# Ethernet4           -                   up                              100000       9100
# Ethernet8           -                   up                              100000       9100
# Ethernet12          -                   up                              100000       9100
# Ethernet16          -                   up                              100000       9100
#
#
#
# Using "merged" state
#
# Before state:
# -------------
#
# show interface status | no-more
# ------------------------------------------------------------------------------------------
# Name                Description         Admin     Oper      AutoNeg     Speed        MTU
# ------------------------------------------------------------------------------------------
# Ethernet0           -                   up                              100000       9100
# Ethernet4           -                   up                              100000       9100
# Ethernet8           -                   down                            100000       9100
# Ethernet12          -                   down                            100000       9100
# Ethernet16          -                   down                            100000       9100
#
# show running-configuration interface Ethernet 8
# !
# interface Ethernet8
#  mtu 9100
#  speed 100000
#  shutdown
#
- name: Configure interfaces
  sonic_interfaces:
    config:
      - name: Ethernet8
        fec: FEC_AUTO
      - name: Ethernet12
        description: 'Ethernet Twelve'
        auto_negotiate: true
      - name: Ethernet16
        description: 'Ethernet Sixteen'
        enabled: true
        mtu: 3500
        speed: SPEED_40GB
    state: merged
#
# After state:
# ------------
#
# show interface status | no-more
# ------------------------------------------------------------------------------------------
# Name                Description         Admin     Oper      AutoNeg     Speed        MTU
# ------------------------------------------------------------------------------------------
# Ethernet0           -                   up                              100000       9100
# Ethernet4           -                   up                              100000       9100
# Ethernet8           -                   down                            100000       9100
# Ethernet12          Ethernet Twelve     down                on          100000       9100
# Ethernet16          Ethernet Sixteen    up                              40000        3500
#
# show running-configuration interface Ethernet 8
# !
# interface Ethernet8
#  mtu 9100
#  speed 100000
#  fec AUTO
#  shutdown
#
# Using "overridden" state
#
# Before state:
# -------------
#
# show interface status | no-more
# ------------------------------------------------------------------------------------------
# Name                Description         Admin     Oper      AutoNeg     Speed        MTU
# ------------------------------------------------------------------------------------------
# Ethernet0           E0                  up                              100000       9100
# Ethernet4           E4                  up                              100000       9100
# Ethernet8           E8                  down                            100000       9100
# Ethernet12          -                   down                            1000         9100
# Ethernet16          -                   down                            100000       9100
#
# show running-configuration interface Ethernet 8
# !
# interface Ethernet8
#  mtu 9100
#  speed 100000
#  shutdown
#
- name: Configure interfaces
  sonic_interfaces:
    config:
      - name: Ethernet8
        fec: FEC_AUTO
      - name: Ethernet12
        description: 'Ethernet Twelve'
        mtu: 3500
        enabled: true
        auto_negotiate: true
      - name: Ethernet16
        description: 'Ethernet Sixteen'
        mtu: 3000
        enabled: false
        speed: SPEED_40GB
    state: overridden
#
# After state:
# ------------
#
# show interface status | no-more
# ------------------------------------------------------------------------------------------
# Name                Description         Admin     Oper      AutoNeg     Speed        MTU
# ------------------------------------------------------------------------------------------
# Ethernet0           -                   down                            100000       9100
# Ethernet4           -                   down                            100000       9100
# Ethernet8           -                   down                            100000       9100
# Ethernet12          Ethernet Twelve     up                  on          100000       3500
# Ethernet16          Ethernet Sixteen    down                            40000        3000
#
# show running-configuration interface Ethernet 8
# !
# interface Ethernet8
#  mtu 9100
#  speed 100000
#  fec AUTO
#  no shutdown
#
# Using "replaced" state
#
# Before state:
# -------------
#
# show interface status | no-more
# ------------------------------------------------------------------------------------------
# Name                Description         Admin     Oper      AutoNeg     Speed        MTU
# ------------------------------------------------------------------------------------------
# Ethernet0           -                   up                              100000       9100
# Ethernet4           -                   up                              100000       9100
# Ethernet8           -                   down               on           100000       9100
# Ethernet12          -                   down                            1000         9100
# Ethernet16          -                   down                            100000       9100
#
# show running-configuration interface Ethernet 8
# !
# interface Ethernet8
#  mtu 9100
#  speed auto 40000
#  shutdown
#
- name: Configure interfaces
  sonic_interfaces:
    config:
      - name: Ethernet8
        auto_negotiate: true
        advertised_speed:
          - "100000"
      - name: Ethernet12
        description: 'Ethernet Twelve'
        mtu: 3500
        enabled: true
        auto_negotiate: true
      - name: Ethernet16
        description: 'Ethernet Sixteen'
        mtu: 3000
        enabled: false
        speed: SPEED_40GB
    state: replaced
#
# After state:
# ------------
#
# show interface status | no-more
# ------------------------------------------------------------------------------------------
# Name                Description         Admin     Oper      AutoNeg     Speed        MTU
# ------------------------------------------------------------------------------------------
# Ethernet0           -                   up                              100000       9100
# Ethernet4           -                   up                              100000       9100
# Ethernet8           -                   down                on          100000       9100
# Ethernet12          Ethernet Twelve     up                  on          100000       3500
# Ethernet16          Ethernet Sixteen    down                            40000        3000
#
# show running-configuration interface Ethernet 8
# !
# interface Ethernet8
#  mtu 9100
#  speed auto 100000
#  fec AUTO
#  shutdown
#

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

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

Ключ	Описание
after list / elements=string	Результирующая конфигурация после вызова модуля. Возвращается: при изменении Пример: `["The configuration returned is always in the same format as the parameters above.\n"]`
before list / elements=string	Конфигурация до вызова модуля. Возвращается: всегда Пример: `["The configuration returned is always in the same format as the parameters above.\n"]`
commands list / elements=string	Набор команд, отправленных на удалённое устройство. Возвращается: всегда Пример: `["command 1", "command 2", "command 3"]`

Авторы

Niraimadaiselvam M(@niraimadaiselvamm)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/dellemc/enterprise_sonic/sonic_interfaces_module.html