.. Document meta :orphan: .. |antsibull-internal-nbsp| unicode:: 0xA0 :trim: .. role:: ansible-attribute-support-label .. role:: ansible-attribute-support-property .. role:: ansible-attribute-support-full .. role:: ansible-attribute-support-partial .. role:: ansible-attribute-support-none .. role:: ansible-attribute-support-na .. role:: ansible-option-type .. role:: ansible-option-elements .. role:: ansible-option-required .. role:: ansible-option-versionadded .. role:: ansible-option-aliases .. role:: ansible-option-choices .. role:: ansible-option-choices-entry .. role:: ansible-option-default .. role:: ansible-option-default-bold .. role:: ansible-option-configuration .. role:: ansible-option-returned-bold .. role:: ansible-option-sample-bold .. Anchors .. _ansible_collections.cisco.dnac.reports_module: .. Anchors: short name for ansible.builtin .. Anchors: aliases .. Title cisco.dnac.reports module -- Resource module for Reports ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ .. Collection note .. note:: This module is part of the `cisco.dnac collection `_ (version 3.3.2). 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 :code:`ansible-galaxy collection list`. To install it, use: :code:`ansible-galaxy collection install cisco.dnac`. To use it in a playbook, specify: :code:`cisco.dnac.reports`. .. version_added .. versionadded:: 3.1.0 of cisco.dnac .. contents:: :local: :depth: 1 .. Deprecated Synopsis -------- .. Description - Manage operations create and delete of the resource Reports. .. note:: This module has a corresponding :ref:`action plugin `. .. Aliases .. Requirements Requirements ------------ The below requirements are needed on the host that executes this module. - dnacentersdk >= 2.3.3 - python >= 3.5 .. Options Parameters ---------- .. rst-class:: ansible-option-table .. list-table:: :width: 100% :widths: auto :header-rows: 1 * - Parameter - Comments * - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-deliveries: .. rst-class:: ansible-option-title **deliveries** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Array of available delivery channels. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-dnac_debug: .. rst-class:: ansible-option-title **dnac_debug** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag for Cisco DNA Center SDK to enable debugging. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-default-bold:`no` :ansible-option-default:`← (default)` - :ansible-option-choices-entry:`yes` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-dnac_host: .. rst-class:: ansible-option-title **dnac_host** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` / :ansible-option-required:`required` .. raw:: html
- .. raw:: html
The Cisco DNA Center hostname. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-dnac_password: .. rst-class:: ansible-option-title **dnac_password** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The Cisco DNA Center password to authenticate. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-dnac_port: .. rst-class:: ansible-option-title **dnac_port** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The Cisco DNA Center port. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`443` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-dnac_username: .. _ansible_collections.cisco.dnac.reports_module__parameter-user: .. rst-class:: ansible-option-title **dnac_username** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: user` .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The Cisco DNA Center username to authenticate. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"admin"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-dnac_verify: .. rst-class:: ansible-option-title **dnac_verify** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag to enable or disable SSL certificate verification. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`no` - :ansible-option-default-bold:`yes` :ansible-option-default:`← (default)` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-dnac_version: .. rst-class:: ansible-option-title **dnac_version** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Informs the SDK which version of Cisco DNA Center to use. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"2.2.2.3"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-name: .. rst-class:: ansible-option-title **name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Report name. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-reportId: .. rst-class:: ansible-option-title **reportId** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
ReportId path parameter. ReportId of report. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-schedule: .. rst-class:: ansible-option-title **schedule** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Reports's schedule. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-tags: .. rst-class:: ansible-option-title **tags** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
Array of tags for report. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-validate_response_schema: .. rst-class:: ansible-option-title **validate_response_schema** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag for Cisco DNA Center SDK to enable the validation of request bodies against a JSON schema. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`no` - :ansible-option-default-bold:`yes` :ansible-option-default:`← (default)` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view: .. rst-class:: ansible-option-title **view** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Reports's view. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view/fieldGroups: .. rst-class:: ansible-option-title **fieldGroups** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
Reports's fieldGroups. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view/fieldGroups/fieldGroupDisplayName: .. rst-class:: ansible-option-title **fieldGroupDisplayName** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Field group label/displayname for user. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view/fieldGroups/fieldGroupName: .. rst-class:: ansible-option-title **fieldGroupName** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Field group name. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view/fieldGroups/fields: .. rst-class:: ansible-option-title **fields** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
Reports's fields. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view/fieldGroups/fields/displayName: .. rst-class:: ansible-option-title **displayName** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Field label/displayname. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view/fieldGroups/fields/name: .. rst-class:: ansible-option-title **name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Field name. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view/filters: .. rst-class:: ansible-option-title **filters** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
Reports's filters. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view/filters/displayName: .. rst-class:: ansible-option-title **displayName** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Filter label/displayname. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view/filters/name: .. rst-class:: ansible-option-title **name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Filter name. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view/filters/type: .. rst-class:: ansible-option-title **type** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Filter type. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view/filters/value: .. rst-class:: ansible-option-title **value** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
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. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view/format: .. rst-class:: ansible-option-title **format** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Reports's format. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view/format/formatType: .. rst-class:: ansible-option-title **formatType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Format type of report. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view/format/name: .. rst-class:: ansible-option-title **name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Format name of report. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view/name: .. rst-class:: ansible-option-title **name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
View name. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-view/viewId: .. rst-class:: ansible-option-title **viewId** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
View Id. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-viewGroupId: .. rst-class:: ansible-option-title **viewGroupId** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
ViewGroupId of the viewgroup for the report. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__parameter-viewGroupVersion: .. rst-class:: ansible-option-title **viewGroupVersion** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Version of viewgroup for the report. .. raw:: html
.. Attributes .. Notes Notes ----- .. note:: - Does not support \ :literal:`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 .. Seealso See Also -------- .. seealso:: `Reports reference `_ Complete reference of the Reports object model. .. Examples Examples -------- .. code-block:: yaml+jinja - 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 .. Facts .. Return values Return Values ------------- Common return values are documented :ref:`here `, the following are the fields unique to this module: .. rst-class:: ansible-option-table .. list-table:: :width: 100% :widths: auto :header-rows: 1 * - Key - Description * - .. raw:: html
.. _ansible_collections.cisco.dnac.reports_module__return-dnac_response: .. rst-class:: ansible-option-title **dnac_response** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
A dictionary or list with the response returned by the Cisco DNAC Python SDK .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` always .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`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" .. raw:: html
.. Status (Presently only deprecated) .. Authors Authors ~~~~~~~ - Rafael Campos (@racampos) .. Parsing errors