[WIP] Network return docs (#23441)

Network return docs
This commit is contained in:
John R Barker 2017-04-12 13:13:41 -04:00 committed by GitHub
parent 92dc61e869
commit 902bc58509
79 changed files with 184 additions and 172 deletions

View file

@ -143,7 +143,7 @@ updates:
responses: responses:
description: The set of responses from issuing the commands on the device description: The set of responses from issuing the commands on the device
retured: when not check_mode returned: when not check_mode
type: list type: list
sample: ['...', '...'] sample: ['...', '...']
""" """

View file

@ -129,7 +129,7 @@ stdout_lines:
failed_conditions: failed_conditions:
description: the conditionals that failed description: the conditionals that failed
retured: failed returned: failed
type: list type: list
sample: ['...', '...'] sample: ['...', '...']
""" """

View file

@ -69,21 +69,7 @@ EXAMPLES = '''
''' '''
RETURN = ''' RETURN = ''' # '''
{
"changed": true,
"invocation": {
"module_args": {
"access_token": null,
"controller": "192.168.86.221",
"name": "MyChain",
"state": "present",
"validate_certs": false
},
"module_name": "bigmon_chain"
}
}
'''
import os import os
from ansible.module_utils.basic import AnsibleModule from ansible.module_utils.basic import AnsibleModule

View file

@ -95,27 +95,7 @@ EXAMPLES = '''
validate_certs: false validate_certs: false
''' '''
RETURN = ''' RETURN = ''' # '''
{
"changed": false,
"invocation": {
"module_args": {
"access_token": null,
"action": "drop",
"controller": "192.168.86.221",
"delivery_packet_count": 0,
"duration": 0,
"name": "policy1",
"policy_description": "DC 1 traffic policy",
"priority": 100,
"start_time": "2017-01-13T23:10:41.978584+00:00",
"state": "present",
"validate_certs": false
},
"module_name": "bigmon_policy"
}
}
'''
import os import os
import datetime import datetime

View file

@ -193,7 +193,7 @@ RETURN = '''
record: record:
description: dictionary containing the record data description: dictionary containing the record data
returned: success, except on record deletion returned: success, except on record deletion
type: dictionary type: complex
contains: contains:
content: content:
description: the record content (details depend on record type) description: the record content (details depend on record type)

View file

@ -77,6 +77,7 @@ ansible_net_model:
ansible_net_serialnum: ansible_net_serialnum:
description: The serial number of the remote device description: The serial number of the remote device
returned: always returned: always
type: str
ansible_net_version: ansible_net_version:
description: The operating system version running on the remote device description: The operating system version running on the remote device
returned: always returned: always

View file

@ -101,7 +101,7 @@ RETURN = '''
exo_dns_domain: exo_dns_domain:
description: API domain results description: API domain results
returned: success returned: success
type: dictionary type: complex
contains: contains:
account_id: account_id:
description: Your account ID description: Your account ID

View file

@ -181,7 +181,7 @@ RETURN = '''
exo_dns_record: exo_dns_record:
description: API record results description: API record results
returned: success returned: success
type: dictionary type: complex
contains: contains:
content: content:
description: value of the record description: value of the record

View file

@ -145,7 +145,7 @@ banner_text:
inactivity_timeout: inactivity_timeout:
description: > description: >
The number of seconds before inactivity causes an SSH. The number of seconds before inactivity causes an SSH.
session to log out session to log out.
returned: changed returned: changed
type: int type: int
sample: "10" sample: "10"
@ -156,12 +156,12 @@ log_level:
sample: "debug" sample: "debug"
login: login:
description: Specifies that the system accepts SSH communications or not. description: Specifies that the system accepts SSH communications or not.
return: changed returned: changed
type: bool type: bool
sample: true sample: true
port: port:
description: Port that you want the SSH daemon to run on. description: Port that you want the SSH daemon to run on.
return: changed returned: changed
type: int type: int
sample: 22 sample: 22
''' '''

View file

@ -160,7 +160,7 @@ bwc_policy:
connection_limit: connection_limit:
description: The new connection limit for the route domain description: The new connection limit for the route domain
returned: changed returned: changed
type: integer type: int
sample: 100 sample: 100
flow_eviction_policy: flow_eviction_policy:
description: The new eviction policy to use with this route domain description: The new eviction policy to use with this route domain

View file

@ -201,31 +201,22 @@ address:
sample: "192.0.2.10" sample: "192.0.2.10"
name: name:
description: The name of the Self IP description: The name of the Self IP
returned: returned: created, changed or deleted
- created
- changed
- deleted
type: string type: string
sample: "self1" sample: "self1"
netmask: netmask:
description: The netmask of the Self IP description: The netmask of the Self IP
returned: returned: created or changed
- changed
- created
type: string type: string
sample: "255.255.255.0" sample: "255.255.255.0"
traffic_group: traffic_group:
description: The traffic group that the Self IP is a member of description: The traffic group that the Self IP is a member of
return: returned: changed or created
- changed
- created
type: string type: string
sample: "traffic-group-local-only" sample: "traffic-group-local-only"
vlan: vlan:
description: The VLAN set on the Self IP description: The VLAN set on the Self IP
return: returned: created or changed
- changed
- created
type: string type: string
sample: "vlan1" sample: "vlan1"
''' '''

View file

@ -138,42 +138,29 @@ cert_name:
description: > description: >
The name of the SSL certificate. The C(cert_name) and The name of the SSL certificate. The C(cert_name) and
C(key_name) will be equal to each other. C(key_name) will be equal to each other.
returned: returned: created, changed or deleted
- created
- changed
- deleted
type: string type: string
sample: "cert1" sample: "cert1"
key_name: key_name:
description: > description: >
The name of the SSL certificate key. The C(key_name) and The name of the SSL certificate key. The C(key_name) and
C(cert_name) will be equal to each other. C(cert_name) will be equal to each other.
returned: returned: created, changed or deleted
- created
- changed
- deleted
type: string type: string
sample: "key1" sample: "key1"
partition: partition:
description: Partition in which the cert/key was created description: Partition in which the cert/key was created
returned: returned: created, changed or deleted
- changed
- created
- deleted
type: string type: string
sample: "Common" sample: "Common"
key_checksum: key_checksum:
description: SHA1 checksum of the key that was provided description: SHA1 checksum of the key that was provided
return: returned: created or changed
- changed
- created
type: string type: string
sample: "cf23df2207d99a74fbe169e3eba035e633b65d94" sample: "cf23df2207d99a74fbe169e3eba035e633b65d94"
cert_checksum: cert_checksum:
description: SHA1 checksum of the cert that was provided description: SHA1 checksum of the cert that was provided
return: returned: created or changed
- changed
- created
type: string type: string
sample: "f7ff9e8b7bb2e09b70935a5d785e0cc5d9d0abf0" sample: "f7ff9e8b7bb2e09b70935a5d785e0cc5d9d0abf0"
''' '''

View file

@ -121,7 +121,7 @@ console_timeout:
The new number of seconds of inactivity before the system The new number of seconds of inactivity before the system
logs off a user that is logged on. logs off a user that is logged on.
returned: changed returned: changed
type: integer type: int
sample: 600 sample: 600
gui_setup: gui_setup:
description: The new setting for the Setup utility. description: The new setting for the Setup utility.

View file

@ -93,7 +93,7 @@ value:
description: value of the property description: value of the property
returned: always returned: always
type: int/string (depends on property) type: int/string (depends on property)
sample: 1024/never sample: "'1024' or 'never'"
''' '''
SUPPORTED_PROTOCOLS = ['ipv4', 'ipv6', 'icmp', 'tcp', 'udp', 'sctp'] SUPPORTED_PROTOCOLS = ['ipv4', 'ipv6', 'icmp', 'tcp', 'udp', 'sctp']

View file

@ -55,7 +55,7 @@ RETURN = '''
ansible_facts: ansible_facts:
description: "Dictionary of ip geolocation facts for a host's IP address" description: "Dictionary of ip geolocation facts for a host's IP address"
returned: changed returned: changed
type: dictionary type: complex
contains: contains:
ip: ip:
description: "Public IP address of a host" description: "Public IP address of a host"

View file

@ -72,14 +72,17 @@ EXAMPLES = """
RETURN = """ RETURN = """
xml: xml:
description: The xml return string from the rpc request description: The xml return string from the rpc request.
returned: always returned: always
type: string
output: output:
description: The rpc rely converted to the output format description: The rpc rely converted to the output format.
returned: always returned: always
type: string
output_lines: output_lines:
description: The text output split into lines for readability description: The text output split into lines for readability.
returned: always returned: always
type: list
""" """
from ncclient.xml_ import new_ele, sub_ele, to_xml, to_ele from ncclient.xml_ import new_ele, sub_ele, to_xml, to_ele

View file

@ -160,11 +160,11 @@ Tasks : The following are examples of using the module cnos_backup. These are wr
''' '''
RETURN = ''' RETURN = '''
--- msg:
return value: | description: Success or failure message
On successful execution, the method returns a message in JSON format returned: always
[Config file tranferred to server] type: string
Upon any failure, the method returns an error display string. sample: "Config file tranferred to server"
''' '''
import sys import sys

View file

@ -358,10 +358,10 @@ Tasks: The following are examples of using the module cnos_bgp. These are writte
''' '''
RETURN = ''' RETURN = '''
return value: | msg:
On successful execution, the method returns an empty string with the following message in JSON format. description: Success or failure message. Upon any failure, the method returns an error display string.
[BGP configurations accomplished] returned: always
Upon any failure, the method returns an error display string. The error must be corrected before attempting the method again. type: string
''' '''
import sys import sys

View file

@ -69,10 +69,11 @@ Tasks : The following are examples of using the module cnos_command. These are w
''' '''
RETURN = ''' RETURN = '''
return value: | msg:
On successful execution, the method returns a message in JSON format description: Success or failure message
[Command Applied] returned: always
Upon any failure, the method returns an error display string. type: string
sample: "Command Applied"
''' '''

View file

@ -89,11 +89,11 @@ Tasks : The following are examples of using the module cnos_conditional_command.
''' '''
RETURN = ''' RETURN = '''
return value: | msg:
On successful execution, the method returns a message in JSON format description: Success or failure message
[Command Applied] returned: always
Upon any failure, the method returns an error display string. type: string
sample: "Command Applied"
''' '''
import sys import sys

View file

@ -96,11 +96,11 @@ Tasks : The following are examples of using the module cnos_conditional_template
switchport_mode1: trunk switchport_mode1: trunk
''' '''
RETURN = ''' RETURN = '''
return value: | msg:
On successful execution, the method returns a message in JSON format description: Success or failure message
[Template Applied.] returned: always
Upon any failure, the method returns an error display string. type: string
sample: "Template Applied."
''' '''
import sys import sys

View file

@ -58,11 +58,11 @@ Tasks : The following are examples of using the module cnos_reload. These are wr
''' '''
RETURN = ''' RETURN = '''
return value: | msg:
On successful execution, the method returns a message in JSON format description: Success or failure message
[Switch Startup Config is Reset to factory settings] returned: always
Upon any failure, the method returns an error display string. type: string
sample: "Switch Startup Config is Reset to factory settings"
''' '''

View file

@ -56,13 +56,13 @@ Tasks : The following are examples of using the module cnos_facts. These are wri
outputfile: "./results/cnos_facts_{{ inventory_hostname }}_output.txt" outputfile: "./results/cnos_facts_{{ inventory_hostname }}_output.txt"
''' '''
RETURN = ''' RETURN = '''
return value: | msg:
On successful execution, the method returns a message in JSON format description: Success or failure message
[Device Sys Info is saved to file] returned: always
Upon any failure, the method returns an error display string. type: string
sample: "Device Sys Info is saved to file"
''' '''
import sys import sys
import paramiko import paramiko
import time import time

View file

@ -117,11 +117,13 @@ Tasks : The following are examples of using the module cnos_image. These are wri
serverpassword: "root123" serverpassword: "root123"
''' '''
RETURN = ''' RETURN = '''
return value: | msg:
On successful execution, the method returns a message in JSON format description: Success or failure message
[Image file tranferred to device] returned: always
Upon any failure, the method returns an error display string. type: string
sample: "Image file tranferred to device"
''' '''
import sys import sys
import paramiko import paramiko
import time import time

View file

@ -455,11 +455,11 @@ Tasks : The following are examples of using the module cnos_interface. These are
''' '''
RETURN = ''' RETURN = '''
return value: | msg:
On successful execution, the method returns a message in JSON format description: Success or failure message
[Interface configurations accomplished.] returned: always
Upon any failure, the method returns an error display string. type: string
sample: "Interface configurations accomplished."
''' '''
import sys import sys

View file

@ -407,13 +407,13 @@ Tasks : The following are examples of using the module cnos_portchannel. These a
''' '''
RETURN = ''' RETURN = '''
return value: | msg:
On successful execution, the method returns a message in JSON format description: Success or failure message
[Port Channel configurations accomplished] returned: always
Upon any failure, the method returns an error display string. type: string
sample: "Port Channel configurations accomplished"
''' '''
import sys import sys
import paramiko import paramiko
import time import time

View file

@ -57,14 +57,13 @@ Tasks : The following are examples of using the module cnos_reload. These are wr
outputfile: "./results/test_reload_{{ inventory_hostname }}_output.txt" outputfile: "./results/test_reload_{{ inventory_hostname }}_output.txt"
''' '''
RETURN = ''' RETURN = '''
return value: | msg:
On successful execution, the method returns a message in JSON format description: Success or failure message
[Device is Reloading. Please wait...] returned: always
Upon any failure, the method returns an error display string. type: string
sample: "Device is Reloading. Please wait..."
''' '''
import sys import sys
import paramiko import paramiko
import time import time

View file

@ -153,11 +153,13 @@ Tasks : The following are examples of using the module cnos_rollback. These are
''' '''
RETURN = ''' RETURN = '''
return value: | msg:
On successful execution, the method returns a message in JSON format description: Success or failure message
[Config file tranferred to Device] returned: always
Upon any failure, the method returns an error display string. type: string
sample: "Config file tranferred to Device"
''' '''
import sys import sys
import paramiko import paramiko
import time import time

View file

@ -58,10 +58,11 @@ Tasks : The following are examples of using the module cnos_save. These are writ
outputfile: "./results/test_save_{{ inventory_hostname }}_output.txt" outputfile: "./results/test_save_{{ inventory_hostname }}_output.txt"
''' '''
RETURN = ''' RETURN = '''
return value: | msg:
On successful execution, the method returns a message in JSON format description: Success or failure message
[Switch Running Config is Saved to Startup Config] returned: always
Upon any failure, the method returns an error display string. type: string
sample: "Switch Running Config is Saved to Startup Config"
''' '''
import sys import sys

View file

@ -59,12 +59,13 @@ Tasks : The following are examples of using the module cnos_showrun. These are w
''' '''
RETURN = ''' RETURN = '''
return value: | msg:
On successful execution, the method returns a message in JSON format description: Success or failure message
[Running Configuration saved in file] returned: always
Upon any failure, the method returns an error display string. type: string
sample: "Running Configuration saved in file"
''' '''
import sys import sys
import paramiko import paramiko
import time import time

View file

@ -81,11 +81,13 @@ Tasks : The following are examples of using the module cnos_template. These are
''' '''
RETURN = ''' RETURN = '''
return value: | msg:
On successful execution, the method returns a message in JSON format description: Success or failure message
[Template Applied.] returned: always
Upon any failure, the method returns an error display string. type: string
sample: "Template Applied."
''' '''
import sys import sys
import paramiko import paramiko
import time import time

View file

@ -242,10 +242,11 @@ Tasks : The following are examples of using the module cnos_vlag. These are writ
''' '''
RETURN = ''' RETURN = '''
return value: | msg:
On successful execution, the method returns a message in JSON format description: Success or failure message
[vLAG configurations accomplished] returned: always
Upon any failure, the method returns an error display string. type: string
sample: "vLAG configurations accomplished"
''' '''
import sys import sys

View file

@ -181,10 +181,11 @@ Tasks: The following are examples of using the module cnos_vlan. These are writt
''' '''
RETURN = ''' RETURN = '''
return value: | msg:
On successful execution, the method returns a message in JSON format description: Success or failure message
[VLAN configurations are successful] returned: always
Upon any failure, the method returns an error display string. type: string
sample: "VLAN configuration is accomplished"
''' '''
import sys import sys

View file

@ -136,7 +136,7 @@ RETURN = '''
server_capabilities: server_capabilities:
description: list of capabilities of the server description: list of capabilities of the server
returned: success returned: success
type: list of strings type: list
sample: ['urn:ietf:params:netconf:base:1.1','urn:ietf:params:netconf:capability:confirmed-commit:1.0','urn:ietf:params:netconf:capability:candidate:1.0'] sample: ['urn:ietf:params:netconf:base:1.1','urn:ietf:params:netconf:capability:confirmed-commit:1.0','urn:ietf:params:netconf:capability:candidate:1.0']
''' '''

View file

@ -94,6 +94,8 @@ EXAMPLES = """
RETURN = """ RETURN = """
command: command:
description: The CLI command run on the target node(s). description: The CLI command run on the target node(s).
returned: always
type: str
stdout: stdout:
description: The set of responses from the cluster command. description: The set of responses from the cluster command.
returned: always returned: always

View file

@ -83,6 +83,8 @@ EXAMPLES = """
RETURN = """ RETURN = """
command: command:
description: The CLI command run on the target node(s). description: The CLI command run on the target node(s).
returned: always
type: str
stdout: stdout:
description: The set of responses from the ospf command. description: The set of responses from the ospf command.
returned: always returned: always

View file

@ -98,6 +98,8 @@ EXAMPLES = """
RETURN = """ RETURN = """
command: command:
description: The CLI command run on the target node(s). description: The CLI command run on the target node(s).
returned: always
type: str
stdout: stdout:
description: The set of responses from the ospf command. description: The set of responses from the ospf command.
returned: always returned: always

View file

@ -79,6 +79,8 @@ EXAMPLES = """
RETURN = """ RETURN = """
command: command:
description: The CLI command run on the target node(s). description: The CLI command run on the target node(s).
returned: always
type: str
stdout: stdout:
description: The set of responses from the show command. description: The set of responses from the show command.
returned: always returned: always

View file

@ -145,6 +145,8 @@ EXAMPLES = """
RETURN = """ RETURN = """
command: command:
description: The CLI command run on the target node(s). description: The CLI command run on the target node(s).
returned: always
type: str
stdout: stdout:
description: The set of responses from the trunk command. description: The set of responses from the trunk command.
returned: always returned: always

View file

@ -117,6 +117,8 @@ EXAMPLES = """
RETURN = """ RETURN = """
command: command:
description: The CLI command run on the target node(s). description: The CLI command run on the target node(s).
returned: always
type: str
stdout: stdout:
description: The set of responses from the vlag command. description: The set of responses from the vlag command.
returned: always returned: always

View file

@ -97,6 +97,8 @@ EXAMPLES = """
RETURN = """ RETURN = """
command: command:
description: The CLI command run on the target node(s). description: The CLI command run on the target node(s).
returned: always
type: str
stdout: stdout:
description: The set of responses from the vlan command. description: The set of responses from the vlan command.
returned: always returned: always

View file

@ -131,6 +131,8 @@ EXAMPLES = """
RETURN = """ RETURN = """
command: command:
description: The CLI command run on the target node(s). description: The CLI command run on the target node(s).
returned: always
type: str
stdout: stdout:
description: The set of responses from the vrouter command. description: The set of responses from the vrouter command.
returned: always returned: always

View file

@ -144,6 +144,8 @@ EXAMPLES = """
RETURN = """ RETURN = """
command: command:
description: The CLI command run on the target node(s). description: The CLI command run on the target node(s).
returned: always
type: str
stdout: stdout:
description: The set of responses from the vrouterbpg command. description: The set of responses from the vrouterbpg command.
returned: always returned: always

View file

@ -141,13 +141,15 @@ EXAMPLES = """
""" """
RETURN = """ RETURN = """
vrouterifcmd: command:
description: The CLI command run on the target node(s). description: The CLI command run on the target node(s).
stdout/msg: returned: always
type: str
stdout:
description: The set of responses from the vrouterif command. description: The set of responses from the vrouterif command.
returned: on success returned: on success
type: list type: list
stderr/msg: stderr:
description: The set of error responses from the vrouterif command. description: The set of error responses from the vrouterif command.
returned: on error returned: on error
type: str type: str

View file

@ -84,6 +84,8 @@ EXAMPLES = """
RETURN = """ RETURN = """
command: command:
description: The CLI command run on the target node(s). description: The CLI command run on the target node(s).
returned: always
type: str
stdout: stdout:
description: The set of responses from the vrouterlb command. description: The set of responses from the vrouterlb command.
returned: always returned: always

View file

@ -101,6 +101,7 @@ proposed:
existing: existing:
description: description:
- k/v pairs of existing mtu/sysmtu on the interface/system - k/v pairs of existing mtu/sysmtu on the interface/system
returned: always
type: dict type: dict
sample: {"mtu": "1600", "sysmtu": "9216"} sample: {"mtu": "1600", "sysmtu": "9216"}
end_state: end_state:

View file

@ -130,6 +130,7 @@ proposed:
existing: existing:
description: description:
- k/v pairs of existing aaa server - k/v pairs of existing aaa server
returned: always
type: dict type: dict
sample: {"deadtime": "0", "directed_request": "disabled", sample: {"deadtime": "0", "directed_request": "disabled",
"global_key": "unknown", "server_timeout": "5"} "global_key": "unknown", "server_timeout": "5"}

View file

@ -132,6 +132,7 @@ proposed:
existing: existing:
description: description:
- k/v pairs of existing configuration - k/v pairs of existing configuration
returned: always
type: dict type: dict
sample: {} sample: {}
end_state: end_state:

View file

@ -75,6 +75,7 @@ proposed:
"name": "ANSIBLE"} "name": "ANSIBLE"}
existing: existing:
description: k/v pairs of existing ACL applied to the interface description: k/v pairs of existing ACL applied to the interface
returned: always
type: dict type: dict
sample: {} sample: {}
end_state: end_state:

View file

@ -123,6 +123,7 @@ proposed:
sample: {"group": "30", "version": "2", "vip": "10.30.1.1"} sample: {"group": "30", "version": "2", "vip": "10.30.1.1"}
existing: existing:
description: k/v pairs of existing hsrp info on the interface description: k/v pairs of existing hsrp info on the interface
returned: always
type: dict type: dict
sample: {} sample: {}
end_state: end_state:

View file

@ -183,6 +183,7 @@ proposed:
sample: {"asn": "65535", "router_id": "1.1.1.1", "vrf": "test"} sample: {"asn": "65535", "router_id": "1.1.1.1", "vrf": "test"}
existing: existing:
description: k/v pairs of existing BGP configuration description: k/v pairs of existing BGP configuration
returned: always
type: dict type: dict
sample: {"asn": "65535", "bestpath_always_compare_med": false, sample: {"asn": "65535", "bestpath_always_compare_med": false,
"bestpath_aspath_multipath_relax": false, "bestpath_aspath_multipath_relax": false,

View file

@ -105,6 +105,7 @@ proposed:
existing: existing:
description: description:
- k/v pairs of existing configuration - k/v pairs of existing configuration
returned: always
type: dict type: dict
sample: {"group_timeout": "never", "link_local_grp_supp": false, sample: {"group_timeout": "never", "link_local_grp_supp": false,
"report_supp": true, "snooping": true, "v3_report_supp": true} "report_supp": true, "snooping": true, "v3_report_supp": true}

View file

@ -101,6 +101,7 @@ EXAMPLES = '''
RETURN = ''' RETURN = '''
install_state: install_state:
description: Boot and install information.
returned: always returned: always
type: dictionary type: dictionary
sample: { sample: {

View file

@ -142,6 +142,7 @@ proposed:
sample: {"admin_state": "down"} sample: {"admin_state": "down"}
existing: existing:
description: k/v pairs of existing switchport description: k/v pairs of existing switchport
returned: always
type: dict type: dict
sample: {"admin_state": "up", "description": "None", sample: {"admin_state": "up", "description": "None",
"interface": "port-channel101", "mode": "layer2", "interface": "port-channel101", "mode": "layer2",
@ -149,7 +150,7 @@ existing:
end_state: end_state:
description: k/v pairs of switchport after module execution description: k/v pairs of switchport after module execution
returned: always returned: always
type: dict or null type: dict
sample: {"admin_state": "down", "description": "None", sample: {"admin_state": "down", "description": "None",
"interface": "port-channel101", "mode": "layer2", "interface": "port-channel101", "mode": "layer2",
"type": "portchannel", "ip_forward": "enable"} "type": "portchannel", "ip_forward": "enable"}

View file

@ -89,6 +89,7 @@ proposed:
sample: {"addr": "20.20.20.20", "interface": "ethernet1/32", "mask": "24"} sample: {"addr": "20.20.20.20", "interface": "ethernet1/32", "mask": "24"}
existing: existing:
description: k/v pairs of existing IP attributes on the interface description: k/v pairs of existing IP attributes on the interface
returned: always
type: dict type: dict
sample: {"addresses": [{"addr": "11.11.11.11", "mask": 17}], sample: {"addresses": [{"addr": "11.11.11.11", "mask": 17}],
"interface": "ethernet1/32", "prefix": "11.11.0.0", "interface": "ethernet1/32", "prefix": "11.11.0.0",

View file

@ -102,6 +102,7 @@ proposed:
existing: existing:
description: description:
- k/v pairs of existing ntp server/peer - k/v pairs of existing ntp server/peer
returned: always
type: dict type: dict
sample: {"address": "2.2.2.2", "key_id": "32", sample: {"address": "2.2.2.2", "key_id": "32",
"peer_type": "server", "prefer": "enabled", "peer_type": "server", "prefer": "enabled",

View file

@ -98,6 +98,7 @@ proposed:
existing: existing:
description: description:
- k/v pairs of existing ntp authentication - k/v pairs of existing ntp authentication
returned: always
type: dict type: dict
sample: {"authentication": "off", "trusted_key": "false"} sample: {"authentication": "off", "trusted_key": "false"}
end_state: end_state:

View file

@ -85,6 +85,7 @@ proposed:
existing: existing:
description: description:
- k/v pairs of existing ntp options - k/v pairs of existing ntp options
returned: always
type: dict type: dict
sample: {"logging": true, "master": true, "stratum": "8"} sample: {"logging": true, "master": true, "stratum": "8"}
end_state: end_state:

View file

@ -159,6 +159,7 @@ proposed:
existing: existing:
description: description:
- k/v pairs of existing configuration - k/v pairs of existing configuration
returned: always
type: dict type: dict
sample: {"border": false, "dr_prio": "1", "hello_interval": "30000", sample: {"border": false, "dr_prio": "1", "hello_interval": "30000",
"isauth": false, "jp_bidir": false, "jp_policy_in": "JPIN", "isauth": false, "jp_bidir": false, "jp_policy_in": "JPIN",

View file

@ -96,6 +96,7 @@ proposed:
existing: existing:
description: description:
- k/v pairs of existing portchannel - k/v pairs of existing portchannel
returned: always
type: dict type: dict
sample: {"group": "12", "members": ["Ethernet2/5", sample: {"group": "12", "members": ["Ethernet2/5",
"Ethernet2/6"], "members_detail": { "Ethernet2/6"], "members_detail": {

View file

@ -80,12 +80,13 @@ proposed:
sample: {"group": "network-operator"} sample: {"group": "network-operator"}
existing: existing:
description: k/v pairs of existing snmp community description: k/v pairs of existing snmp community
returned: always
type: dict type: dict
sample: {} sample: {}
end_state: end_state:
description: k/v pairs of snmp community after module execution description: k/v pairs of snmp community after module execution
returned: always returned: always
type: dict or null type: dict
sample: {"acl": "None", "group": "network-operator"} sample: {"acl": "None", "group": "network-operator"}
updates: updates:
description: commands sent to the device description: commands sent to the device

View file

@ -65,6 +65,7 @@ proposed:
sample: {"contact": "New_Test"} sample: {"contact": "New_Test"}
existing: existing:
description: k/v pairs of existing snmp contact description: k/v pairs of existing snmp contact
returned: always
type: dict type: dict
sample: {"contact": "Test"} sample: {"contact": "Test"}
end_state: end_state:

View file

@ -106,6 +106,7 @@ proposed:
"snmp_type": "trap", "version": "v2c", "vrf_filter": "one_more_vrf"} "snmp_type": "trap", "version": "v2c", "vrf_filter": "one_more_vrf"}
existing: existing:
description: k/v pairs of existing snmp host description: k/v pairs of existing snmp host
returned: always
type: dict type: dict
sample: {"community": "TESTING", "snmp_type": "trap", sample: {"community": "TESTING", "snmp_type": "trap",
"udp": "162", "v3": "noauth", "version": "v2c", "udp": "162", "v3": "noauth", "version": "v2c",
@ -114,7 +115,7 @@ existing:
end_state: end_state:
description: k/v pairs of switchport after module execution description: k/v pairs of switchport after module execution
returned: always returned: always
type: dict or null type: dict
sample: {"community": "TESTING", "snmp_type": "trap", sample: {"community": "TESTING", "snmp_type": "trap",
"udp": "162", "v3": "noauth", "version": "v2c", "udp": "162", "v3": "noauth", "version": "v2c",
"vrf": "test_vrf", "vrf_filter": ["test_vrf", "vrf": "test_vrf", "vrf_filter": ["test_vrf",

View file

@ -72,12 +72,13 @@ proposed:
sample: {"location": "New_Test"} sample: {"location": "New_Test"}
existing: existing:
description: k/v pairs of existing snmp location description: k/v pairs of existing snmp location
returned: always
type: dict type: dict
sample: {"location": "Test"} sample: {"location": "Test"}
end_state: end_state:
description: k/v pairs of location info after module execution description: k/v pairs of location info after module execution
returned: always returned: always
type: dict or null type: dict
sample: {"location": "New_Test"} sample: {"location": "New_Test"}
updates: updates:
description: command sent to the device description: command sent to the device

View file

@ -80,6 +80,7 @@ proposed:
sample: {"group": "lldp"} sample: {"group": "lldp"}
existing: existing:
description: k/v pairs of existing trap status description: k/v pairs of existing trap status
returned: always
type: dict type: dict
sample: {"lldp": [{"enabled": "No", sample: {"lldp": [{"enabled": "No",
"trap": "lldpRemTablesChange"}]} "trap": "lldpRemTablesChange"}]}

View file

@ -93,6 +93,7 @@ proposed:
existing: existing:
description: description:
- k/v pairs of existing configuration - k/v pairs of existing configuration
returned: always
type: dict type: dict
sample: {"authentication": "no", "encrypt": "none", sample: {"authentication": "no", "encrypt": "none",
"group": ["network-operator"], "user": "ntc"} "group": ["network-operator"], "user": "ntc"}

View file

@ -130,6 +130,7 @@ proposed:
sample: {"access_vlan": "10", "interface": "eth1/5", "mode": "access"} sample: {"access_vlan": "10", "interface": "eth1/5", "mode": "access"}
existing: existing:
description: k/v pairs of existing switchport description: k/v pairs of existing switchport
returned: always
type: dict type: dict
sample: {"access_vlan": "10", "access_vlan_name": "VLAN0010", sample: {"access_vlan": "10", "access_vlan_name": "VLAN0010",
"interface": "Ethernet1/5", "mode": "access", "interface": "Ethernet1/5", "mode": "access",
@ -138,7 +139,7 @@ existing:
end_state: end_state:
description: k/v pairs of switchport after module execution description: k/v pairs of switchport after module execution
returned: always returned: always
type: dict or null type: dict
sample: {"access_vlan": "10", "access_vlan_name": "VLAN0010", sample: {"access_vlan": "10", "access_vlan_name": "VLAN0010",
"interface": "Ethernet1/5", "mode": "access", "interface": "Ethernet1/5", "mode": "access",
"native_vlan": "1", "native_vlan_name": "default", "native_vlan": "1", "native_vlan_name": "default",

View file

@ -89,6 +89,7 @@ proposed:
existing: existing:
description: description:
- k/v pairs of existing udld configuration - k/v pairs of existing udld configuration
returned: always
type: dict type: dict
sample: {"aggressive": "disabled", "msg_time": "15"} sample: {"aggressive": "disabled", "msg_time": "15"}
end_state: end_state:

View file

@ -87,6 +87,7 @@ proposed:
existing: existing:
description: description:
- k/v pairs of existing configuration - k/v pairs of existing configuration
returned: always
type: dict type: dict
sample: {"mode": "aggressive"} sample: {"mode": "aggressive"}
end_state: end_state:

View file

@ -126,7 +126,7 @@ proposed:
description: k/v pairs of parameters passed into module (does not include description: k/v pairs of parameters passed into module (does not include
vlan_id or vlan_range) vlan_id or vlan_range)
returned: when debug enabled returned: when debug enabled
type: dict or null type: dict
sample: {"admin_state": "down", "name": "app_vlan", sample: {"admin_state": "down", "name": "app_vlan",
"vlan_state": "suspend", "mapped_vni": "5000"} "vlan_state": "suspend", "mapped_vni": "5000"}
existing: existing:
@ -139,7 +139,7 @@ end_state:
description: k/v pairs of the VLAN after executing module or null description: k/v pairs of the VLAN after executing module or null
when using vlan_range when using vlan_range
returned: when debug enabled returned: when debug enabled
type: dict or null type: dict
sample: {"admin_state": "down", "name": "app_vlan", "vlan_id": "20", sample: {"admin_state": "down", "name": "app_vlan", "vlan_id": "20",
"vlan_state": "suspend", "mapped_vni": "5000"} "vlan_state": "suspend", "mapped_vni": "5000"}
updates: updates:

View file

@ -118,6 +118,7 @@ proposed:
"role_priority": "1000", "system_priority": "2000"} "role_priority": "1000", "system_priority": "2000"}
existing: existing:
description: k/v pairs of existing VPC configuration description: k/v pairs of existing VPC configuration
returned: always
type: dict type: dict
sample: {"auto_recovery": true, "delay_restore": null, sample: {"auto_recovery": true, "delay_restore": null,
"domain": "100", "peer_gw": true, "domain": "100", "peer_gw": true,

View file

@ -78,6 +78,7 @@ proposed:
sample: {"portchannel": "100", "vpc": "10"} sample: {"portchannel": "100", "vpc": "10"}
existing: existing:
description: k/v pairs of existing configuration description: k/v pairs of existing configuration
returned: always
type: dict type: dict
sample: {} sample: {}
end_state: end_state:

View file

@ -98,6 +98,7 @@ proposed:
"vrf": "ntc"} "vrf": "ntc"}
existing: existing:
description: k/v pairs of existing vrf description: k/v pairs of existing vrf
returned: always
type: dict type: dict
sample: {"admin_state": "Up", "description": "Old test", sample: {"admin_state": "Up", "description": "Old test",
"vrf": "old_ntc"} "vrf": "old_ntc"}

View file

@ -80,6 +80,7 @@ proposed:
sample: {"interface": "loopback16", "vrf": "ntc"} sample: {"interface": "loopback16", "vrf": "ntc"}
existing: existing:
description: k/v pairs of existing vrf on the interface description: k/v pairs of existing vrf on the interface
returned: always
type: dict type: dict
sample: {"interface": "loopback16", "vrf": ""} sample: {"interface": "loopback16", "vrf": ""}
end_state: end_state:

View file

@ -115,6 +115,7 @@ proposed:
"admin_state": "no shutdown"} "admin_state": "no shutdown"}
existing: existing:
description: k/v pairs of existing vrrp info on the interface description: k/v pairs of existing vrrp info on the interface
returned: always
type: dict type: dict
sample: {} sample: {}
end_state: end_state:

View file

@ -65,6 +65,7 @@ proposed:
existing: existing:
description: description:
- k/v pairs of existing vtp domain - k/v pairs of existing vtp domain
returned: always
type: dict type: dict
sample: {"domain": "testing", "version": "2", "vtp_password": "\"} sample: {"domain": "testing", "version": "2", "vtp_password": "\"}
end_state: end_state:

View file

@ -83,6 +83,7 @@ proposed:
existing: existing:
description: description:
- k/v pairs of existing vtp - k/v pairs of existing vtp
returned: always
type: dict type: dict
sample: {"domain": "ntc", "version": "1", "vtp_password": "ntc"} sample: {"domain": "ntc", "version": "1", "vtp_password": "ntc"}
end_state: end_state:

View file

@ -62,6 +62,7 @@ proposed:
existing: existing:
description: description:
- k/v pairs of existing vtp - k/v pairs of existing vtp
returned: always
type: dict type: dict
sample: {"domain": "testing", "version": "1", "vtp_password": "\"} sample: {"domain": "testing", "version": "1", "vtp_password": "\"}
end_state: end_state:

View file

@ -117,7 +117,7 @@ changed:
lease: lease:
description: dictionnary containing host informations description: dictionnary containing host informations
returned: success returned: success
type: dictionnary type: complex
contains: contains:
ip-address: ip-address:
description: IP address, if there is. description: IP address, if there is.