.. 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.catalystcenter.application_health_score_definitions_module: .. Anchors: short name for ansible.builtin .. Anchors: aliases .. Title cisco.catalystcenter.application_health_score_definitions module -- Resource module for Application Health Score Definitions ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ .. Collection note .. note:: This module is part of the `cisco.catalystcenter collection `_ (version 2.11.0). To install it, use: :code:`ansible-galaxy collection install cisco.catalystcenter`. 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.catalystcenter.application_health_score_definitions`. .. version_added .. rst-class:: ansible-version-added New in cisco.catalystcenter 2.11.0 .. contents:: :local: :depth: 1 .. Deprecated Synopsis -------- .. Description - Manage operation update of the resource Application Health Score Definitions. - Update application health score definition for the given id. .. note:: This module has a corresponding :ref:`action plugin `. .. Aliases .. Requirements .. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module_requirements: Requirements ------------ The below requirements are needed on the host that executes this module. - catalystcentersdk \>= 3.2.3.0.0 - python \>= 3.12 .. Options Parameters ---------- .. rst-class:: ansible-option-table .. list-table:: :width: 100% :widths: auto :header-rows: 1 * - Parameter - Comments * - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-baddefaultvalue: .. rst-class:: ansible-option-title **badDefaultValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
The default upper threshold value of the KPI for poor (1-3) health score. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-badmaxvalue: .. rst-class:: ansible-option-title **badMaxValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
Maximum value allowed for upper threshold value of the KPI for poor (1-3) health score. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-badminvalue: .. rst-class:: ansible-option-title **badMinValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
Minimum value allowed for upper threshold value of the KPI for poor (1-3) health score. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-badvalue: .. rst-class:: ansible-option-title **badValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
The upper threshold value of the KPI for poor (1-3) health score. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-catalystcenter_debug: .. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-dnac_debug: .. rst-class:: ansible-option-title **catalystcenter_debug** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: dnac_debug` .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag for Cisco Catalyst 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.catalystcenter.application_health_score_definitions_module__parameter-catalystcenter_host: .. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-dnac_host: .. rst-class:: ansible-option-title **catalystcenter_host** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: dnac_host` .. rst-class:: ansible-option-type-line :ansible-option-type:`string` / :ansible-option-required:`required` .. raw:: html
- .. raw:: html
The Cisco Catalyst Center hostname. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-catalystcenter_password: .. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-dnac_password: .. rst-class:: ansible-option-title **catalystcenter_password** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: dnac_password` .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The Cisco Catalyst Center password to authenticate. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-catalystcenter_api_port: .. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-catalystcenter_port: .. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-dnac_port: .. rst-class:: ansible-option-title **catalystcenter_port** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: dnac_port, catalystcenter_api_port` .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
The Cisco Catalyst Center port. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`443` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-catalystcenter_username: .. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-dnac_username: .. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-user: .. rst-class:: ansible-option-title **catalystcenter_username** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: dnac_username, user` .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The Cisco Catalyst 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.catalystcenter.application_health_score_definitions_module__parameter-catalystcenter_verify: .. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-dnac_verify: .. rst-class:: ansible-option-title **catalystcenter_verify** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: dnac_verify` .. 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.catalystcenter.application_health_score_definitions_module__parameter-catalystcenter_version: .. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-dnac_version: .. rst-class:: ansible-option-title **catalystcenter_version** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: dnac_version` .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Informs the SDK which version of Cisco Catalyst Center to use. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"3.1.6.0"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-definitiontype: .. rst-class:: ansible-option-title **definitionType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Definition type to indicate whether the health score definition has been customized or not. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-gooddefaultvalue: .. rst-class:: ansible-option-title **goodDefaultValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
The default lower threshold value of the KPI for fair (4-7) health score. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-goodmaxvalue: .. rst-class:: ansible-option-title **goodMaxValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
Maximum value allowed for lower threshold value of the KPI for fair (4-7) health score. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-goodminvalue: .. rst-class:: ansible-option-title **goodMinValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
Minimum value allowed for lower threshold value of the KPI for fair (4-7) health score. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-goodvalue: .. rst-class:: ansible-option-title **goodValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
The lower threshold value of the KPI for fair (4-7) health score. This would be same as the upper threshold value of the KPI for good (8-10) health score. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-greatdefaultvalue: .. rst-class:: ansible-option-title **greatDefaultValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
The default lower threshold value of the KPI for good (8-10) health score. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-greatmaxvalue: .. rst-class:: ansible-option-title **greatMaxValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
Maximum value allowed for the lower threshold value of the KPI for good (8-10) health score. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-greatminvalue: .. rst-class:: ansible-option-title **greatMinValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
Minimum value allowed for the lower threshold value of the KPI for good (8-10) health score. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-greatvalue: .. rst-class:: ansible-option-title **greatValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
The lower threshold value of the KPI for good (8-10) health score. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-headers: .. rst-class:: ansible-option-title **headers** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Additional headers. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-id: .. rst-class:: ansible-option-title **id** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Id path parameter. Application health score definition id. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-includeforhealthscore: .. rst-class:: ansible-option-title **includeForHealthScore** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag to indicate whether the KPI is included for the application health score calulation or not. .. 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.catalystcenter.application_health_score_definitions_module__parameter-includeforhealthscoredefault: .. rst-class:: ansible-option-title **includeForHealthScoreDefault** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Default flag to indicate whether the KPI is included for application health calulation or not. .. 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.catalystcenter.application_health_score_definitions_module__parameter-kpiname: .. rst-class:: ansible-option-title **kpiName** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Application health KPI name. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-lastmodified: .. rst-class:: ansible-option-title **lastModified** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Last modification time in milliseconds since UNIX epoch. This is applicable only for modified thresholds. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-poordefaultvalue: .. rst-class:: ansible-option-title **poorDefaultValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
The default lower threshold value of the KPI for poor (1-3) health score. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-poormaxvalue: .. rst-class:: ansible-option-title **poorMaxValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
Maximum value allowed for lower threshold value of the KPI for poor (1-3) health score. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-poorminvalue: .. rst-class:: ansible-option-title **poorMinValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
Minimum value allowed for lower threshold value of the KPI for poor (1-3) health score. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-poorvalue: .. rst-class:: ansible-option-title **poorValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
The lower threshold value of the KPI for poor (1-3) health score. This would be same as the upper threshold value of the KPI for fair (4-7) health score. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-trafficclass: .. rst-class:: ansible-option-title **trafficClass** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Traffic class for application health score definition. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-unit: .. rst-class:: ansible-option-title **unit** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Application Health score definition unit. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_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 Catalyst 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
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-weightdefaultvalue: .. rst-class:: ansible-option-title **weightDefaultValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
The default weightage of the KPI used for application health score calculation. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.application_health_score_definitions_module__parameter-weightvalue: .. rst-class:: ansible-option-title **weightValue** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
The weightage of the KPI used for application health score calculation. .. raw:: html
.. Attributes .. Notes Notes ----- .. note:: - SDK Method used are applications.Applications.update\_application\_health\_score\_definition\_for\_the\_given\_id, - Paths used are put /dna/intent/api/v1/applicationHealthScoreDefinitions/{id}, - Does not support \ :literal:`check\_mode`\ - The plugin runs on the control node and does not use any ansible connection plugins, - but instead uses the embedded connection manager from Cisco CATALYST SDK - Requires Python \>= 3.10, matching the controller Python versions supported by the collection's minimum ansible-core version (see the collection README for the current ansible-core / Python compatibility range) .. Seealso See Also -------- .. seealso:: `Cisco Catalyst Center documentation for Applications UpdateApplicationHealthScoreDefinitionForTheGivenId `_ Complete reference of the UpdateApplicationHealthScoreDefinitionForTheGivenId API. .. Examples Examples -------- .. code-block:: yaml+jinja --- - name: Update by id cisco.catalystcenter.application_health_score_definitions: catalystcenter_host: "{{catalystcenter_host}}" catalystcenter_username: "{{catalystcenter_username}}" catalystcenter_password: "{{catalystcenter_password}}" catalystcenter_verify: "{{catalystcenter_verify}}" catalystcenter_port: "{{catalystcenter_port}}" catalystcenter_version: "{{catalystcenter_version}}" catalystcenter_debug: "{{catalystcenter_debug}}" state: present badValue: 10 goodValue: 1 greatValue: 0.1 headers: '{{my_headers | from_json}}' id: string includeForHealthScore: true poorValue: 4 weightValue: 10 .. 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.catalystcenter.application_health_score_definitions_module__return-catalystcenter_response: .. rst-class:: ansible-option-title **catalystcenter_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 Catalyst Center 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:`{"response": {"badDefaultValue": 0, "badMaxValue": 0, "badMinValue": 0, "badValue": 0, "definitionType": "string", "goodDefaultValue": 0, "goodMaxValue": 0, "goodMinValue": 0, "goodValue": 0, "greatDefaultValue": 0, "greatMaxValue": 0, "greatMinValue": 0, "greatValue": 0, "id": "string", "includeForHealthScore": true, "includeForHealthScoreDefault": true, "kpiName": "string", "lastModified": 0, "poorDefaultValue": 0, "poorMaxValue": 0, "poorMinValue": 0, "poorValue": 0, "trafficClass": "string", "unit": "string", "weightDefaultValue": 0, "weightValue": 0}, "version": "string"}` .. raw:: html
.. Status (Presently only deprecated) .. Authors Authors ~~~~~~~ - Bryan Vargas (@bvargasre) .. Extra links Collection links ~~~~~~~~~~~~~~~~ .. raw:: html .. Parsing errors