summaryrefslogtreecommitdiff
path: root/docs/vyos.vyos.vyos_lag_interfaces_module.rst
diff options
context:
space:
mode:
authorGomathiselviS <gomathiselvi@gmail.com>2020-08-27 14:58:25 -0400
committerGitHub <noreply@github.com>2020-08-27 18:58:25 +0000
commita45e2988263f5109a56b6dcb2c46ecbc6738cb3a (patch)
tree1296e669b99a12a18ac5ce37bf72cdbb19c1a4d5 /docs/vyos.vyos.vyos_lag_interfaces_module.rst
parent1ae2bbffe70e5217536a05250365a4f44292c8ec (diff)
downloadvyos.vyos-a45e2988263f5109a56b6dcb2c46ecbc6738cb3a.tar.gz
vyos.vyos-a45e2988263f5109a56b6dcb2c46ecbc6738cb3a.zip
Release 1.0.4 (#81)1.0.4
Release 1.0.4 Reviewed-by: https://github.com/apps/ansible-zuul
Diffstat (limited to 'docs/vyos.vyos.vyos_lag_interfaces_module.rst')
-rw-r--r--docs/vyos.vyos.vyos_lag_interfaces_module.rst366
1 files changed, 182 insertions, 184 deletions
diff --git a/docs/vyos.vyos.vyos_lag_interfaces_module.rst b/docs/vyos.vyos.vyos_lag_interfaces_module.rst
index b09a846c..153e20e2 100644
--- a/docs/vyos.vyos.vyos_lag_interfaces_module.rst
+++ b/docs/vyos.vyos.vyos_lag_interfaces_module.rst
@@ -31,229 +31,233 @@ Parameters
<tr>
<th colspan="3">Parameter</th>
<th>Choices/<font color="blue">Defaults</font></th>
- <th width="100%">Comments</th>
+ <th width="100%">Comments</th>
</tr>
- <tr>
- <td colspan="3">
+ <tr>
+ <td colspan="3">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>config</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">list</span>
- / <span style="color: purple">elements=dictionary</span> </div>
- </td>
- <td>
- </td>
- <td>
- <div>A list of link aggregation group configurations.</div>
- </td>
+ / <span style="color: purple">elements=dictionary</span>
+ </div>
+ </td>
+ <td>
+ </td>
+ <td>
+ <div>A list of link aggregation group configurations.</div>
+ </td>
</tr>
- <tr>
- <td class="elbow-placeholder"></td>
- <td colspan="2">
+ <tr>
+ <td class="elbow-placeholder"></td>
+ <td colspan="2">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>arp_monitor</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">dictionary</span>
- </div>
- </td>
- <td>
- </td>
- <td>
- <div>ARP Link monitoring parameters.</div>
- </td>
+ </div>
+ </td>
+ <td>
+ </td>
+ <td>
+ <div>ARP Link monitoring parameters.</div>
+ </td>
</tr>
- <tr>
- <td class="elbow-placeholder"></td>
- <td class="elbow-placeholder"></td>
- <td colspan="1">
+ <tr>
+ <td class="elbow-placeholder"></td>
+ <td class="elbow-placeholder"></td>
+ <td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>interval</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">integer</span>
- </div>
- </td>
- <td>
- </td>
- <td>
- <div>ARP link monitoring frequency in milliseconds.</div>
- </td>
+ </div>
+ </td>
+ <td>
+ </td>
+ <td>
+ <div>ARP link monitoring frequency in milliseconds.</div>
+ </td>
</tr>
- <tr>
- <td class="elbow-placeholder"></td>
- <td class="elbow-placeholder"></td>
- <td colspan="1">
+ <tr>
+ <td class="elbow-placeholder"></td>
+ <td class="elbow-placeholder"></td>
+ <td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>target</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">list</span>
- / <span style="color: purple">elements=string</span> </div>
- </td>
- <td>
- </td>
- <td>
- <div>IP address to use for ARP monitoring.</div>
- </td>
+ / <span style="color: purple">elements=string</span>
+ </div>
+ </td>
+ <td>
+ </td>
+ <td>
+ <div>IP address to use for ARP monitoring.</div>
+ </td>
</tr>
-
- <tr>
- <td class="elbow-placeholder"></td>
- <td colspan="2">
+
+ <tr>
+ <td class="elbow-placeholder"></td>
+ <td colspan="2">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>hash_policy</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
- </div>
- </td>
- <td>
- <ul style="margin: 0; padding: 0"><b>Choices:</b>
- <li>layer2</li>
- <li>layer2+3</li>
- <li>layer3+4</li>
- </ul>
- </td>
- <td>
- <div>LAG or bonding transmit hash policy.</div>
- </td>
+ </div>
+ </td>
+ <td>
+ <ul style="margin: 0; padding: 0"><b>Choices:</b>
+ <li>layer2</li>
+ <li>layer2+3</li>
+ <li>layer3+4</li>
+ </ul>
+ </td>
+ <td>
+ <div>LAG or bonding transmit hash policy.</div>
+ </td>
</tr>
- <tr>
- <td class="elbow-placeholder"></td>
- <td colspan="2">
+ <tr>
+ <td class="elbow-placeholder"></td>
+ <td colspan="2">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>members</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">list</span>
- / <span style="color: purple">elements=dictionary</span> </div>
- </td>
- <td>
- </td>
- <td>
- <div>List of member interfaces for the LAG (bond).</div>
- </td>
+ / <span style="color: purple">elements=dictionary</span>
+ </div>
+ </td>
+ <td>
+ </td>
+ <td>
+ <div>List of member interfaces for the LAG (bond).</div>
+ </td>
</tr>
- <tr>
- <td class="elbow-placeholder"></td>
- <td class="elbow-placeholder"></td>
- <td colspan="1">
+ <tr>
+ <td class="elbow-placeholder"></td>
+ <td class="elbow-placeholder"></td>
+ <td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>member</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
- </div>
- </td>
- <td>
- </td>
- <td>
- <div>Name of the member interface.</div>
- </td>
+ </div>
+ </td>
+ <td>
+ </td>
+ <td>
+ <div>Name of the member interface.</div>
+ </td>
</tr>
-
- <tr>
- <td class="elbow-placeholder"></td>
- <td colspan="2">
+
+ <tr>
+ <td class="elbow-placeholder"></td>
+ <td colspan="2">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>mode</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
- </div>
- </td>
- <td>
- <ul style="margin: 0; padding: 0"><b>Choices:</b>
- <li>802.3ad</li>
- <li>active-backup</li>
- <li>broadcast</li>
- <li>round-robin</li>
- <li>transmit-load-balance</li>
- <li>adaptive-load-balance</li>
- <li>xor-hash</li>
- </ul>
- </td>
- <td>
- <div>LAG or bond mode.</div>
- </td>
+ </div>
+ </td>
+ <td>
+ <ul style="margin: 0; padding: 0"><b>Choices:</b>
+ <li>802.3ad</li>
+ <li>active-backup</li>
+ <li>broadcast</li>
+ <li>round-robin</li>
+ <li>transmit-load-balance</li>
+ <li>adaptive-load-balance</li>
+ <li>xor-hash</li>
+ </ul>
+ </td>
+ <td>
+ <div>LAG or bond mode.</div>
+ </td>
</tr>
- <tr>
- <td class="elbow-placeholder"></td>
- <td colspan="2">
+ <tr>
+ <td class="elbow-placeholder"></td>
+ <td colspan="2">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>name</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
- / <span style="color: red">required</span> </div>
- </td>
- <td>
- </td>
- <td>
- <div>Name of the link aggregation group (LAG) or bond.</div>
- </td>
+ / <span style="color: red">required</span>
+ </div>
+ </td>
+ <td>
+ </td>
+ <td>
+ <div>Name of the link aggregation group (LAG) or bond.</div>
+ </td>
</tr>
- <tr>
- <td class="elbow-placeholder"></td>
- <td colspan="2">
+ <tr>
+ <td class="elbow-placeholder"></td>
+ <td colspan="2">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>primary</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
- </div>
- </td>
- <td>
- </td>
- <td>
- <div>Primary device interfaces for the LAG (bond).</div>
- </td>
+ </div>
+ </td>
+ <td>
+ </td>
+ <td>
+ <div>Primary device interfaces for the LAG (bond).</div>
+ </td>
</tr>
-
- <tr>
- <td colspan="3">
+
+ <tr>
+ <td colspan="3">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>running_config</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
- </div>
- </td>
- <td>
- </td>
- <td>
- <div>This option is used only with state <em>parsed</em>.</div>
- <div>The value of this option should be the output received from the VyOS device by executing the command <b>show configuration commands | grep bond</b>.</div>
- <div>The state <em>parsed</em> reads the configuration from <code>running_config</code> option and transforms it into Ansible structured data as per the resource module&#x27;s argspec and the value is then returned in the <em>parsed</em> key within the result.</div>
- </td>
+ </div>
+ </td>
+ <td>
+ </td>
+ <td>
+ <div>This option is used only with state <em>parsed</em>.</div>
+ <div>The value of this option should be the output received from the VyOS device by executing the command <b>show configuration commands | grep bond</b>.</div>
+ <div>The state <em>parsed</em> reads the configuration from <code>running_config</code> option and transforms it into Ansible structured data as per the resource module&#x27;s argspec and the value is then returned in the <em>parsed</em> key within the result.</div>
+ </td>
</tr>
- <tr>
- <td colspan="3">
+ <tr>
+ <td colspan="3">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>state</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
- </div>
- </td>
- <td>
- <ul style="margin: 0; padding: 0"><b>Choices:</b>
- <li><div style="color: blue"><b>merged</b>&nbsp;&larr;</div></li>
- <li>replaced</li>
- <li>overridden</li>
- <li>deleted</li>
- <li>parsed</li>
- <li>gathered</li>
- <li>rendered</li>
- </ul>
- </td>
- <td>
- <div>The state of the configuration after module completion.</div>
- </td>
+ </div>
+ </td>
+ <td>
+ <ul style="margin: 0; padding: 0"><b>Choices:</b>
+ <li><div style="color: blue"><b>merged</b>&nbsp;&larr;</div></li>
+ <li>replaced</li>
+ <li>overridden</li>
+ <li>deleted</li>
+ <li>parsed</li>
+ <li>gathered</li>
+ <li>rendered</li>
+ </ul>
+ </td>
+ <td>
+ <div>The state of the configuration after module completion.</div>
+ </td>
</tr>
- </table>
+ </table>
<br/>
@@ -271,7 +275,6 @@ Examples
.. code-block:: yaml+jinja
-
# Using merged
#
# Before state:
@@ -865,9 +868,6 @@ Examples
-
-
-
Return Values
-------------
Common return values are documented `here <https://docs.ansible.com/ansible/latest/reference_appendices/common_return_values.html#common-return-values>`_, the following are the fields unique to this module:
@@ -880,60 +880,60 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late
<th>Returned</th>
<th width="100%">Description</th>
</tr>
- <tr>
- <td colspan="1">
+ <tr>
+ <td colspan="1">
<div class="ansibleOptionAnchor" id="return-"></div>
<b>after</b>
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
<div style="font-size: small">
<span style="color: purple">list</span>
- </div>
- </td>
+ </div>
+ </td>
<td>when changed</td>
<td>
- <div>The configuration as structured data after module completion.</div>
- <br/>
- <div style="font-size: smaller"><b>Sample:</b></div>
- <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">The configuration returned will always be in the same format
+ <div>The configuration as structured data after module completion.</div>
+ <br/>
+ <div style="font-size: smaller"><b>Sample:</b></div>
+ <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">The configuration returned will always be in the same format
of the parameters above.</div>
- </td>
+ </td>
</tr>
- <tr>
- <td colspan="1">
+ <tr>
+ <td colspan="1">
<div class="ansibleOptionAnchor" id="return-"></div>
<b>before</b>
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
<div style="font-size: small">
<span style="color: purple">list</span>
- </div>
- </td>
+ </div>
+ </td>
<td>always</td>
<td>
- <div>The configuration as structured data prior to module invocation.</div>
- <br/>
- <div style="font-size: smaller"><b>Sample:</b></div>
- <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">The configuration returned will always be in the same format
+ <div>The configuration as structured data prior to module invocation.</div>
+ <br/>
+ <div style="font-size: smaller"><b>Sample:</b></div>
+ <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">The configuration returned will always be in the same format
of the parameters above.</div>
- </td>
+ </td>
</tr>
- <tr>
- <td colspan="1">
+ <tr>
+ <td colspan="1">
<div class="ansibleOptionAnchor" id="return-"></div>
<b>commands</b>
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
<div style="font-size: small">
<span style="color: purple">list</span>
- </div>
- </td>
+ </div>
+ </td>
<td>always</td>
<td>
- <div>The set of commands pushed to the remote device.</div>
- <br/>
- <div style="font-size: smaller"><b>Sample:</b></div>
- <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">[&#x27;set interfaces bonding bond2&#x27;, &#x27;set interfaces bonding bond2 hash-policy layer2&#x27;]</div>
- </td>
+ <div>The set of commands pushed to the remote device.</div>
+ <br/>
+ <div style="font-size: smaller"><b>Sample:</b></div>
+ <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">[&#x27;set interfaces bonding bond2&#x27;, &#x27;set interfaces bonding bond2 hash-policy layer2&#x27;]</div>
+ </td>
</tr>
- </table>
+ </table>
<br/><br/>
@@ -945,5 +945,3 @@ Authors
~~~~~~~
- Rohit Thakur (@rohitthakur2590)
-
-