New in version 2.3.
Parameter |
Choices/Defaults |
Comments |
|---|---|---|
|
abort
|
Default:
no
|
Boolean. When true, perform a 'net abort' before the block. This cleans out any uncommitted changes in the buffer. Mutually exclusive with atomic.
|
|
atomic
|
Default:
no
|
When true, equivalent to both commit and abort being true. Mutually exclusive with commit and atomic.
|
|
commands
|
|
A list of strings containing the net commands to run. Mutually exclusive with template.
|
|
commit
|
Default:
no
|
When true, performs a 'net commit' at the end of the block. Mutually exclusive with atomic.
|
|
description
|
Default:
Ansible-originated commit
|
Commit description that will be recorded to the commit log if commit or atomic are true.
|
|
template
|
|
A single, multi-line string with jinja2 formatting. This string will be broken by lines, and each line will be run through net. Mutually exclusive with commands.
|
- name: Add two interfaces without committing any changes
nclu:
commands:
- add int swp1
- add int swp2
- name: Add 48 interfaces and commit the change.
nclu:
template: |
{% for iface in range(1,49) %}
add int swp{{iface}}
{% endfor %}
commit: true
description: "Ansible - add swps1-48"
- name: Atomically add an interface
nclu:
commands:
- add int swp1
atomic: true
description: "Ansible - add swp1"
Common return values are documented here, the following are the fields unique to this module:
Key |
Returned |
Description |
|---|---|---|
|
changed
bool
|
changed |
whether the interface was changed
Sample:
True
|
|
msg
string
|
always |
human-readable report of success or failure
Sample:
interface bond0 config updated
|
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Hint
If you notice any issues in this documentation you can edit this document to improve it.