/ home / f5networks / f5networks.f5os / 1.7.0 / module / f5os_lag

f5networks.f5os.f5os_lag (1.7.0) — module

Manage LAG interfaces on F5OS based systems

| "added in version" 1.0.0 of f5networks.f5os"

Authors: Ravinder Reddy (@chinthalapalli), Wojciech Wypior (@wojtek0806)

Install collection

Install with ansible-galaxy collection install f5networks.f5os:==1.7.0

Add to requirements.yml

  collections:
    - name: f5networks.f5os
      version: 1.7.0

Description

Manage LAG interfaces on F5OS systems like VELOS partitions or rSeries platforms.

Usage examples

Scanned by Steampunk Spotter

- name: Creating VLAN444
  f5os_vlan:
    name: vlan-444
    vlan_id: 444

Scanned by Steampunk Spotter

- name: Creating VLAN555
  f5os_vlan:
    name: vlan-555
    vlan_id: 555

Scanned by Steampunk Spotter

- name: Attach Trunk-vlans to LAG to interface
  f5os_lag:
    name: "Arista"
    lag_type: "lacp"
    trunk_vlans: [444]
    state: present

Scanned by Steampunk Spotter

- name: Modify Vlans to LAG interface
  f5os_lag:
    name: "Arista"
    trunk_vlans: [444, 555]
    state: present

Scanned by Steampunk Spotter

- name: Add interfaces to LAG on Velos Partition
  f5os_lag:
    name: "Arista"
    config_members:
      - "1/1.0"
    state: present

Scanned by Steampunk Spotter

- name: Add interfaces to LAG on rSeries Platform
  f5os_lag:
    name: "Arista"
    config_members:
      - "1.0"
    state: present

Scanned by Steampunk Spotter

- name: Delete LAG interface
  f5os_lag:
    name: "Arista"
    trunk_vlans: [444, 555]
    state: absent

Inputs

    
mode:
    choices:
    - active
    - passive
    description:
    - The LACP mode of the interface to be created.
    - This parameter is useful only when C(lag_type) is set to C(lacp).
    type: str
    version_added: 1.6.0
    version_added_collection: f5networks.f5os

name:
    description:
    - Name of the interface to configure.
    required: true
    type: str

state:
    choices:
    - present
    - absent
    default: present
    description:
    - If C(present), creates the specified object if it does not exist, or updates the
      existing object.
    - If C(absent), deletes the object if it exists.
    type: str

interval:
    choices:
    - slow
    - fast
    description:
    - The LACP interval of the interface to be created.
    - This parameter is useful only when C(lag_type) is set to C(lacp).
    type: str
    version_added: 1.6.0
    version_added_collection: f5networks.f5os

lag_type:
    choices:
    - lacp
    - static
    description:
    - The LAG type of the interface to be created.
    - Parameter is required when creating new LAG interface.
    type: str

native_vlan:
    description:
    - Configures the VLAN ID to associate with the Link Aggregation Group.
    - The C(native_vlans) parameter is used for untagged traffic.
    type: int

trunk_vlans:
    description:
    - Configures multiple VLAN IDs to associate with the Link Aggregation Group.
    - The C(trunk_vlans) parameter is used for tagged traffic.
    - The order of these VLANs is ignored, the module orders the VLANs automatically.
    elements: int
    type: list

config_members:
    description:
    - Configures the list of interfaces to be grouped for the Link Aggregation Group (LAG).
    - For VELOS partitions blade/port interface format is required e.g. 1/1.0
    elements: str
    type: list

Outputs

config_members:
  description: The list of interfaces to be grouped for the Link Aggregation Group
  returned: changed
  sample:
  - '1.0'
  - '2.0'
  type: list
lag_type:
  description: The LAG type of the interface to be created.
  returned: changed
  sample: static
  type: str
name:
  description: Name of the partition LAG interface to configure
  returned: changed
  sample: new_name
  type: str
native_vlan:
  description: Native VLAN to attach to LAG interface
  returned: changed
  sample: 222
  type: int
trunk_vlans:
  description: Trunk VLANs to attach to LAG interface
  returned: changed
  sample:
  - 444
  - 555
  type: list