Add eos_command doc with more examples (#36245)
* Add eos_command doc with more examples * More examples using cli and eapi transport * Example on how to handle json output * Example on handling result output in wait_for * Fix typo
This commit is contained in:
parent
55d117458a
commit
cb52509775
1 changed files with 23 additions and 1 deletions
|
@ -50,7 +50,9 @@ options:
|
|||
and what conditionals to apply. This argument will cause
|
||||
the task to wait for a particular conditional to be true
|
||||
before moving forward. If the conditional is not true
|
||||
by the configured retries, the task fails. See examples.
|
||||
by the configured retries, the task fails.
|
||||
Note - With I(wait_for) the value in C(result['stdout']) can be accessed
|
||||
using C(result), that is to access C(result['stdout'][0]) use C(result[0]) See examples.
|
||||
required: false
|
||||
default: null
|
||||
aliases: ['waitfor']
|
||||
|
@ -115,6 +117,26 @@ EXAMPLES = """
|
|||
commands:
|
||||
- command: show version
|
||||
output: json
|
||||
|
||||
- name: using cli transport, check whether the switch is in maintenance mode
|
||||
eos_command:
|
||||
commands: show maintenance
|
||||
wait_for: result[0] contains 'Under Maintenance'
|
||||
|
||||
- name: using cli transport, check whether the switch is in maintenance mode using json output
|
||||
eos_command:
|
||||
commands: show maintenance | json
|
||||
wait_for: result[0].units.System.state eq 'underMaintenance'
|
||||
|
||||
- name: "using eapi transport check whether the switch is in maintenance,
|
||||
with 8 retries and 2 second interval between retries"
|
||||
eos_command:
|
||||
commands: show maintenance
|
||||
wait_for: result[0]['units']['System']['state'] eq 'underMaintenance'
|
||||
interval: 2
|
||||
retries: 8
|
||||
provider:
|
||||
transport: eapi
|
||||
"""
|
||||
|
||||
RETURN = """
|
||||
|
|
Loading…
Reference in a new issue