cisco.dnac.pnp_device module – Resource module for Pnp Device

Note

This module is part of the cisco.dnac collection (version 6.5.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install cisco.dnac.

To use it in a playbook, specify: cisco.dnac.pnp_device.

New in version 3.1.0: of cisco.dnac

Synopsis

  • Manage operations create, update and delete of the resource Pnp Device.

  • Adds a device to the PnP database.

  • Deletes specified device from PnP database.

  • Updates device details specified by device id in PnP database.

Note

This module has a corresponding action plugin.

Requirements

The below requirements are needed on the host that executes this module.

  • dnacentersdk >= 2.5.0

  • python >= 3.5

Parameters

Parameter

Comments

_id

string

Pnp Device’s _id.

deviceInfo

dictionary

Pnp Device’s deviceInfo.

aaaCredentials

dictionary

Pnp Device’s aaaCredentials.

password

string

Pnp Device’s password.

username

string

Pnp Device’s username.

addedOn

integer

Pnp Device’s addedOn.

addnMacAddrs

list / elements=string

Pnp Device’s addnMacAddrs.

agentType

string

Pnp Device’s agentType.

authenticatedSudiSerialNo

string

Pnp Device’s authenticatedSudiSerialNo.

authStatus

string

Pnp Device’s authStatus.

capabilitiesSupported

list / elements=string

Pnp Device’s capabilitiesSupported.

cmState

string

Pnp Device’s cmState.

description

string

Pnp Device’s description.

deviceSudiSerialNos

list / elements=string

Pnp Device’s deviceSudiSerialNos.

deviceType

string

Pnp Device’s deviceType.

featuresSupported

list / elements=string

Pnp Device’s featuresSupported.

fileSystemList

list / elements=dictionary

Pnp Device’s fileSystemList.

freespace

integer

Pnp Device’s freespace.

name

string

Pnp Device’s name.

readable

boolean

Readable flag.

Choices:

  • no

  • yes

size

integer

Pnp Device’s size.

type

string

Pnp Device’s type.

writeable

boolean

Writeable flag.

Choices:

  • no

  • yes

firstContact

integer

Pnp Device’s firstContact.

hostname

string

Pnp Device’s hostname.

httpHeaders

list / elements=dictionary

Pnp Device’s httpHeaders.

key

string

Pnp Device’s key.

value

string

Pnp Device’s value.

imageFile

string

Pnp Device’s imageFile.

imageVersion

string

Pnp Device’s imageVersion.

ipInterfaces

list / elements=dictionary

Pnp Device’s ipInterfaces.

ipv4Address

dictionary

Pnp Device’s ipv4Address.

ipv6AddressList

list / elements=dictionary

Pnp Device’s ipv6AddressList.

macAddress

string

Pnp Device’s macAddress.

name

string

Pnp Device’s name.

status

string

Pnp Device’s status.

lastContact

integer

Pnp Device’s lastContact.

lastSyncTime

integer

Pnp Device’s lastSyncTime.

lastUpdateOn

integer

Pnp Device’s lastUpdateOn.

location

dictionary

Pnp Device’s location.

address

string

Pnp Device’s address.

altitude

string

Pnp Device’s altitude.

latitude

string

Pnp Device’s latitude.

longitude

string

Pnp Device’s longitude.

siteId

string

Pnp Device’s siteId.

macAddress

string

Pnp Device’s macAddress.

mode

string

Pnp Device’s mode.

name

string

Pnp Device’s name.

list / elements=dictionary

Pnp Device’s neighborLinks.

string

Pnp Device’s localInterfaceName.

string

Pnp Device’s localMacAddress.

string

Pnp Device’s localShortInterfaceName.

string

Pnp Device’s remoteDeviceName.

string

Pnp Device’s remoteInterfaceName.

string

Pnp Device’s remoteMacAddress.

string

Pnp Device’s remotePlatform.

string

Pnp Device’s remoteShortInterfaceName.

string

Pnp Device’s remoteVersion.

onbState

string

Pnp Device’s onbState.

pid

string

Pnp Device’s pid.

pnpProfileList

list / elements=dictionary

Pnp Device’s pnpProfileList.

createdBy

string

Pnp Device’s createdBy.

discoveryCreated

boolean

DiscoveryCreated flag.

Choices:

  • no

  • yes

primaryEndpoint

dictionary

Pnp Device’s primaryEndpoint.

certificate

string

Pnp Device’s certificate.

fqdn

string

Pnp Device’s fqdn.

ipv4Address

dictionary

Pnp Device’s ipv4Address.

ipv6Address

dictionary

Pnp Device’s ipv6Address.

port

integer

Pnp Device’s port.

protocol

string

Pnp Device’s protocol.

profileName

string

Pnp Device’s profileName.

secondaryEndpoint

dictionary

Pnp Device’s secondaryEndpoint.

certificate

string

Pnp Device’s certificate.

fqdn

string

Pnp Device’s fqdn.

ipv4Address

dictionary

Pnp Device’s ipv4Address.

ipv6Address

dictionary

Pnp Device’s ipv6Address.

port

integer

Pnp Device’s port.

protocol

string

Pnp Device’s protocol.

populateInventory

boolean

PopulateInventory flag.

Choices:

  • no

  • yes

preWorkflowCliOuputs

list / elements=dictionary

Pnp Device’s preWorkflowCliOuputs.

cli

string

Pnp Device’s cli.

cliOutput

string

Pnp Device’s cliOutput.

projectId

string

Pnp Device’s projectId.

projectName

string

Pnp Device’s projectName.

reloadRequested

boolean

ReloadRequested flag.

Choices:

  • no

  • yes

serialNumber

string

Pnp Device’s serialNumber.

smartAccountId

string

Pnp Device’s smartAccountId.

source

string

Pnp Device’s source.

stack

boolean

Stack flag.

Choices:

  • no

  • yes

stackInfo

dictionary

Pnp Device’s stackInfo.

isFullRing

boolean

IsFullRing flag.

Choices:

  • no

  • yes

stackMemberList

list / elements=dictionary

Pnp Device’s stackMemberList.

hardwareVersion

string

Pnp Device’s hardwareVersion.

licenseLevel

string

Pnp Device’s licenseLevel.

licenseType

string

Pnp Device’s licenseType.

macAddress

string

Pnp Device’s macAddress.

pid

string

Pnp Device’s pid.

priority

integer

Pnp Device’s priority.

role

string

Pnp Device’s role.

serialNumber

string

Pnp Device’s serialNumber.

softwareVersion

string

Pnp Device’s softwareVersion.

stackNumber

integer

Pnp Device’s stackNumber.

state

string

Pnp Device’s state.

sudiSerialNumber

string

Pnp Device’s sudiSerialNumber.

stackRingProtocol

string

Pnp Device’s stackRingProtocol.

supportsStackWorkflows

boolean

SupportsStackWorkflows flag.

Choices:

  • no

  • yes

totalMemberCount

integer

Pnp Device’s totalMemberCount.

validLicenseLevels

list / elements=string

Pnp Device’s validLicenseLevels.

state

string

Pnp Device’s state.

sudiRequired

boolean

SudiRequired flag.

Choices:

  • no

  • yes

tags

dictionary

Pnp Device’s tags.

userSudiSerialNos

list / elements=string

Pnp Device’s userSudiSerialNos.

virtualAccountId

string

Pnp Device’s virtualAccountId.

workflowId

string

Pnp Device’s workflowId.

workflowName

string

Pnp Device’s workflowName.

dnac_debug

boolean

Flag for Cisco DNA Center SDK to enable debugging.

Choices:

  • no ← (default)

  • yes

dnac_host

string / required

The Cisco DNA Center hostname.

dnac_password

string

The Cisco DNA Center password to authenticate.

dnac_port

integer

The Cisco DNA Center port.

Default: 443

dnac_username

aliases: user

string

The Cisco DNA Center username to authenticate.

Default: “admin”

dnac_verify

boolean

Flag to enable or disable SSL certificate verification.

Choices:

  • no

  • yes ← (default)

dnac_version

string

Informs the SDK which version of Cisco DNA Center to use.

Default: “2.3.3.0”

id

string

Id path parameter.

runSummaryList

list / elements=dictionary

Pnp Device’s runSummaryList.

details

string

Pnp Device’s details.

errorFlag

boolean

ErrorFlag flag.

Choices:

  • no

  • yes

historyTaskInfo

dictionary

Pnp Device’s historyTaskInfo.

addnDetails

list / elements=dictionary

Pnp Device’s addnDetails.

key

string

Pnp Device’s key.

value

string

Pnp Device’s value.

name

string

Pnp Device’s name.

timeTaken

integer

Pnp Device’s timeTaken.

type

string

Pnp Device’s type.

workItemList

list / elements=dictionary

Pnp Device’s workItemList.

command

string

Pnp Device’s command.

endTime

integer

Pnp Device’s endTime.

outputStr

string

Pnp Device’s outputStr.

startTime

integer

Pnp Device’s startTime.

state

string

Pnp Device’s state.

timeTaken

integer

Pnp Device’s timeTaken.

timestamp

integer

Pnp Device’s timestamp.

systemResetWorkflow

dictionary

Pnp Device’s systemResetWorkflow.

_id

string

Pnp Device’s _id.

addedOn

integer

Pnp Device’s addedOn.

addToInventory

boolean

AddToInventory flag.

Choices:

  • no

  • yes

configId

string

Pnp Device’s configId.

currTaskIdx

integer

Pnp Device’s currTaskIdx.

description

string

Pnp Device’s description.

endTime

integer

Pnp Device’s endTime.

execTime

integer

Pnp Device’s execTime.

imageId

string

Pnp Device’s imageId.

instanceType

string

Pnp Device’s instanceType.

lastupdateOn

integer

Pnp Device’s lastupdateOn.

name

string

Pnp Device’s name.

startTime

integer

Pnp Device’s startTime.

state

string

Pnp Device’s state.

tasks

list / elements=dictionary

Pnp Device’s tasks.

currWorkItemIdx

integer

Pnp Device’s currWorkItemIdx.

endTime

integer

Pnp Device’s endTime.

name

string

Pnp Device’s name.

startTime

integer

Pnp Device’s startTime.

state

string

Pnp Device’s state.

taskSeqNo

integer

Pnp Device’s taskSeqNo.

timeTaken

integer

Pnp Device’s timeTaken.

type

string

Pnp Device’s type.

workItemList

list / elements=dictionary

Pnp Device’s workItemList.

command

string

Pnp Device’s command.

endTime

integer

Pnp Device’s endTime.

outputStr

string

Pnp Device’s outputStr.

startTime

integer

Pnp Device’s startTime.

state

string

Pnp Device’s state.

timeTaken

integer

Pnp Device’s timeTaken.

tenantId

string

Pnp Device’s tenantId.

type

string

Pnp Device’s type.

useState

string

Pnp Device’s useState.

version

integer

Pnp Device’s version.

systemWorkflow

dictionary

Pnp Device’s systemWorkflow.

_id

string

Pnp Device’s _id.

addedOn

integer

Pnp Device’s addedOn.

addToInventory

boolean

AddToInventory flag.

Choices:

  • no

  • yes

configId

string

Pnp Device’s configId.

currTaskIdx

integer

Pnp Device’s currTaskIdx.

description

string

Pnp Device’s description.

endTime

integer

Pnp Device’s endTime.

execTime

integer

Pnp Device’s execTime.

imageId

string

Pnp Device’s imageId.

instanceType

string

Pnp Device’s instanceType.

lastupdateOn

integer

Pnp Device’s lastupdateOn.

name

string

Pnp Device’s name.

startTime

integer

Pnp Device’s startTime.

state

string

Pnp Device’s state.

tasks

list / elements=dictionary

Pnp Device’s tasks.

currWorkItemIdx

integer

Pnp Device’s currWorkItemIdx.

endTime

integer

Pnp Device’s endTime.

name

string

Pnp Device’s name.

startTime

integer

Pnp Device’s startTime.

state

string

Pnp Device’s state.

taskSeqNo

integer

Pnp Device’s taskSeqNo.

timeTaken

integer

Pnp Device’s timeTaken.

type

string

Pnp Device’s type.

workItemList

list / elements=dictionary

Pnp Device’s workItemList.

command

string

Pnp Device’s command.

endTime

integer

Pnp Device’s endTime.

outputStr

string

Pnp Device’s outputStr.

startTime

integer

Pnp Device’s startTime.

state

string

Pnp Device’s state.

timeTaken

integer

Pnp Device’s timeTaken.

tenantId

string

Pnp Device’s tenantId.

type

string

Pnp Device’s type.

useState

string

Pnp Device’s useState.

version

integer

Pnp Device’s version.

tenantId

string

Pnp Device’s tenantId.

validate_response_schema

boolean

Flag for Cisco DNA Center SDK to enable the validation of request bodies against a JSON schema.

Choices:

  • no

  • yes ← (default)

version

integer

Pnp Device’s version.

workflow

dictionary

Pnp Device’s workflow.

_id

string

Pnp Device’s _id.

addedOn

integer

Pnp Device’s addedOn.

addToInventory

boolean

AddToInventory flag.

Choices:

  • no

  • yes

configId

string

Pnp Device’s configId.

currTaskIdx

integer

Pnp Device’s currTaskIdx.

description

string

Pnp Device’s description.

endTime

integer

Pnp Device’s endTime.

execTime

integer

Pnp Device’s execTime.

imageId

string

Pnp Device’s imageId.

instanceType

string

Pnp Device’s instanceType.

lastupdateOn

integer

Pnp Device’s lastupdateOn.

name

string

Pnp Device’s name.

startTime

integer

Pnp Device’s startTime.

state

string

Pnp Device’s state.

tasks

list / elements=dictionary

Pnp Device’s tasks.

currWorkItemIdx

integer

Pnp Device’s currWorkItemIdx.

endTime

integer

Pnp Device’s endTime.

name

string

Pnp Device’s name.

startTime

integer

Pnp Device’s startTime.

state

string

Pnp Device’s state.

taskSeqNo

integer

Pnp Device’s taskSeqNo.

timeTaken

integer

Pnp Device’s timeTaken.

type

string

Pnp Device’s type.

workItemList

list / elements=dictionary

Pnp Device’s workItemList.

command

string

Pnp Device’s command.

endTime

integer

Pnp Device’s endTime.

outputStr

string

Pnp Device’s outputStr.

startTime

integer

Pnp Device’s startTime.

state

string

Pnp Device’s state.

timeTaken

integer

Pnp Device’s timeTaken.

tenantId

string

Pnp Device’s tenantId.

type

string

Pnp Device’s type.

useState

string

Pnp Device’s useState.

version

integer

Pnp Device’s version.

workflowParameters

dictionary

Pnp Device’s workflowParameters.

configList

list / elements=dictionary

Pnp Device’s configList.

configId

string

Pnp Device’s configId.

configParameters

list / elements=dictionary

Pnp Device’s configParameters.

key

string

Pnp Device’s key.

value

string

Pnp Device’s value.

licenseLevel

string

Pnp Device’s licenseLevel.

licenseType

string

Pnp Device’s licenseType.

topOfStackSerialNumber

string

Pnp Device’s topOfStackSerialNumber.

Notes

Note

  • SDK Method used are device_onboarding_pnp.DeviceOnboardingPnp.add_device, device_onboarding_pnp.DeviceOnboardingPnp.delete_device_by_id_from_pnp, device_onboarding_pnp.DeviceOnboardingPnp.update_device,

  • Paths used are post /dna/intent/api/v1/onboarding/pnp-device, delete /dna/intent/api/v1/onboarding/pnp-device/{id}, put /dna/intent/api/v1/onboarding/pnp-device/{id},

  • Does not support 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

Examples

- name: Create
  cisco.dnac.pnp_device:
    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}}"
    state: present
    _id: string
    deviceInfo:
      aaaCredentials:
        password: string
        username: string
      addedOn: 0
      addnMacAddrs:
      - string
      agentType: string
      authStatus: string
      authenticatedSudiSerialNo: string
      capabilitiesSupported:
      - string
      cmState: string
      description: string
      deviceSudiSerialNos:
      - string
      deviceType: string
      featuresSupported:
      - string
      fileSystemList:
      - freespace: 0
        name: string
        readable: true
        size: 0
        type: string
        writeable: true
      firstContact: 0
      hostname: string
      httpHeaders:
      - key: string
        value: string
      imageFile: string
      imageVersion: string
      ipInterfaces:
      - ipv4Address: {}
        ipv6AddressList:
        - {}
        macAddress: string
        name: string
        status: string
      lastContact: 0
      lastSyncTime: 0
      lastUpdateOn: 0
      location:
        address: string
        altitude: string
        latitude: string
        longitude: string
        siteId: string
      macAddress: string
      mode: string
      name: string
      neighborLinks:
      - localInterfaceName: string
        localMacAddress: string
        localShortInterfaceName: string
        remoteDeviceName: string
        remoteInterfaceName: string
        remoteMacAddress: string
        remotePlatform: string
        remoteShortInterfaceName: string
        remoteVersion: string
      onbState: string
      pid: string
      pnpProfileList:
      - createdBy: string
        discoveryCreated: true
        primaryEndpoint:
          certificate: string
          fqdn: string
          ipv4Address: {}
          ipv6Address: {}
          port: 0
          protocol: string
        profileName: string
        secondaryEndpoint:
          certificate: string
          fqdn: string
          ipv4Address: {}
          ipv6Address: {}
          port: 0
          protocol: string
      populateInventory: true
      preWorkflowCliOuputs:
      - cli: string
        cliOutput: string
      projectId: string
      projectName: string
      reloadRequested: true
      serialNumber: string
      smartAccountId: string
      source: string
      stack: true
      stackInfo:
        isFullRing: true
        stackMemberList:
        - hardwareVersion: string
          licenseLevel: string
          licenseType: string
          macAddress: string
          pid: string
          priority: 0
          role: string
          serialNumber: string
          softwareVersion: string
          stackNumber: 0
          state: string
          sudiSerialNumber: string
        stackRingProtocol: string
        supportsStackWorkflows: true
        totalMemberCount: 0
        validLicenseLevels:
        - string
      state: string
      sudiRequired: true
      tags: {}
      userSudiSerialNos:
      - string
      virtualAccountId: string
      workflowId: string
      workflowName: string
    runSummaryList:
    - details: string
      errorFlag: true
      historyTaskInfo:
        addnDetails:
        - key: string
          value: string
        name: string
        timeTaken: 0
        type: string
        workItemList:
        - command: string
          endTime: 0
          outputStr: string
          startTime: 0
          state: string
          timeTaken: 0
      timestamp: 0
    systemResetWorkflow:
      _id: string
      addToInventory: true
      addedOn: 0
      configId: string
      currTaskIdx: 0
      description: string
      endTime: 0
      execTime: 0
      imageId: string
      instanceType: string
      lastupdateOn: 0
      name: string
      startTime: 0
      state: string
      tasks:
      - currWorkItemIdx: 0
        endTime: 0
        name: string
        startTime: 0
        state: string
        taskSeqNo: 0
        timeTaken: 0
        type: string
        workItemList:
        - command: string
          endTime: 0
          outputStr: string
          startTime: 0
          state: string
          timeTaken: 0
      tenantId: string
      type: string
      useState: string
      version: 0
    systemWorkflow:
      _id: string
      addToInventory: true
      addedOn: 0
      configId: string
      currTaskIdx: 0
      description: string
      endTime: 0
      execTime: 0
      imageId: string
      instanceType: string
      lastupdateOn: 0
      name: string
      startTime: 0
      state: string
      tasks:
      - currWorkItemIdx: 0
        endTime: 0
        name: string
        startTime: 0
        state: string
        taskSeqNo: 0
        timeTaken: 0
        type: string
        workItemList:
        - command: string
          endTime: 0
          outputStr: string
          startTime: 0
          state: string
          timeTaken: 0
      tenantId: string
      type: string
      useState: string
      version: 0
    tenantId: string
    version: 0
    workflow:
      _id: string
      addToInventory: true
      addedOn: 0
      configId: string
      currTaskIdx: 0
      description: string
      endTime: 0
      execTime: 0
      imageId: string
      instanceType: string
      lastupdateOn: 0
      name: string
      startTime: 0
      state: string
      tasks:
      - currWorkItemIdx: 0
        endTime: 0
        name: string
        startTime: 0
        state: string
        taskSeqNo: 0
        timeTaken: 0
        type: string
        workItemList:
        - command: string
          endTime: 0
          outputStr: string
          startTime: 0
          state: string
          timeTaken: 0
      tenantId: string
      type: string
      useState: string
      version: 0
    workflowParameters:
      configList:
      - configId: string
        configParameters:
        - key: string
          value: string
      licenseLevel: string
      licenseType: string
      topOfStackSerialNumber: string

