diff options
| author | omnom62 <omnom62@outlook.com> | 2026-06-02 21:36:02 +1000 |
|---|---|---|
| committer | omnom62 <omnom62@outlook.com> | 2026-06-02 21:36:02 +1000 |
| commit | b5e17eb5e9239cf45a51d39f2a7a9726aa8f4fbb (patch) | |
| tree | 7257199ec240eadfff27bb5e8a5d00fa0aed9747 /docs | |
| parent | 066ab3c5795cfc30337831708da1a73a449f404f (diff) | |
| download | rest.vyos-b5e17eb5e9239cf45a51d39f2a7a9726aa8f4fbb.tar.gz rest.vyos-b5e17eb5e9239cf45a51d39f2a7a9726aa8f4fbb.zip | |
lldp_global module
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/vyos.rest.vyos_lldp_global_module.rst | 45 |
1 files changed, 40 insertions, 5 deletions
diff --git a/docs/vyos.rest.vyos_lldp_global_module.rst b/docs/vyos.rest.vyos_lldp_global_module.rst index 0f24668..9016792 100644 --- a/docs/vyos.rest.vyos_lldp_global_module.rst +++ b/docs/vyos.rest.vyos_lldp_global_module.rst @@ -18,6 +18,7 @@ Version added: 1.0.0 Synopsis -------- - Manage LLDP global configuration on VyOS via REST API. +- Uses ``ansible_connection=ansible.netcommon.httpapi``. @@ -45,6 +46,7 @@ Parameters <td> </td> <td> + <div>LLDP global configuration.</div> </td> </tr> <tr> @@ -61,6 +63,7 @@ Parameters <td> </td> <td> + <div>List of management addresses to advertise.</div> </td> </tr> <tr> @@ -80,6 +83,7 @@ Parameters </ul> </td> <td> + <div>Enable LLDP service.</div> </td> </tr> <tr> @@ -102,6 +106,7 @@ Parameters </ul> </td> <td> + <div>Legacy protocols to support.</div> </td> </tr> <tr> @@ -117,7 +122,9 @@ Parameters <td> </td> <td> - <div><code>enable</code> or <code>disable</code>.</div> + <div><code>enable</code> to enable LLDP SNMP subagent.</div> + <div><code>disable</code> to disable it.</div> + <div>Requires SNMP service to be configured on the device.</div> </td> </tr> @@ -139,6 +146,10 @@ Parameters </ul> </td> <td> + <div><code>merged</code> - merge config with existing.</div> + <div><code>replaced</code> - replace existing config with provided.</div> + <div><code>deleted</code> - delete LLDP configuration.</div> + <div><code>gathered</code> - return current config without changes.</div> </td> </tr> </table> @@ -152,14 +163,34 @@ Examples .. code-block:: yaml - - vyos.rest.vyos_lldp_global: + - name: Enable LLDP with management address and legacy protocols + vyos.rest.vyos_lldp_global: config: enable: true - addresses: [192.0.2.17] - snmp: enable - legacy_protocols: [cdp, fdp] + addresses: + - 192.0.2.17 + legacy_protocols: + - cdp + - fdp state: merged + - name: Replace LLDP configuration + vyos.rest.vyos_lldp_global: + config: + enable: true + addresses: + - 192.0.2.99 + state: replaced + + - name: Delete all LLDP configuration + vyos.rest.vyos_lldp_global: + state: deleted + + - name: Gather current LLDP configuration + vyos.rest.vyos_lldp_global: + state: gathered + register: result + Return Values @@ -185,6 +216,7 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late </td> <td>when changed</td> <td> + <div>LLDP configuration after the module ran.</div> <br/> </td> </tr> @@ -199,6 +231,7 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late </td> <td>always</td> <td> + <div>LLDP configuration before the module ran.</div> <br/> </td> </tr> @@ -213,6 +246,7 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late </td> <td>always</td> <td> + <div>List of commands sent to the device.</div> <br/> </td> </tr> @@ -227,6 +261,7 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late </td> <td>when state is gathered</td> <td> + <div>Current LLDP configuration from the device.</div> <br/> </td> </tr> |