ansible.builtin.junos_linkagg (v2.4.0.0-1) — module

Install Ansible via pip

Install with pip install ansible==2.4.0.0.post1

Description

This module provides declarative management of link aggregation groups on Juniper JUNOS network devices.

Requirements

• ncclient (>=v0.5.2)

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: configure link aggregation
  junos_linkagg:
    name: ae11
    members:
      - ge-0/0/5
      - ge-0/0/6
      - ge-0/0/7
    lacp: active
    device_count: 4
    state: present

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: delete link aggregation
  junos_linkagg:
    name: ae11
    members:
      - ge-0/0/5
      - ge-0/0/6
      - ge-0/0/7
    lacp: active
    device_count: 4
    state: delete

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: deactivate link aggregation
  junos_linkagg:
    name: ae11
    members:
      - ge-0/0/5
      - ge-0/0/6
      - ge-0/0/7
    lacp: active
    device_count: 4
    state: present
    active: False

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Activate link aggregation
  junos_linkagg:
    name: ae11
    members:
      - ge-0/0/5
      - ge-0/0/6
      - ge-0/0/7
    lacp: active
    device_count: 4
    state: present
    active: True

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Disable link aggregation
  junos_linkagg:
    name: ae11
    state: down

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Enable link aggregation
  junos_linkagg:
    name: ae11
    state: up

Inputs

    
mode:
    choices:
    - 'on'
    - 'off'
    - active
    - passive
    default: false
    description:
    - Mode of the link aggregation group. A value of C(on) will enable LACP in C(passive)
      mode. C(active) configures the link to actively information about the state of the
      link, or it can be configured in C(passive) mode ie. send link state information
      only when received them from another link. A value of C(off) will disable LACP.

name:
    description:
    - Name of the link aggregation group.
    required: true

state:
    choices:
    - present
    - absent
    - up
    - down
    default: present
    description:
    - State of the link aggregation group.

active:
    choices:
    - true
    - false
    default: true
    description:
    - Specifies whether or not the configuration is active or deactivated

members:
    description:
    - List of members interfaces of the link aggregation group. The value can be single
      interface or list of interfaces.
    required: true

aggregate:
    description: List of link aggregation definitions.

min_links:
    description:
    - Minimum members that should be up before bringing up the link aggregation group.

description:
    description:
    - Description of Interface.

device_count:
    description:
    - Number of aggregated ethernet devices that can be configured. Acceptable integer
      value is between 1 and 128.

Outputs

diff:
  description: Configuration difference before and after applying change.
  returned: when configuration is changed and diff option is enabled.
  sample: '[edit interfaces] +   ge-0/0/6 { +       ether-options { +           802.3ad
    ae0; +       } +   } [edit interfaces ge-0/0/7] +   ether-options { +       802.3ad
    ae0; +   } [edit interfaces] +   ae0 { +       description "configured by junos_linkagg";
    +       aggregated-ether-options { +           lacp { +               active;
    +           } +       } +   }

    '
  type: string