cisco.dnac.discoverys_jobs_info module -- Information module for Discoverys Jobs
Note
This module is part of the cisco.dnac collection (version 6.46.0).
To install it, use: ansible-galaxy collection install cisco.dnac.
You need further requirements to be able to use this module,
see Requirements for details.
To use it in a playbook, specify: cisco.dnac.discoverys_jobs_info.
New in cisco.dnac 6.46.0
Synopsis
Get all Discoverys Jobs.
Get Discoverys Jobs by id. - > API to get all the discovery job details by discovery id. A discovery can have multiple discovery jobs, created against the same discovery id.
This API retrieves the details of a specific discovery job using the given job id and discovery id.
Note
This module has a corresponding action plugin.
Requirements
The below requirements are needed on the host that executes this module.
dnacentersdk >= 2.11.0
python >= 3.12
Parameters
Parameter |
Comments |
|---|---|
DiscoveryId path parameter. The id of the discovery. |
|
Flag for Cisco DNA Center SDK to enable debugging. Choices: |
|
The Cisco DNA Center hostname. |
|
The Cisco DNA Center password to authenticate. |
|
The Cisco DNA Center port. Default: :ansible-option-default:`443` |
|
The Cisco DNA Center username to authenticate. Default: :ansible-option-default:`"admin"` |
|
Flag to enable or disable SSL certificate verification. Choices: |
|
Informs the SDK which version of Cisco DNA Center to use. Default: :ansible-option-default:`"3.1.6.0"` |
|
Additional headers. |
|
Id path parameter. The id of the discovery. |
|
JobId path parameter. The id of the discovery job. |
|
Limit query parameter. The number of records to show for this page. |
|
Offset query parameter. The first record to show for this page; the first record is numbered 1. |
|
OrderBy query parameter. To fetch the latest discovery job. Use the orderBy query parameter with values such as startTime or endTime. By default, jobs are ordered by startTime in descending order to display the most recent entries first. |
|
Flag for Cisco DNA Center SDK to enable the validation of request bodies against a JSON schema. Choices: |
Notes
Note
SDK Method used are devices.Devices.fetches_all_the_discovery_job_details_by_discovery_id, devices.Devices.fetches_the_discovery_job_details_for_the_given_job_id,
Paths used are get /dna/intent/api/v1/discoverys/{discoveryId}/jobs/{jobId}, get /dna/intent/api/v1/discoverys/{id}/jobs,
Supports
check_modeThe 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
See Also
See also
- Cisco DNA Center documentation for Devices FetchesAllTheDiscoveryJobDetailsByDiscoveryId
Complete reference of the FetchesAllTheDiscoveryJobDetailsByDiscoveryId API.
- Cisco DNA Center documentation for Devices FetchesTheDiscoveryJobDetailsForTheGivenJobId
Complete reference of the FetchesTheDiscoveryJobDetailsForTheGivenJobId API.
Examples
---
- name: Get all Discoverys Jobs
cisco.dnac.discoverys_jobs_info:
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}}"
headers: "{{my_headers | from_json}}"
jobId: string
limit: 0
offset: 0
orderBy: string
id: string
register: result
- name: Get Discoverys Jobs by id
cisco.dnac.discoverys_jobs_info:
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}}"
headers: "{{my_headers | from_json}}"
discoveryId: string
jobId: string
register: result
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
|---|---|