#!/usr/bin/python
# -*- coding: utf-8 -*-

# Copyright: (c) 2021, Cisco Systems
# GNU General Public License v3.0+ (see LICENSE or https://www.gnu.org/licenses/gpl-3.0.txt)

DOCUMENTATION = r"""
---
module: pnp_device_reset
short_description: Manage PnpDeviceReset objects of DeviceOnboardingPnp
description:
- Recovers a device from a Workflow Execution Error state.
version_added: '1.0.0'
author: <NAME> (@racampos)
options:
  deviceResetList:
    description:
    - ResetRequest's deviceResetList (list of objects).
    type: list
    elements: dict
    suboptions:
      configList:
        description:
        - It is the pnp device reset's configList.
        type: list
        elements: dict
        suboptions:
          configId:
            description:
            - It is the pnp device reset's configId.
            type: str
          configParameters:
            description:
            - It is the pnp device reset's configParameters.
            type: list
            elements: dict
            suboptions:
              key:
                description:
                - It is the pnp device reset's key.
                type: str
              value:
                description:
                - It is the pnp device reset's value.
                type: str


      deviceId:
        description:
        - It is the pnp device reset's deviceId.
        type: str
      licenseLevel:
        description:
        - It is the pnp device reset's licenseLevel.
        type: str
      licenseType:
        description:
        - It is the pnp device reset's licenseType.
        type: str
      topOfStackSerialNumber:
        description:
        - It is the pnp device reset's topOfStackSerialNumber.
        type: str

  projectId:
    description:
    - ResetRequest's projectId.
    type: str
  workflowId:
    description:
    - ResetRequest's workflowId.
    type: str

requirements:
- dnacentersdk
seealso:
# Reference by module name
- module: cisco.dnac.plugins.module_utils.definitions.pnp_device_reset
# Reference by Internet resource
- name: PnpDeviceReset reference
  description: Complete reference of the PnpDeviceReset object model.
  link: https://developer.cisco.com/docs/dna-center/api/1-3-3-x
# Reference by Internet resource
- name: PnpDeviceReset reference
  description: SDK reference.
  link: https://dnacentersdk.readthedocs.io/en/latest/api/api.html#v2-1-1-summary
"""

EXAMPLES = r"""
- name: reset_device
  cisco.dnac.pnp_device_reset:
    state: create  # required
    deviceResetList:
    - configList:
      - configId: SomeValue  # string
        configParameters:
        - key: SomeValue  # string
          value: SomeValue  # string
      deviceId: SomeValue  # string
      licenseLevel: SomeValue  # string
      licenseType: SomeValue  # string
      topOfStackSerialNumber: SomeValue  # string
    projectId: SomeValue  # string
    workflowId: SomeValue  # string

"""

RETURN = r"""
dnac_response:
  description: A dictionary with the response returned by the DNA Center Python SDK
  returned: always
  type: dict
  sample: {"response": 29, "version": "1.0"}
sdk_function:
  description: The DNA Center SDK function used to execute the task
  returned: always
  type: str
  sample: device_onboarding_pnp.reset_device
missing_params:
  description: Provided arguments do not comply with the schema of the DNA Center Python SDK function
  returned: when the function request schema is not satisfied
  type: list
  sample:
"""

#!/usr/bin/python
# -*- coding: utf-8 -*-

# Copyright: (c) 2021, Cisco Systems
# GNU General Public License v3.0+ (see LICENSE or https://www.gnu.org/licenses/gpl-3.0.txt)

DOCUMENTATION = r"""
---
module: pnp_device_reset
short_description: Manage PnpDeviceReset objects of DeviceOnboardingPnp
description:
- Recovers a device from a Workflow Execution Error state.
version_added: '1.0.0'
author: <NAME> (@racampos)
options:
  deviceResetList:
    description:
    - ResetRequest's deviceResetList (list of objects).
    type: list
    elements: dict
    suboptions:
      configList:
        description:
        - It is the pnp device reset's configList.
        type: list
        elements: dict
        suboptions:
          configId:
            description:
            - It is the pnp device reset's configId.
            type: str
          configParameters:
            description:
            - It is the pnp device reset's configParameters.
            type: list
            elements: dict
            suboptions:
              key:
                description:
                - It is the pnp device reset's key.
                type: str
              value:
                description:
                - It is the pnp device reset's value.
                type: str


      deviceId:
        description:
        - It is the pnp device reset's deviceId.
        type: str
      licenseLevel:
        description:
        - It is the pnp device reset's licenseLevel.
        type: str
      licenseType:
        description:
        - It is the pnp device reset's licenseType.
        type: str
      topOfStackSerialNumber:
        description:
        - It is the pnp device reset's topOfStackSerialNumber.
        type: str

  projectId:
    description:
    - ResetRequest's projectId.
    type: str
  workflowId:
    description:
    - ResetRequest's workflowId.
    type: str

requirements:
- dnacentersdk
seealso:
# Reference by module name
- module: cisco.dnac.plugins.module_utils.definitions.pnp_device_reset
# Reference by Internet resource
- name: PnpDeviceReset reference
  description: Complete reference of the PnpDeviceReset object model.
  link: https://developer.cisco.com/docs/dna-center/api/1-3-3-x
# Reference by Internet resource
- name: PnpDeviceReset reference
  description: SDK reference.
  link: https://dnacentersdk.readthedocs.io/en/latest/api/api.html#v2-1-1-summary
"""

