community.network.cnos_interface 模块 – 管理 Lenovo CNOS 网络设备上的接口

注意

此模块是 community.network 集合(版本 5.1.0)的一部分。

如果您使用的是 ansible 包,则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用:ansible-galaxy collection install community.network

要在 playbook 中使用它,请指定:community.network.cnos_interface

注意

community.network 集合已被弃用,并将从 Ansible 12 中删除。有关更多信息,请参阅讨论主题

已弃用

已移除版本:

版本 6.0.0

原因:

此集合及其中的所有内容均未维护且已弃用。

替代方案:

未知。

概要

  • 此模块提供对 Lenovo CNOS 网络设备上的接口的声明式管理。

别名: network.cnos.cnos_interface

参数

参数

注释

aggregate

字符串

接口定义列表。

delay

字符串

等待指定时间(以秒为单位),然后再检查远程设备上的操作状态。此等待适用于具有值 up/downtx_raterx_ratestate 操作状态参数

默认值: 20

description

字符串

接口的描述。

duplex

字符串

接口链路状态

选项

  • "full"

  • "half"

  • "auto" ←(默认)

enabled

布尔值

接口链路状态。

选项

  • false

  • true ←(默认)

mtu

字符串

传输数据包的最大大小。

name

字符串 / 必需

接口的名称。

neighbors

字符串

检查给定接口 name 的 LLDP 邻居的操作状态。

提供以下子选项。

host

字符串

给定接口 name 的 LLDP 邻居主机。

port

字符串

接口 name 连接到的 LLDP 邻居端口。

rx_rate

字符串

接收速率,以比特/秒 (bps) 为单位。

这只是状态检查参数。

支持条件语句,请参阅网络模块中的条件语句

speed

字符串

接口链路速度。

state

字符串

接口配置的状态,up 表示存在并且在操作上处于启用状态,down 表示存在并且在操作上处于禁用状态

选项

  • "present" ←(默认)

  • "absent"

  • "up"

  • "down"

tx_rate

字符串

传输速率,以比特/秒 (bps) 为单位。

这只是状态检查参数。

支持条件语句,请参阅网络模块中的条件语句

说明

注意

  • 已针对 CNOS 10.8.1 进行测试

示例

- name: Configure interface
  community.network.cnos_interface:
      name: Ethernet1/33
      description: test-interface
      speed: 100
      duplex: half
      mtu: 999

- name: Remove interface
  community.network.cnos_interface:
    name: loopback3
    state: absent

- name: Make interface up
  community.network.cnos_interface:
    name: Ethernet1/33
    enabled: true

- name: Make interface down
  community.network.cnos_interface:
    name: Ethernet1/33
    enabled: false

- name: Check intent arguments
  community.network.cnos_interface:
    name: Ethernet1/33
    state: up
    tx_rate: ge(0)
    rx_rate: le(0)

- name: Check neighbors intent arguments
  community.network.cnos_interface:
    name: Ethernet1/33
    neighbors:
    - port: eth0
      host: netdev

- name: Config + intent
  community.network.cnos_interface:
    name: Ethernet1/33
    enabled: false
    state: down

- name: Add interface using aggregate
  community.network.cnos_interface:
    aggregate:
    - { name: Ethernet1/33, mtu: 256, description: test-interface-1 }
    - { name: Ethernet1/44, mtu: 516, description: test-interface-2 }
    duplex: full
    speed: 100
    state: present

- name: Delete interface using aggregate
  community.network.cnos_interface:
    aggregate:
    - name: loopback3
    - name: loopback6
    state: absent

返回值

通用返回值记录在此处,以下是此模块独有的字段

描述

commands

列表 / 元素=字符串

要发送到设备的配置模式命令列表。

返回: 始终返回,但使用 Netconf 传输来管理设备的平台除外。

示例: ["interface Ethernet1/33", "description test-interface", "duplex half", "mtu 512"]

状态

  • 此模块将在 6.0.0 版本中移除。[已弃用]

  • 有关更多信息,请参阅已弃用

作者

  • Anil Kumar Muraleedharan(@amuraleedhar)