.. 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-default-mark .. role:: ansible-option-default-bold .. role:: ansible-option-configuration .. role:: ansible-option-returned-bold .. role:: ansible-option-sample-bold .. Anchors .. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module: .. Anchors: short name for ansible.builtin .. Anchors: aliases .. Title cisco.dnac.endpoint_analytics_profiling_rules module -- Resource module for Endpoint Analytics Profiling Rules ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ .. Collection note .. note:: This module is part of the `cisco.dnac collection `_ (version 6.13.0). To install it, use: :code:`ansible-galaxy collection install cisco.dnac`. You need further requirements to be able to use this module, see :ref:`Requirements ` for details. To use it in a playbook, specify: :code:`cisco.dnac.endpoint_analytics_profiling_rules`. .. version_added .. rst-class:: ansible-version-added New in cisco.dnac 4.0.0 .. contents:: :local: :depth: 1 .. Deprecated Synopsis -------- .. Description - Manage operations create, update and delete of the resource Endpoint Analytics Profiling Rules. - Creates profiling rule from the request body. - Deletes the profiling rule for the given 'ruleId'. .. note:: This module has a corresponding :ref:`action plugin `. .. Aliases .. Requirements .. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module_requirements: Requirements ------------ The below requirements are needed on the host that executes this module. - dnacentersdk \>= 2.5.5 - 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.endpoint_analytics_profiling_rules_module__parameter-clusterid: .. rst-class:: ansible-option-title **clusterId** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Unique identifier for ML cluster. Only applicable for 'ML Rule'. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-conditiongroups: .. rst-class:: ansible-option-title **conditionGroups** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Endpoint Analytics Profiling Rules's conditionGroups. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-conditiongroups/condition: .. rst-class:: ansible-option-title **condition** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Endpoint Analytics Profiling Rules's condition. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-conditiongroups/condition/attribute: .. rst-class:: ansible-option-title **attribute** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Endpoint Analytics Profiling Rules's attribute. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-conditiongroups/condition/attributedictionary: .. rst-class:: ansible-option-title **attributeDictionary** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Endpoint Analytics Profiling Rules's attributeDictionary. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-conditiongroups/condition/operator: .. rst-class:: ansible-option-title **operator** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Endpoint Analytics Profiling Rules's operator. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-conditiongroups/condition/value: .. rst-class:: ansible-option-title **value** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Endpoint Analytics Profiling Rules's value. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-conditiongroups/conditiongroup: .. rst-class:: ansible-option-title **conditionGroup** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Endpoint Analytics Profiling Rules's conditionGroup. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-conditiongroups/operator: .. rst-class:: ansible-option-title **operator** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Endpoint Analytics Profiling Rules's operator. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-conditiongroups/type: .. rst-class:: ansible-option-title **type** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Endpoint Analytics Profiling Rules's type. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_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-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_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.endpoint_analytics_profiling_rules_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.endpoint_analytics_profiling_rules_module__parameter-dnac_port: .. rst-class:: ansible-option-title **dnac_port** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. 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.endpoint_analytics_profiling_rules_module__parameter-dnac_username: .. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_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.endpoint_analytics_profiling_rules_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:`false` - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_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.3.5.3"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-isdeleted: .. rst-class:: ansible-option-title **isDeleted** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag to indicate whether the rule was deleted. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-lastmodifiedby: .. rst-class:: ansible-option-title **lastModifiedBy** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
User that last modified the rule. It is read-only, and is ignored if provided as part of input request. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-lastmodifiedon: .. rst-class:: ansible-option-title **lastModifiedOn** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Timestamp (in epoch milliseconds) of last modification. It is read-only, and is ignored if provided as part of input request. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-pluginid: .. rst-class:: ansible-option-title **pluginId** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Plugin for the rule. Only applicable for 'Cisco Default' rules. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-rejected: .. rst-class:: ansible-option-title **rejected** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag to indicate whether rule has been rejected by user or not. Only applicable for 'ML Rule'. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-result: .. rst-class:: ansible-option-title **result** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Endpoint Analytics Profiling Rules's result. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-result/devicetype: .. rst-class:: ansible-option-title **deviceType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
List of device types determined by the current rule. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-result/hardwaremanufacturer: .. rst-class:: ansible-option-title **hardwareManufacturer** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
List of hardware manufacturers determined by the current rule. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-result/hardwaremodel: .. rst-class:: ansible-option-title **hardwareModel** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
List of hardware models determined by the current rule. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-result/operatingsystem: .. rst-class:: ansible-option-title **operatingSystem** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
List of operating systems determined by the current rule. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-ruleid: .. rst-class:: ansible-option-title **ruleId** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Unique identifier for the rule. This is normally generated by the system, and client does not need to provide it for rules that need to be newly created. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-rulename: .. rst-class:: ansible-option-title **ruleName** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Human readable name for the rule. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-rulepriority: .. rst-class:: ansible-option-title **rulePriority** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Priority for the rule. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-ruletype: .. rst-class:: ansible-option-title **ruleType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Type of the rule. Allowed values are 'Cisco Default - Static', 'Cisco Default - Dynamic', 'Custom Rule', 'ML Rule'. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-ruleversion: .. rst-class:: ansible-option-title **ruleVersion** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Version of the rule. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-sourcepriority: .. rst-class:: ansible-option-title **sourcePriority** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Source priority for the rule. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_module__parameter-usedattributes: .. rst-class:: ansible-option-title **usedAttributes** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
List of attributes used in the rule. Only applicable for 'Cisco Default' rules. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.endpoint_analytics_profiling_rules_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:`false` - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` .. raw:: html
.. Attributes .. Notes Notes ----- .. note:: - SDK Method used are policy.Policy.create\_a\_profiling\_rule, policy.Policy.delete\_an\_existing\_profiling\_rule, policy.Policy.update\_an\_existing\_profiling\_rule, - Paths used are post /dna/intent/api/v1/endpoint-analytics/profiling-rules, delete /dna/intent/api/v1/endpoint-analytics/profiling-rules/{ruleId}, - 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 .. Examples Examples -------- .. code-block:: yaml+jinja - name: Create cisco.dnac.endpoint_analytics_profiling_rules: 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 clusterId: string conditionGroups: condition: attribute: string attributeDictionary: string operator: string value: string conditionGroup: - {} operator: string type: string isDeleted: true lastModifiedBy: string lastModifiedOn: 0 pluginId: string rejected: true result: deviceType: - string hardwareManufacturer: - string hardwareModel: - string operatingSystem: - string ruleId: string ruleName: string rulePriority: 0 ruleType: string ruleVersion: 0 sourcePriority: 0 usedAttributes: - string - name: Update by id cisco.dnac.endpoint_analytics_profiling_rules: 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 clusterId: string conditionGroups: condition: attribute: string attributeDictionary: string operator: string value: string conditionGroup: - {} operator: string type: string isDeleted: true lastModifiedBy: string lastModifiedOn: 0 pluginId: string rejected: true result: deviceType: - string hardwareManufacturer: - string hardwareModel: - string operatingSystem: - string ruleId: string ruleName: string rulePriority: 0 ruleType: string ruleVersion: 0 sourcePriority: 0 usedAttributes: - string - name: Delete by id cisco.dnac.endpoint_analytics_profiling_rules: 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 ruleId: 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.endpoint_analytics_profiling_rules_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:` :ansible-rv-sample-value:`{"id": "string", "link": "string"}` .. raw:: html
.. Status (Presently only deprecated) .. Authors Authors ~~~~~~~ - Rafael Campos (@racampos) .. Extra links Collection links ~~~~~~~~~~~~~~~~ .. raw:: html .. Parsing errors