community.network.icx_interface – Manage Interface on Ruckus ICX 7000 series switches

From Get docs
Ansible/docs/2.11/collections/community/network/icx interface module


community.network.icx_interface – Manage Interface on Ruckus ICX 7000 series switches

Note

This plugin is part of the community.network collection (version 2.0.1).

To install it use: ansible-galaxy collection install community.network.

To use it in a playbook, specify: community.network.icx_interface.


Synopsis

  • This module provides declarative management of Interfaces on ruckus icx devices.

Parameters

Parameter Choices/Defaults Comments

aggregate

list / elements=string

List of Interfaces definitions.

check_running_config

boolean

  • no
  • yes

Check running configuration. This can be set as environment variable.

Module will use environment variable value(default:True), unless it is overridden, by specifying it as module parameter.

delay

integer

Time in seconds to wait before checking for the operational state on remote device. This wait is applicable for operational state argument which are state with values up/down, tx_rate and rx_rate.

description

string

Name of the description.

enabled

boolean

  • no
  • yes

Interface link status

name

string

Name of the Interface.

neighbors

list / elements=string

Check the operational state of given interface name for CDP/LLDP neighbor.

The following suboptions are available.

host

string

CDP/LLDP neighbor host for given interface name.

port

string

CDP/LLDP neighbor port to which given interface name is connected.

power

dictionary

Inline power on Power over Ethernet (PoE) ports.

by_class

string

  • 0
  • 1
  • 2
  • 3
  • 4

The range is 0-4

The power limit based on class value for given interface name

enabled

boolean

  • no
  • yes

enable/disable the poe of the given interface name

limit

string

The range is 1000-15400|30000mW. For PoH ports the range is 1000-95000mW

The power limit based on actual power value for given interface name

priority

string

  • 1
  • 2
  • 3

The range is 1 (highest) to 3 (lowest)

The priority for power management or given interface name

rx_rate

string

Receiver rate in bits per second (bps).

This is state check parameter only.

Supports conditionals, see Conditionals in Networking Modules

speed

string

  • 10-full
  • 10-half
  • 100-full
  • 100-half
  • 1000-full
  • 1000-full-master
  • 1000-full-slave
  • 10g-full
  • 10g-full-master
  • 10g-full-slave
  • 2500-full
  • 2500-full-master
  • 2500-full-slave
  • 5g-full
  • 5g-full-master
  • 5g-full-slave
  • auto

Interface link speed/duplex

state

string

  • present
  • absent
  • up
  • down

State of the Interface configuration, up means present and operationally up and down means present and operationally down

stp

boolean

  • no
  • yes

enable/disable stp for the interface

tx_rate

string

Transmit rate in bits per second (bps).

This is state check parameter only.

Supports conditionals, see Conditionals in Networking Modules

check_running_config

boolean

  • no
  • yes

Check running configuration. This can be set as environment variable.

Module will use environment variable value(default:True), unless it is overridden, by specifying it as module parameter.

delay

integer

Default:

10

Time in seconds to wait before checking for the operational state on remote device. This wait is applicable for operational state argument which are state with values up/down, tx_rate and rx_rate.

description

string

Name of the description.

enabled

boolean

  • no
  • yes

Interface link status

name

string

Name of the Interface.

neighbors

list / elements=string

Check the operational state of given interface name for CDP/LLDP neighbor.

The following suboptions are available.

host

string

CDP/LLDP neighbor host for given interface name.

port

string

CDP/LLDP neighbor port to which given interface name is connected.

power

dictionary

Inline power on Power over Ethernet (PoE) ports.

by_class

string

  • 0
  • 1
  • 2
  • 3
  • 4

The range is 0-4

The power limit based on class value for given interface name

enabled

boolean

  • no
  • yes

enable/disable the poe of the given interface name

Default is false.

limit

string

The range is 1000-15400|30000mW. For PoH ports the range is 1000-95000mW

The power limit based on actual power value for given interface name

priority

string

  • 1
  • 2
  • 3

The range is 1 (highest) to 3 (lowest)

The priority for power management or given interface name

rx_rate

string

Receiver rate in bits per second (bps).

This is state check parameter only.

Supports conditionals, see Conditionals in Networking Modules

speed

string

  • 10-full
  • 10-half
  • 100-full
  • 100-half
  • 1000-full
  • 1000-full-master
  • 1000-full-slave
  • 10g-full
  • 10g-full-master
  • 10g-full-slave
  • 2500-full
  • 2500-full-master
  • 2500-full-slave
  • 5g-full
  • 5g-full-master
  • 5g-full-slave
  • auto

Interface link speed/duplex

state

string

  • present

  • absent
  • up
  • down

State of the Interface configuration, up means present and operationally up and down means present and operationally down

stp

boolean

  • no
  • yes

enable/disable stp for the interface

tx_rate

string

Transmit rate in bits per second (bps).

This is state check parameter only.

Supports conditionals, see Conditionals in Networking Modules



Notes

Note


Examples

- name: Enable ethernet port and set name
  community.network.icx_interface:
    name: ethernet 1/1/1
    description: interface-1
    stp: true
    enabled: true

- name: Disable ethernet port 1/1/1
  community.network.icx_interface:
      name: ethernet 1/1/1
      enabled: false

- name: Enable ethernet port range, set name and speed
  community.network.icx_interface:
      name: ethernet 1/1/1 to 1/1/10
      description: interface-1
      speed: 100-full
      enabled: true

- name: Enable poe. Set class
  community.network.icx_interface:
      name: ethernet 1/1/1
      power:
       by_class: 2

- name: Configure poe limit of interface
  community.network.icx_interface:
      name: ethernet 1/1/1
      power:
       limit: 10000

- name: Disable poe of interface
  community.network.icx_interface:
      name: ethernet 1/1/1
      power:
       enabled: false

- name: Set lag name for a range of lags
  community.network.icx_interface:
      name: lag 1 to 10
      description: test lags

- name: Disable lag
  community.network.icx_interface:
      name: lag 1
      enabled: false

- name: Enable management interface
  community.network.icx_interface:
      name: management 1
      enabled: true

- name: Enable loopback interface
  community.network.icx_interface:
      name: loopback 10
      enabled: true

- name: Add interface using aggregate
  community.network.icx_interface:
      aggregate:
      - { name: ethernet 1/1/1, description: test-interface-1, power: { by_class: 2 } }
      - { name: ethernet 1/1/3, description: test-interface-3}
      speed: 10-full
      enabled: true

- name: Check tx_rate, rx_rate intent arguments
  community.network.icx_interface:
    name: ethernet 1/1/10
    state: up
    tx_rate: ge(0)
    rx_rate: le(0)

- name: Check neighbors intent arguments
  community.network.icx_interface:
    name: ethernet 1/1/10
    neighbors:
    - port: 1/1/5
      host: netdev

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description

commands

list / elements=string

always

The list of configuration mode commands to send to the device.


Sample:

['interface ethernet 1/1/1', 'port-name interface-1', 'state present', 'speed-duplex 100-full', 'inline power priority 1']




Authors

  • Ruckus Wireless (@Commscope)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/icx_interface_module.html