- name: Update by id
  cisco.dnac.pnp_device:
    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}}"
    state: present
    _id: string
    deviceInfo:
      aaaCredentials:
        password: string
        username: string
      addedOn: 0
      addnMacAddrs:
      - string
      agentType: string
      authStatus: string
      authenticatedSudiSerialNo: string
      capabilitiesSupported:
      - string
      cmState: string
      description: string
      deviceSudiSerialNos:
      - string
      deviceType: string
      featuresSupported:
      - string
      fileSystemList:
      - freespace: 0
        name: string
        readable: true
        size: 0
        type: string
        writeable: true
      firstContact: 0
      hostname: string
      httpHeaders:
      - key: string
        value: string
      imageFile: string
      imageVersion: string
      ipInterfaces:
      - ipv4Address: {}
        ipv6AddressList:
        - {}
        macAddress: string
        name: string
        status: string
      lastContact: 0
      lastSyncTime: 0
      lastUpdateOn: 0
      location:
        address: string
        altitude: string
        latitude: string
        longitude: string
        siteId: string
      macAddress: string
      mode: string
      name: string
      neighborLinks:
      - localInterfaceName: string
        localMacAddress: string
        localShortInterfaceName: string
        remoteDeviceName: string
        remoteInterfaceName: string
        remoteMacAddress: string
        remotePlatform: string
        remoteShortInterfaceName: string
        remoteVersion: string
      onbState: string
      pid: string
      pnpProfileList:
      - createdBy: string
        discoveryCreated: true
        primaryEndpoint:
          certificate: string
          fqdn: string
          ipv4Address: {}
          ipv6Address: {}
          port: 0
          protocol: string
        profileName: string
        secondaryEndpoint:
          certificate: string
          fqdn: string
          ipv4Address: {}
          ipv6Address: {}
          port: 0
          protocol: string
      populateInventory: true
      preWorkflowCliOuputs:
      - cli: string
        cliOutput: string
      projectId: string
      projectName: string
      reloadRequested: true
      serialNumber: string
      smartAccountId: string
      source: string
      stack: true
      stackInfo:
        isFullRing: true
        stackMemberList:
        - hardwareVersion: string
          licenseLevel: string
          licenseType: string
          macAddress: string
          pid: string
          priority: 0
          role: string
          serialNumber: string
          softwareVersion: string
          stackNumber: 0
          state: string
          sudiSerialNumber: string
        stackRingProtocol: string
        supportsStackWorkflows: true
        totalMemberCount: 0
        validLicenseLevels:
        - string
      state: string
      sudiRequired: true
      tags: {}
      userSudiSerialNos:
      - string
      virtualAccountId: string
      workflowId: string
      workflowName: string
    id: string
    runSummaryList:
    - details: string
      errorFlag: true
      historyTaskInfo:
        addnDetails:
        - key: string
          value: string
        name: string
        timeTaken: 0
        type: string
        workItemList:
        - command: string
          endTime: 0
          outputStr: string
          startTime: 0
          state: string
          timeTaken: 0
      timestamp: 0
    systemResetWorkflow:
      _id: string
      addToInventory: true
      addedOn: 0
      configId: string
      currTaskIdx: 0
      description: string
      endTime: 0
      execTime: 0
      imageId: string
      instanceType: string
      lastupdateOn: 0
      name: string
      startTime: 0
      state: string
      tasks:
      - currWorkItemIdx: 0
        endTime: 0
        name: string
        startTime: 0
        state: string
        taskSeqNo: 0
        timeTaken: 0
        type: string
        workItemList:
        - command: string
          endTime: 0
          outputStr: string
          startTime: 0
          state: string
          timeTaken: 0
      tenantId: string
      type: string
      useState: string
      version: 0
    systemWorkflow:
      _id: string
      addToInventory: true
      addedOn: 0
      configId: string
      currTaskIdx: 0
      description: string
      endTime: 0
      execTime: 0
      imageId: string
      instanceType: string
      lastupdateOn: 0
      name: string
      startTime: 0
      state: string
      tasks:
      - currWorkItemIdx: 0
        endTime: 0
        name: string
        startTime: 0
        state: string
        taskSeqNo: 0
        timeTaken: 0
        type: string
        workItemList:
        - command: string
          endTime: 0
          outputStr: string
          startTime: 0
          state: string
          timeTaken: 0
      tenantId: string
      type: string
      useState: string
      version: 0
    tenantId: string
    version: 0
    workflow:
      _id: string
      addToInventory: true
      addedOn: 0
      configId: string
      currTaskIdx: 0
      description: string
      endTime: 0
      execTime: 0
      imageId: string
      instanceType: string
      lastupdateOn: 0
      name: string
      startTime: 0
      state: string
      tasks:
      - currWorkItemIdx: 0
        endTime: 0
        name: string
        startTime: 0
        state: string
        taskSeqNo: 0
        timeTaken: 0
        type: string
        workItemList:
        - command: string
          endTime: 0
          outputStr: string
          startTime: 0
          state: string
          timeTaken: 0
      tenantId: string
      type: string
      useState: string
      version: 0
    workflowParameters:
      configList:
      - configId: string
        configParameters:
        - key: string
          value: string
      licenseLevel: string
      licenseType: string
      topOfStackSerialNumber: string

- name: Delete by id
  cisco.dnac.pnp_device:
    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}}"
    state: absent
    id: string

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

dnac_response

dictionary

A dictionary or list with the response returned by the Cisco DNAC Python SDK

Returned: always

Sample: “{\n \”_id\”: \”string\”,\n \”deviceInfo\”: {\n \”source\”: \”string\”,\n \”serialNumber\”: \”string\”,\n \”stack\”: true,\n \”mode\”: \”string\”,\n \”state\”: \”string\”,\n \”location\”: {\n \”siteId\”: \”string\”,\n \”address\”: \”string\”,\n \”latitude\”: \”string\”,\n \”longitude\”: \”string\”,\n \”altitude\”: \”string\”\n },\n \”description\”: \”string\”,\n \”onbState\”: \”string\”,\n \”authenticatedMicNumber\”: \”string\”,\n \”authenticatedSudiSerialNo\”: \”string\”,\n \”capabilitiesSupported\”: [\n \”string\”\n ],\n \”featuresSupported\”: [\n \”string\”\n ],\n \”cmState\”: \”string\”,\n \”firstContact\”: 0,\n \”lastContact\”: 0,\n \”macAddress\”: \”string\”,\n \”pid\”: \”string\”,\n \”deviceSudiSerialNos\”: [\n \”string\”\n ],\n \”lastUpdateOn\”: 0,\n \”workflowId\”: \”string\”,\n \”workflowName\”: \”string\”,\n \”projectId\”: \”string\”,\n \”projectName\”: \”string\”,\n \”deviceType\”: \”string\”,\n \”agentType\”: \”string\”,\n \”imageVersion\”: \”string\”,\n \”fileSystemList\”: [\n {\n \”type\”: \”string\”,\n \”writeable\”: true,\n \”freespace\”: 0,\n \”name\”: \”string\”,\n \”readable\”: true,\n \”size\”: 0\n }\n ],\n \”pnpProfileList\”: [\n {\n \”profileName\”: \”string\”,\n \”discoveryCreated\”: true,\n \”createdBy\”: \”string\”,\n \”primaryEndpoint\”: {\n \”port\”: 0,\n \”protocol\”: \”string\”,\n \”ipv4Address\”: {},\n \”ipv6Address\”: {},\n \”fqdn\”: \”string\”,\n \”certificate\”: \”string\”\n },\n \”secondaryEndpoint\”: {\n \”port\”: 0,\n \”protocol\”: \”string\”,\n \”ipv4Address\”: {},\n \”ipv6Address\”: {},\n \”fqdn\”: \”string\”,\n \”certificate\”: \”string\”\n }\n }\n ],\n \”imageFile\”: \”string\”,\n \”httpHeaders\”: [\n {\n \”key\”: \”string\”,\n \”value\”: \”string\”\n }\n ],\n \”neighborLinks\”: [\n {\n \”localInterfaceName\”: \”string\”,\n \”localShortInterfaceName\”: \”string\”,\n \”localMacAddress\”: \”string\”,\n \”remoteInterfaceName\”: \”string\”,\n \”remoteShortInterfaceName\”: \”string\”,\n \”remoteMacAddress\”: \”string\”,\n \”remoteDeviceName\”: \”string\”,\n \”remotePlatform\”: \”string\”,\n \”remoteVersion\”: \”string\”\n }\n ],\n \”lastSyncTime\”: 0,\n \”ipInterfaces\”: [\n {\n \”status\”: \”string\”,\n \”macAddress\”: \”string\”,\n \”ipv4Address\”: {},\n \”ipv6AddressList\”: [\n {}\n ],\n \”name\”: \”string\”\n }\n ],\n \”hostname\”: \”string\”,\n \”authStatus\”: \”string\”,\n \”stackInfo\”: {\n \”supportsStackWorkflows\”: true,\n \”isFullRing\”: true,\n \”stackMemberList\”: [\n {\n \”serialNumber\”: \”string\”,\n \”state\”: \”string\”,\n \”role\”: \”string\”,\n \”macAddress\”: \”string\”,\n \”pid\”: \”string\”,\n \”licenseLevel\”: \”string\”,\n \”licenseType\”: \”string\”,\n \”sudiSerialNumber\”: \”string\”,\n \”hardwareVersion\”: \”string\”,\n \”stackNumber\”: 0,\n \”softwareVersion\”: \”string\”,\n \”priority\”: 0\n }\n ],\n \”stackRingProtocol\”: \”string\”,\n \”validLicenseLevels\”: [\n \”string\”\n ],\n \”totalMemberCount\”: 0\n },\n \”reloadRequested\”: true,\n \”addedOn\”: 0,\n \”siteId\”: \”string\”,\n \”aaaCredentials\”: {\n \”password\”: \”string\”,\n \”username\”: \”string\”\n },\n \”userMicNumbers\”: [\n \”string\”\n ],\n \”userSudiSerialNos\”: [\n \”string\”\n ],\n \”addnMacAddrs\”: [\n \”string\”\n ],\n \”preWorkflowCliOuputs\”: [\n {\n \”cli\”: \”string\”,\n \”cliOutput\”: \”string\”\n }\n ],\n \”tags\”: {},\n \”sudiRequired\”: true,\n \”smartAccountId\”: \”string\”,\n \”virtualAccountId\”: \”string\”,\n \”populateInventory\”: true,\n \”siteName\”: \”string\”,\n \”name\”: \”string\”\n },\n \”systemResetWorkflow\”: {\n \”_id\”: \”string\”,\n \”state\”: \”string\”,\n \”type\”: \”string\”,\n \”description\”: \”string\”,\n \”lastupdateOn\”: 0,\n \”imageId\”: \”string\”,\n \”currTaskIdx\”: 0,\n \”addedOn\”: 0,\n \”tasks\”: [\n {\n \”state\”: \”string\”,\n \”type\”: \”string\”,\n \”currWorkItemIdx\”: 0,\n \”taskSeqNo\”: 0,\n \”endTime\”: 0,\n \”startTime\”: 0,\n \”workItemList\”: [\n {\n \”state\”: \”string\”,\n \”command\”: \”string\”,\n \”outputStr\”: \”string\”,\n \”endTime\”: 0,\n \”startTime\”: 0,\n \”timeTaken\”: 0\n }\n ],\n \”timeTaken\”: 0,\n \”name\”: \”string\”\n }\n ],\n \”addToInventory\”: true,\n \”instanceType\”: \”string\”,\n \”endTime\”: 0,\n \”execTime\”: 0,\n \”startTime\”: 0,\n \”useState\”: \”string\”,\n \”configId\”: \”string\”,\n \”name\”: \”string\”,\n \”version\”: 0,\n \”tenantId\”: \”string\”\n },\n \”systemWorkflow\”: {\n \”_id\”: \”string\”,\n \”state\”: \”string\”,\n \”type\”: \”string\”,\n \”description\”: \”string\”,\n \”lastupdateOn\”: 0,\n \”imageId\”: \”string\”,\n \”currTaskIdx\”: 0,\n \”addedOn\”: 0,\n \”tasks\”: [\n {\n \”state\”: \”string\”,\n \”type\”: \”string\”,\n \”currWorkItemIdx\”: 0,\n \”taskSeqNo\”: 0,\n \”endTime\”: 0,\n \”startTime\”: 0,\n \”workItemList\”: [\n {\n \”state\”: \”string\”,\n \”command\”: \”string\”,\n \”outputStr\”: \”string\”,\n \”endTime\”: 0,\n \”startTime\”: 0,\n \”timeTaken\”: 0\n }\n ],\n \”timeTaken\”: 0,\n \”name\”: \”string\”\n }\n ],\n \”addToInventory\”: true,\n \”instanceType\”: \”string\”,\n \”endTime\”: 0,\n \”execTime\”: 0,\n \”startTime\”: 0,\n \”useState\”: \”string\”,\n \”configId\”: \”string\”,\n \”name\”: \”string\”,\n \”version\”: 0,\n \”tenantId\”: \”string\”\n },\n \”workflow\”: {\n \”_id\”: \”string\”,\n \”state\”: \”string\”,\n \”type\”: \”string\”,\n \”description\”: \”string\”,\n \”lastupdateOn\”: 0,\n \”imageId\”: \”string\”,\n \”currTaskIdx\”: 0,\n \”addedOn\”: 0,\n \”tasks\”: [\n {\n \”state\”: \”string\”,\n \”type\”: \”string\”,\n \”currWorkItemIdx\”: 0,\n \”taskSeqNo\”: 0,\n \”endTime\”: 0,\n \”startTime\”: 0,\n \”workItemList\”: [\n {\n \”state\”: \”string\”,\n \”command\”: \”string\”,\n \”outputStr\”: \”string\”,\n \”endTime\”: 0,\n \”startTime\”: 0,\n \”timeTaken\”: 0\n }\n ],\n \”timeTaken\”: 0,\n \”name\”: \”string\”\n }\n ],\n \”addToInventory\”: true,\n \”instanceType\”: \”string\”,\n \”endTime\”: 0,\n \”execTime\”: 0,\n \”startTime\”: 0,\n \”useState\”: \”string\”,\n \”configId\”: \”string\”,\n \”name\”: \”string\”,\n \”version\”: 0,\n \”tenantId\”: \”string\”\n },\n \”runSummaryList\”: [\n {\n \”details\”: \”string\”,\n \”historyTaskInfo\”: {\n \”type\”: \”string\”,\n \”workItemList\”: [\n {\n \”state\”: \”string\”,\n \”command\”: \”string\”,\n \”outputStr\”: \”string\”,\n \”endTime\”: 0,\n \”startTime\”: 0,\n \”timeTaken\”: 0\n }\n ],\n \”timeTaken\”: 0,\n \”addnDetails\”: [\n {\n \”key\”: \”string\”,\n \”value\”: \”string\”\n }\n ],\n \”name\”: \”string\”\n },\n \”errorFlag\”: true,\n \”timestamp\”: 0\n }\n ],\n \”workflowParameters\”: {\n \”topOfStackSerialNumber\”: \”string\”,\n \”licenseLevel\”: \”string\”,\n \”licenseType\”: \”string\”,\n \”configList\”: [\n {\n \”configParameters\”: [\n {\n \”key\”: \”string\”,\n \”value\”: \”string\”\n }\n ],\n \”configId\”: \”string\”\n }\n ]\n },\n \”dayZeroConfig\”: {\n \”config\”: \”string\”\n },\n \”dayZeroConfigPreview\”: {},\n \”version\”: 0,\n \”tenantId\”: \”string\”\n}\n”

Authors

  • Rafael Campos (@racampos)