EXAMPLES = r"""
- name: reset_device
  cisco.dnac.pnp_device_reset:
    state: create  # required
    deviceResetList:
    - configList:
      - configId: SomeValue  # string
        configParameters:
        - key: SomeValue  # string
          value: SomeValue  # string
      deviceId: SomeValue  # string
      licenseLevel: SomeValue  # string
      licenseType: SomeValue  # string
      topOfStackSerialNumber: SomeValue  # string
    projectId: SomeValue  # string
    workflowId: SomeValue  # string

"""

RETURN = r"""
dnac_response:
  description: A dictionary with the response returned by the DNA Center Python SDK
  returned: always
  type: dict
  sample: {"response": 29, "version": "1.0"}
sdk_function:
  description: The DNA Center SDK function used to execute the task
  returned: always
  type: str
  sample: device_onboarding_pnp.reset_device
missing_params:
  description: Provided arguments do not comply with the schema of the DNA Center Python SDK function
  returned: when the function request schema is not satisfied
  type: list
  sample:
"""

#!/usr/bin/python # -*- coding: utf-8 -*- # Copyright: (c) 2021, Cisco Systems # GNU General Public License v3.0+ (see LICENSE or https://www.gnu.org/licenses/gpl-3.0.txt) --- module: pnp_device_reset short_description: Manage PnpDeviceReset objects of DeviceOnboardingPnp description: - Recovers a device from a Workflow Execution Error state. version_added: '1.0.0' author: <NAME> (@racampos) options:   deviceResetList:     description:     - ResetRequest's deviceResetList (list of objects).     type: list     elements: dict     suboptions:       configList:         description:         - It is the pnp device reset's configList.         type: list         elements: dict         suboptions:           configId:             description:             - It is the pnp device reset's configId.             type: str           configParameters:             description:             - It is the pnp device reset's configParameters.             type: list             elements: dict             suboptions:               key:                 description:                 - It is the pnp device reset's key.                 type: str               value:                 description:                 - It is the pnp device reset's value.                 type: str         deviceId:         description:         - It is the pnp device reset's deviceId.         type: str       licenseLevel:         description:         - It is the pnp device reset's licenseLevel.         type: str       licenseType:         description:         - It is the pnp device reset's licenseType.         type: str       topOfStackSerialNumber:         description:         - It is the pnp device reset's topOfStackSerialNumber.         type: str    projectId:     description:     - ResetRequest's projectId.     type: str   workflowId:     description:     - ResetRequest's workflowId.     type: str  requirements: - dnacentersdk seealso: # Reference by module name - module: cisco.dnac.plugins.module_utils.definitions.pnp_device_reset # Reference by Internet resource - name: PnpDeviceReset reference   description: Complete reference of the PnpDeviceReset object model.   link: https://developer.cisco.com/docs/dna-center/api/1-3-3-x # Reference by Internet resource - name: PnpDeviceReset reference   description: SDK reference.   link: https://dnacentersdk.readthedocs.io/en/latest/api/api.html#v2-1-1-summary - name: reset_device   cisco.dnac.pnp_device_reset:     state: create  # required     deviceResetList:     - configList:       - configId: SomeValue  # string         configParameters:         - key: SomeValue  # string           value: SomeValue  # string       deviceId: SomeValue  # string       licenseLevel: SomeValue  # string       licenseType: SomeValue  # string       topOfStackSerialNumber: SomeValue  # string     projectId: SomeValue  # string     workflowId: SomeValue  # string dnac_response:   description: A dictionary with the response returned by the DNA Center Python SDK   returned: always   type: dict   sample: {"response": 29, "version": "1.0"} sdk_function:   description: The DNA Center SDK function used to execute the task   returned: always   type: str   sample: device_onboarding_pnp.reset_device missing_params:   description: Provided arguments do not comply with the schema of the DNA Center Python SDK function   returned: when the function request schema is not satisfied   type: list   sample: