.. Document meta :orphan: .. |antsibull-internal-nbsp| unicode:: 0xA0 :trim: .. role:: ansible-attribute-support-label .. role:: ansible-attribute-support-property .. role:: ansible-attribute-support-full .. role:: ansible-attribute-support-partial .. role:: ansible-attribute-support-none .. role:: ansible-attribute-support-na .. role:: ansible-option-type .. role:: ansible-option-elements .. role:: ansible-option-required .. role:: ansible-option-versionadded .. role:: ansible-option-aliases .. role:: ansible-option-choices .. role:: ansible-option-choices-default-mark .. role:: ansible-option-default-bold .. role:: ansible-option-configuration .. role:: ansible-option-returned-bold .. role:: ansible-option-sample-bold .. Anchors .. _ansible_collections.cisco.dnac.discovery_intent_module: .. Anchors: short name for ansible.builtin .. Anchors: aliases .. Title cisco.dnac.discovery_intent module -- Resource module for discovery related functions +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ .. Collection note .. note:: This module is part of the `cisco.dnac collection `_ (version 6.10.4). To install it, use: :code:`ansible-galaxy collection install cisco.dnac`. You need further requirements to be able to use this module, see :ref:`Requirements ` for details. To use it in a playbook, specify: :code:`cisco.dnac.discovery_intent`. .. version_added .. rst-class:: ansible-version-added New in cisco.dnac 6.6.0 .. contents:: :local: :depth: 1 .. Deprecated Synopsis -------- .. Description - Manage operations discover devices using IP address/range, CDP, LLDP and delete discoveries - API to discover a device or multiple devices - API to delete a discovery of a device or multiple devices .. Aliases .. Requirements .. _ansible_collections.cisco.dnac.discovery_intent_module_requirements: Requirements ------------ The below requirements are needed on the host that executes this module. - dnacentersdk == 2.6.10 - python \>= 3.5 .. Options Parameters ---------- .. rst-class:: ansible-option-table .. list-table:: :width: 100% :widths: auto :header-rows: 1 * - Parameter - Comments * - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config: .. rst-class:: ansible-option-title **config** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` / :ansible-option-required:`required` .. raw:: html
- .. raw:: html
List of details of device being managed. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/cdp_level: .. rst-class:: ansible-option-title **cdp_level** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Total number of levels that are there in cdp's method of discovery .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`16` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/cli_cred_len: .. rst-class:: ansible-option-title **cli_cred_len** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Specifies the total number of CLI credentials to be used, ranging from 1 to 5. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`1` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/delete_all: .. rst-class:: ansible-option-title **delete_all** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Parameter to delete all the discoveries at one go .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/discovery_name: .. rst-class:: ansible-option-title **discovery_name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` / :ansible-option-required:`required` .. raw:: html
- .. raw:: html
Name of the discovery task .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/discovery_type: .. rst-class:: ansible-option-title **discovery_type** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` / :ansible-option-required:`required` .. raw:: html
- .. raw:: html
Type of discovery (SINGLE/RANGE/MULTI RANGE/CDP/LLDP) .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/enable_password_list: .. rst-class:: ansible-option-title **enable_password_list** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
List of enable passwords for the CLI crfedentials .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/http_read_credential: .. rst-class:: ansible-option-title **http_read_credential** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
HTTP read credentials for hosting a device .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/http_write_credential: .. rst-class:: ansible-option-title **http_write_credential** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
HTTP write credentials for hosting a device .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/ip_address_list: .. rst-class:: ansible-option-title **ip_address_list** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` / :ansible-option-required:`required` .. raw:: html
- .. raw:: html
List of IP addresses to be discoverred. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/ip_filter_list: .. rst-class:: ansible-option-title **ip_filter_list** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
List of IP adddrsess that needs to get filtered out from the IP addresses added .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/lldp_level: .. rst-class:: ansible-option-title **lldp_level** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Total number of levels that are there in lldp's method of discovery .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`16` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/netconf_port: .. rst-class:: ansible-option-title **netconf_port** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Port for the netconf credentials .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/password_list: .. rst-class:: ansible-option-title **password_list** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
List of passwords for the CLI credentials .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/preferred_mgmt_ip_method: .. rst-class:: ansible-option-title **preferred_mgmt_ip_method** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Preferred method for the management of the IP (None/UseLoopBack) .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"None"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/protocol_order: .. rst-class:: ansible-option-title **protocol_order** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Order of protocol (ssh/telnet) in which device connection will be tried. For example, 'telnet' - only telnet - 'ssh, telnet' - ssh with higher order than telnet .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/records_to_return: .. rst-class:: ansible-option-title **records_to_return** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Number of records to return for the header in fetching global v2 credentials .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`100` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/retry: .. rst-class:: ansible-option-title **retry** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Number of times to try establishing connection to device .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/snmp_auth_passphrase: .. rst-class:: ansible-option-title **snmp_auth_passphrase** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Auth Pass phrase for SNMP .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/snmp_auth_protocol: .. rst-class:: ansible-option-title **snmp_auth_protocol** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
SNMP auth protocol (SHA/MD5) .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/snmp_mode: .. rst-class:: ansible-option-title **snmp_mode** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Mode of SNMP (AUTHPRIV/AUTHNOPRIV/NOAUTHNOPRIV) .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/snmp_priv_passphrase: .. rst-class:: ansible-option-title **snmp_priv_passphrase** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Pass phrase for SNMP privacy .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/snmp_priv_protocol: .. rst-class:: ansible-option-title **snmp_priv_protocol** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
SNMP privacy protocol (DES/AES128) .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/snmp_ro_community: .. rst-class:: ansible-option-title **snmp_ro_community** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Snmp RO community of the devices to be discovered .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/snmp_ro_community_desc: .. rst-class:: ansible-option-title **snmp_ro_community_desc** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Description for Snmp RO community .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/snmp_rw_community: .. rst-class:: ansible-option-title **snmp_rw_community** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Snmp RW community of the devices to be discovered .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/snmp_rw_community_desc: .. rst-class:: ansible-option-title **snmp_rw_community_desc** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Description for Snmp RW community .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/snmp_username: .. rst-class:: ansible-option-title **snmp_username** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
SNMP username of the device .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/snmp_version: .. rst-class:: ansible-option-title **snmp_version** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Version of SNMP (v2/v3) .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/start_index: .. rst-class:: ansible-option-title **start_index** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Start index for the header in fetching SNMP v2 credentials .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`1` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/timeout: .. rst-class:: ansible-option-title **timeout** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Time to wait for device response in seconds .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config/username_list: .. rst-class:: ansible-option-title **username_list** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
List of passwords for the CLI credentials .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-config_verify: .. rst-class:: ansible-option-title **config_verify** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Set to True to verify the Cisco DNA Center config after applying the playbook config. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-dnac_debug: .. rst-class:: ansible-option-title **dnac_debug** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag for Cisco DNA Center SDK to enable debugging. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-dnac_host: .. rst-class:: ansible-option-title **dnac_host** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` / :ansible-option-required:`required` .. raw:: html
- .. raw:: html
The Cisco DNA Center hostname. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-dnac_log: .. rst-class:: ansible-option-title **dnac_log** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag to enable/disable playbook execution logging. When true and dnac\_log\_file\_path is provided, - Create the log file at the execution location with the specified name. When true and dnac\_log\_file\_path is not provided, - Create the log file at the execution location with the name 'dnac.log'. When false, - Logging is disabled. If the log file doesn't exist, - It is created in append or write mode based on the "dnac\_log\_append" flag. If the log file exists, - It is overwritten or appended based on the "dnac\_log\_append" flag. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-dnac_log_append: .. rst-class:: ansible-option-title **dnac_log_append** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Determines the mode of the file. Set to True for 'append' mode. Set to False for 'write' mode. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-dnac_log_file_path: .. rst-class:: ansible-option-title **dnac_log_file_path** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Governs logging. Logs are recorded if dnac\_log is True. If path is not specified, - When 'dnac\_log\_append' is True, 'dnac.log' is generated in the current Ansible directory; logs are appended. - When 'dnac\_log\_append' is False, 'dnac.log' is generated; logs are overwritten. If path is specified, - When 'dnac\_log\_append' is True, the file opens in append mode. - When 'dnac\_log\_append' is False, the file opens in write (w) mode. - In shared file scenarios, without append mode, content is overwritten after each module execution. - For a shared log file, set append to False for the 1st module (to overwrite); for subsequent modules, set append to True. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"dnac.log"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-dnac_log_level: .. rst-class:: ansible-option-title **dnac_log_level** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Sets the threshold for log level. Messages with a level equal to or higher than this will be logged. Levels are listed in order of severity [CRITICAL, ERROR, WARNING, INFO, DEBUG]. CRITICAL indicates serious errors halting the program. Displays only CRITICAL messages. ERROR indicates problems preventing a function. Displays ERROR and CRITICAL messages. WARNING indicates potential future issues. Displays WARNING, ERROR, CRITICAL messages. INFO tracks normal operation. Displays INFO, WARNING, ERROR, CRITICAL messages. DEBUG provides detailed diagnostic info. Displays all log messages. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"WARNING"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-dnac_password: .. rst-class:: ansible-option-title **dnac_password** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The Cisco DNA Center password to authenticate. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-dnac_port: .. rst-class:: ansible-option-title **dnac_port** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The Cisco DNA Center port. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"443"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-dnac_username: .. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-user: .. rst-class:: ansible-option-title **dnac_username** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: user` .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The Cisco DNA Center username to authenticate. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"admin"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-dnac_verify: .. rst-class:: ansible-option-title **dnac_verify** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag to enable or disable SSL certificate verification. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-dnac_version: .. rst-class:: ansible-option-title **dnac_version** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Informs the SDK which version of Cisco DNA Center to use. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"2.2.3.3"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-state: .. rst-class:: ansible-option-title **state** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The state of DNAC after module completion. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry-default:`"merged"` :ansible-option-choices-default-mark:`← (default)` - :ansible-option-choices-entry:`"deleted"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__parameter-validate_response_schema: .. rst-class:: ansible-option-title **validate_response_schema** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag for Cisco DNA Center SDK to enable the validation of request bodies against a JSON schema. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` .. raw:: html
.. Attributes .. Notes Notes ----- .. note:: - SDK Method used are discovery.Discovery.get\_all\_global\_credentials\_v2, discovery.Discovery.start\_discovery, task.Task.get\_task\_by\_id, discovery.Discovery.get\_discoveries\_by\_range, discovery.Discovery.get\_discovered\_network\_devices\_by\_discovery\_id', discovery.Discovery.delete\_discovery\_by\_id discovery.Discovery.delete\_all\_discovery discovery.Discovery.get\_count\_of\_all\_discovery\_jobs - Paths used are get /dna/intent/api/v2/global-credential post /dna/intent/api/v1/discovery get /dna/intent/api/v1/task/{taskId} get /dna/intent/api/v1/discovery/{startIndex}/{recordsToReturn} get /dna/intent/api/v1/discovery/{id}/network-device delete /dna/intent/api/v1/discovery/{id} delete /dna/intent/api/v1/delete get /dna/intent/api/v1/discovery/count - Does not support \ :literal:`check\_mode`\ - The plugin runs on the control node and does not use any ansible connection plugins, but instead the embedded connection manager from Cisco DNAC SDK - The parameters starting with dnac\_ are used by the Cisco DNAC Python SDK to establish the connection .. Seealso .. Examples Examples -------- .. code-block:: yaml+jinja - name: Execute discovery devices cisco.dnac.discovery_intent: dnac_host: "{{dnac_host}}" dnac_username: "{{dnac_username}}" dnac_password: "{{dnac_password}}" dnac_verify: "{{dnac_verify}}" dnac_port: "{{dnac_port}}" dnac_version: "{{dnac_version}}" dnac_debug: "{{dnac_debug}}" dnac_log: True dnac_log_level: "{{dnac_log_level}}" state: merged config_verify: True config: - ip_address_list: list discovery_type: string cdp_level: string lldp_level: string start_index: integer enable_password_list: list records_to_return: integer http_read_credential: dict http_write_credential: dict ip_filter_list: list discovery_name: string password_list: list preffered_mgmt_ip_method: string protocol_order: string retry: integer snmp_auth_passphrase: string snmp_auth_protocol: string snmp_mode: string snmp_priv_passphrase: string snmp_priv_protocol: string snmp_ro_community: string snmp_ro_community_desc: string snmp_rw_community: string snmp_rw_community_desc: string snmp_username: string snmp_version: string timeout: integer username_list: list cli_cred_len: integer - name: Delete disovery by name cisco.dnac.discovery_intent: dnac_host: "{{dnac_host}}" dnac_username: "{{dnac_username}}" dnac_password: "{{dnac_password}}" dnac_verify: "{{dnac_verify}}" dnac_port: "{{dnac_port}}" dnac_version: "{{dnac_version}}" dnac_debug: "{{dnac_debug}}" dnac_log: True dnac_log_level: "{{dnac_log_level}}" state: deleted config_verify: True config: - discovery_name: string .. Facts .. Return values Return Values ------------- Common return values are documented :ref:`here `, the following are the fields unique to this module: .. rst-class:: ansible-option-table .. list-table:: :width: 100% :widths: auto :header-rows: 1 * - Key - Description * - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__return-response_1: .. rst-class:: ansible-option-title **response_1** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
A dictionary with the response returned by the Cisco DNAC Python SDK .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` always .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`"{\\n \\"response\\":\\n {\\n \\"response\\": String,\\n \\"version\\": String\\n },\\n \\"msg\\": String\\n}\\n"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__return-response_2: .. rst-class:: ansible-option-title **response_2** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
A list with the response returned by the Cisco DNAC Python SDK .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` always .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`["{\\n \\"response\\": []", "\\n \\"msg\\": String\\n}\\n"]` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.discovery_intent_module__return-response_3: .. rst-class:: ansible-option-title **response_3** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
A string with the response returned by the Cisco DNAC Python SDK .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` always .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`"{\\n \\"response\\": String,\\n \\"msg\\": String\\n}\\n"` .. raw:: html
.. Status (Presently only deprecated) .. Authors Authors ~~~~~~~ - Abinash Mishra (@abimishr) Phan Nguyen (phannguy) .. Extra links Collection links ~~~~~~~~~~~~~~~~ .. raw:: html .. Parsing errors