cisco.dnac.reports module – Resource module for Reports

Note

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

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.reports.

New in version 3.1.0: of cisco.dnac

Synopsis

• Manage operations create and delete of the resource Reports.

• Create/Schedule a report configuration. Use “Get view details for a given view group & view” API to get the metadata required to configure a report.

• Delete a scheduled report configuration. Deletes the report executions also.

Note

This module has a corresponding action plugin.

Requirements

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

• dnacentersdk >= 2.4.8

• python >= 3.5

Parameters

Parameter	Comments
deliveries list / elements=dictionary	Array of available delivery channels.
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.2.3.3”
name string	Report name.
reportId string	ReportId path parameter. ReportId of report.
schedule dictionary	Reports’s schedule.
tags list / elements=string	Array of tags for report.
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)
view dictionary	Reports’s view.
fieldGroups list / elements=dictionary	Reports’s fieldGroups.
fieldGroupDisplayName string	Field group label/displayname for user.
fieldGroupName string	Field group name.
fields list / elements=dictionary	Reports’s fields.
displayName string	Field label/displayname.
name string	Field name.
filters list / elements=dictionary	Reports’s filters.
displayName string	Filter label/displayname.
name string	Filter name.
type string	Filter type.
value dictionary	Value of filter. Data type is based on the filter type. Use the filter definitions from the view to fetch the options for a filter.
format dictionary	Reports’s format.
formatType string	Format type of report.
name string	Format name of report.
name string	View name.
viewId string	View Id.
viewGroupId string	ViewGroupId of the viewgroup for the report.
viewGroupVersion string	Version of viewgroup for the report.

Notes

Note

• SDK Method used are reports.Reports.create_or_schedule_a_report, reports.Reports.delete_a_scheduled_report,

• Paths used are post /dna/intent/api/v1/data/reports, delete /dna/intent/api/v1/data/reports/{reportId},

• 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.reports:
    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
    deliveries:
    - {}
    name: string
    schedule: {}
    tags:
    - string
    view:
      fieldGroups:
      - fieldGroupDisplayName: string
        fieldGroupName: string
        fields:
        - displayName: string
          name: string
      filters:
      - displayName: string
        name: string
        type: string
        value: {}
      format:
        formatType: string
        name: string
      name: string
      viewId: string
    viewGroupId: string
    viewGroupVersion: string

- name: Delete by id
  cisco.dnac.reports:
    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
    reportId: 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 \”tags\”: [\n \”string\”\n ],\n \”dataCategory\”: \”string\”,\n \”deliveries\”: [\n {}\n ],\n \”executionCount\”: 0,\n \”executions\”: [\n {\n \”endTime\”: 0,\n \”errors\”: [\n \”string\”\n ],\n \”executionId\”: \”string\”,\n \”processStatus\”: \”string\”,\n \”requestStatus\”: \”string\”,\n \”startTime\”: 0,\n \”warnings\”: [\n \”string\”\n ]\n }\n ],\n \”name\”: \”string\”,\n \”reportId\”: \”string\”,\n \”reportWasExecuted\”: true,\n \”schedule\”: {},\n \”view\”: {\n \”fieldGroups\”: [\n {\n \”fieldGroupDisplayName\”: \”string\”,\n \”fieldGroupName\”: \”string\”,\n \”fields\”: [\n {\n \”displayName\”: \”string\”,\n \”name\”: \”string\”\n }\n ]\n }\n ],\n \”filters\”: [\n {\n \”displayName\”: \”string\”,\n \”name\”: \”string\”,\n \”type\”: \”string\”,\n \”value\”: {}\n }\n ],\n \”format\”: {\n \”formatType\”: \”string\”,\n \”name\”: \”string\”\n },\n \”name\”: \”string\”,\n \”viewId\”: \”string\”,\n \”description\”: \”string\”,\n \”viewInfo\”: \”string\”\n },\n \”viewGroupId\”: \”string\”,\n \”viewGroupVersion\”: \”string\”\n}\n”

Authors

• Rafael Campos (@racampos)