cisco.dnac.network_device_info module -- Information module for Network Device Info
Note
This module is part of the cisco.dnac collection (version 6.27.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.network_device_info.
New in cisco.dnac 3.1.0
Synopsis
This module represents an alias of the module network_device_v1_info
Note
This module has a corresponding action plugin.
Requirements
The below requirements are needed on the host that executes this module.
dnacentersdk >= 2.4.9
python >= 3.5
Parameters
Parameter |
Comments |
|---|---|
AssociatedWlcIp query parameter. |
|
CollectionInterval query parameter. |
|
CollectionStatus query parameter. |
|
DeviceSupportLevel query parameter. |
|
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:`"2.3.7.6"` |
|
ErrorCode query parameter. |
|
ErrorDescription query parameter. |
|
Family query parameter. |
|
Additional headers. |
|
Hostname query parameter. |
|
Id query parameter. Accepts comma separated ids and return list of network-devices for the given ids. If invalid or not-found ids are provided, null entry will be returned in the list. |
|
License.name query parameter. |
|
License.status query parameter. |
|
License.type query parameter. |
|
Limit query parameter. The number of records to show for this page. Min 1, Max 500. |
|
Location query parameter. |
|
LocationName query parameter. |
|
MacAddress query parameter. |
|
ManagementIpAddress query parameter. |
|
Module+equpimenttype query parameter. |
|
Module+name query parameter. |
|
Module+operationstatecode query parameter. |
|
Module+partnumber query parameter. |
|
Module+servicestate query parameter. |
|
Module+vendorequipmenttype query parameter. |
|
NotSyncedForMinutes query parameter. |
|
Offset query parameter. Offset >= 1 X gives results from Xth device onwards. |
|
PlatformId query parameter. |
|
ReachabilityStatus query parameter. |
|
Role query parameter. |
|
SerialNumber query parameter. |
|
Series query parameter. |
|
SoftwareType query parameter. |
|
SoftwareVersion query parameter. |
|
Type query parameter. |
|
UpTime query parameter. |
|
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.get_device_by_id_v1, devices.Devices.get_device_list_v1,
Paths used are get /dna/intent/api/v1/network-device, get /dna/intent/api/v1/network-device/{id},
It should be noted that this module is an alias of network_device_v1_info
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 GetDeviceByIDV1
Complete reference of the GetDeviceByIDV1 API.
- Cisco DNA Center documentation for Devices GetDeviceListV1
Complete reference of the GetDeviceListV1 API.
Examples
- name: Get all Network Device Info
cisco.dnac.network_device_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}}"
hostname: []
managementIpAddress: []
macAddress: []
locationName: []
serialNumber: []
location: []
family: []
type: []
series: []
collectionStatus: []
collectionInterval: []
notSyncedForMinutes: []
errorCode: []
errorDescription: []
softwareVersion: []
softwareType: []
platformId: []
role: []
reachabilityStatus: []
upTime: []
associatedWlcIp: []
license_name: []
license_type: []
license_status: []
module_name: []
module_equpimenttype: []
module_servicestate: []
module_vendorequipmenttype: []
module_partnumber: []
module_operationstatecode: []
id: string
deviceSupportLevel: string
offset: 0
limit: 0
register: result
- name: Get Network Device Info by id
cisco.dnac.network_device_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}}"
id: string
register: result
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
|---|---|