cisco.dnac.template_intent module – Resource module for Template functions
Note
This module is part of the cisco.dnac collection (version 6.6.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
.
You need further requirements to be able to use this module,
see Requirements for details.
To use it in a playbook, specify: cisco.dnac.template_intent
.
New in cisco.dnac 6.6.0
Synopsis
Manage operations create, update and delete of the resource Configuration Template.
API to create a template by project name and template name.
API to update a template by template name and project name.
API to delete a template by template name and project name.
Requirements
The below requirements are needed on the host that executes this module.
dnacentersdk == 2.4.5
python >= 3.5
Parameters
Parameter |
Comments |
---|---|
List of details of templates being managed. |
|
Author of template. |
|
Is it composite template. Choices:
|
|
Configuration Template Create’s containingTemplates. |
|
Is it composite template. Choices:
|
|
Description of template. |
|
Configuration Template Create’s deviceTypes. |
|
Device family. |
|
Device series. |
|
Device type. |
|
UUID of template. |
|
Template language Choices:
|
|
Name of template. |
|
Project name. |
|
Configuration Template Create’s rollbackTemplateParams. |
|
Bind to source. |
|
CustomOrder of template param. |
|
Datatype of template param. |
|
Default value of template param. |
|
Description of template param. |
|
Display name of param. |
|
Group. |
|
UUID of template param. |
|
Instruction text for param. |
|
Key. |
|
Is it not a variable. Choices:
|
|
Order of template param. |
|
Is it an array. Choices:
|
|
Name of template param. |
|
Provider. |
|
Configuration Template Create’s range. |
|
UUID of range. |
|
Max value of range. |
|
Min value of range. |
|
Is param required. Choices:
|
|
Configuration Template Create’s selection. |
|
Default selection values. |
|
UUID of selection. |
|
Type of selection(SINGLE_SELECT or MULTI_SELECT). |
|
Selection values. |
|
Configuration Template Create’s tags. |
|
UUID of tag. |
|
Name of tag. |
|
Template content. |
|
Configuration Template Create’s templateParams. |
|
Bind to source. |
|
CustomOrder of template param. |
|
Datatype of template param. |
|
Default value of template param. |
|
Description of template param. |
|
Display name of param. |
|
Group. |
|
UUID of template param. |
|
Instruction text for param. |
|
Key. |
|
Is it not a variable. Choices:
|
|
Order of template param. |
|
Is it an array. Choices:
|
|
Name of template param. |
|
Provider. |
|
Configuration Template Create’s range. |
|
UUID of range. |
|
Max value of range. |
|
Min value of range. |
|
Is param required. Choices:
|
|
Configuration Template Create’s selection. |
|
Default selection values. |
|
UUID of selection. |
|
Type of selection(SINGLE_SELECT or MULTI_SELECT). |
|
Selection values. |
|
Current version of template. |
|
Create time of template. |
|
Custom Params Order. Choices:
|
|
Configuration Template Create’s deviceTypes. |
|
Device family. |
|
Device series. |
|
Device type. |
|
Define failure policy if template provisioning fails. |
|
Template language Choices:
|
|
Update time of template. |
|
Latest versioned template time. |
|
Parent templateID. |
|
Project UUID. |
|
Project name. |
|
Rollback template content. |
|
Configuration Template Create’s rollbackTemplateParams. |
|
Bind to source. |
|
CustomOrder of template param. |
|
Datatype of template param. |
|
Default value of template param. |
|
Description of template param. |
|
Display name of param. |
|
Group. |
|
UUID of template param. |
|
Instruction text for param. |
|
Key. |
|
Is it not a variable. Choices:
|
|
Order of template param. |
|
Is it an array. Choices:
|
|
Name of template param. |
|
Provider. |
|
Configuration Template Create’s range. |
|
UUID of range. |
|
Max value of range. |
|
Min value of range. |
|
Is param required. Choices:
|
|
Configuration Template Create’s selection. |
|
Default selection values. |
|
UUID of selection. |
|
Type of selection(SINGLE_SELECT or MULTI_SELECT). |
|
Selection values. |
|
Applicable device software type. |
|
Applicable device software variant. |
|
Applicable device software version. |
|
Description of template. |
|
Configuration Template Create’s tags. |
|
UUID of tag. |
|
Name of tag. |
|
Template content. |
|
Name of template. |
|
Configuration Template Create’s templateParams. |
|
Bind to source. |
|
CustomOrder of template param. |
|
Datatype of template param. |
|
Default value of template param. |
|
Description of template param. |
|
Display name of param. |
|
Group. |
|
UUID of template param. |
|
Instruction text for param. |
|
Key. |
|
Is it not a variable. Choices:
|
|
Order of template param. |
|
Is it an array. Choices:
|
|
Name of template param. |
|
Provider. |
|
Configuration Template Create’s range. |
|
UUID of range. |
|
Max value of range. |
|
Min value of range. |
|
Is param required. Choices:
|
|
Configuration Template Create’s selection. |
|
Default selection values. |
|
UUID of selection. |
|
Type of selection(SINGLE_SELECT or MULTI_SELECT). |
|
Selection values. |
|
Configuration Template Create’s validationErrors. |
|
Validation or design conflicts errors of rollback template. |
|
Validation or design conflicts errors. |
|
UUID of template. |
|
Current version of template. |
|
Current version of template. |
|
Template version comments. |
|
Flag for Cisco DNA Center SDK to enable debugging. Choices:
|
|
The Cisco DNA Center hostname. |
|
Flag for logging playbook execution details. If set to true the log file will be created at the location of the execution with the name dnac.log Choices:
|
|
The Cisco DNA Center password to authenticate. |
|
The Cisco DNA Center port. Default: |
|
The Cisco DNA Center username to authenticate. Default: |
|
Flag to enable or disable SSL certificate verification. Choices:
|
|
Informs the SDK which version of Cisco DNA Center to use. Default: |
|
The state of DNAC after module completion. Choices:
|
|
Flag for Cisco DNA Center SDK to enable the validation of request bodies against a JSON schema. Choices:
|
Notes
Note
SDK Method used are configuration_templates.ConfigurationTemplates.create_template, configuration_templates.ConfigurationTemplates.deletes_the_template, configuration_templates.ConfigurationTemplates.update_template,
Paths used are post /dna/intent/api/v1/template-programmer/project/{projectId}/template, delete /dna/intent/api/v1/template-programmer/template/{templateId}, put /dna/intent/api/v1/template-programmer/template,
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 a new template
cisco.dnac.template_intent:
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}}"
dnac_log: True
state: merged
config:
author: string
composite: true
createTime: 0
customParamsOrder: true
description: string
deviceTypes:
- productFamily: string
productSeries: string
productType: string
failurePolicy: string
id: string
language: string
lastUpdateTime: 0
latestVersionTime: 0
name: string
parentTemplateId: string
projectId: string
projectName: string
rollbackTemplateContent: string
softwareType: string
softwareVariant: string
softwareVersion: string
tags:
- id: string
name: string
templateContent: string
validationErrors:
rollbackTemplateErrors:
- {}
templateErrors:
- {}
templateId: string
templateVersion: string
version: string
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
A dictionary with versioning details of the template as returned by the DNAC Python SDK Returned: always Sample: |
|
A list with the response returned by the Cisco DNAC Python SDK Returned: always Sample: |
|
A dictionary with the exisiting template deatails as returned by the Cisco DNAC Python SDK Returned: always Sample: |