cisco.dnac.app_policy_intent_create_v1 模块 – 用于应用策略意图创建 V1 的资源模块

注意

此模块是 cisco.dnac 集合（版本 6.25.0）的一部分。

如果您使用的是 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install cisco.dnac。您需要进一步的要求才能使用此模块，请参阅 要求 获取详细信息。

要在 playbook 中使用它，请指定： cisco.dnac.app_policy_intent_create_v1。

cisco.dnac 4.0.0 中的新增功能

概要

• 管理资源应用策略意图创建 V1 的创建操作。

• 创建/更新/删除应用策略。

注意

此模块具有相应的 操作插件。

要求

在执行此模块的主机上需要以下要求。

• dnacentersdk >= 2.4.9

• python >= 3.5

参数

参数	注释
createList 列表 / elements=字典	应用策略意图创建的 createList。
advancedPolicyScope 字典	应用策略意图创建的 advancedPolicyScope。
advancedPolicyScopeElement 列表 / elements=字典	应用策略意图创建的 advancedPolicyScopeElement。
groupId 列表 / elements=字符串	部署应用程序 QoS 策略的站点 ID。
ssid 列表 / elements=字符串	Ssid。
name 字符串	策略名称。
consumer 字典	应用策略意图创建的 consumer。
scalableGroup 列表 / elements=字典	应用策略意图创建的 scalableGroup。
idRef 字符串	应用程序可扩展组的 Id 引用。
contract 字典	应用策略意图创建的 contract。
idRef 字符串	队列配置文件的 Id 引用。
deletePolicyStatus 字符串	NONE 将策略部署到设备，DELETED 从设备删除策略，RESTORED 恢复到原始配置。
exclusiveContract 字典	应用策略意图创建的 exclusiveContract。
clause 列表 / elements=字典	应用策略意图创建的 clause。
deviceRemovalBehavior 字符串	设备移除行为。
hostTrackingEnabled 布尔值	是否启用主机跟踪。 选项 false true
relevanceLevel 字符串	相关性级别。
type 字符串	类型。
name 字符串	“<polcy name>_<application-set-name>”或“<polcy name>_global_policy_configuration”或“<polcy name>_queuing_customization”的连接。
policyScope 字符串	策略名称。
priority 字符串	当生产者引用应用程序可扩展组时设置为 4095，否则为 100。
producer 字典	应用策略意图创建的 producer。
scalableGroup 列表 / elements=字典	应用策略意图创建的 scalableGroup。
idRef 字符串	应用程序集或应用程序可扩展组的 Id 引用。
deleteList 列表 / elements=字符串	基于组的策略 ID 的删除列表。
dnac_debug 布尔值	用于 Cisco DNA Center SDK 启用调试的标志。 选项 false ← (默认) true
dnac_host 字符串 / 必需	Cisco DNA Center 主机名。
dnac_password 字符串	用于身份验证的 Cisco DNA Center 密码。
dnac_port 整数	Cisco DNA Center 端口。 默认： 443
dnac_username 别名：user 字符串	用于身份验证的 Cisco DNA Center 用户名。 默认： "admin"
dnac_verify 布尔值	用于启用或禁用 SSL 证书验证的标志。 选项 false true ← (默认)
dnac_version 字符串	通知 SDK 要使用的 Cisco DNA Center 版本。 默认： "2.3.7.6"
updateList 列表 / elements=字典	应用策略意图创建的 updateList。
advancedPolicyScope 字典	应用策略意图创建的 advancedPolicyScope。
advancedPolicyScopeElement 列表 / elements=字典	应用策略意图创建的 advancedPolicyScopeElement。
groupId 列表 / elements=字符串	部署应用程序 QoS 策略的站点 ID。
id 字符串	高级策略范围元素的 Id。
ssid 列表 / elements=字符串	Ssid。
id 字符串	高级策略范围的 Id。
name 字符串	策略名称。
consumer 字典	应用策略意图创建的 consumer。
id 字符串	使用者的 Id。
scalableGroup 列表 / elements=字典	应用策略意图创建的 scalableGroup。
idRef 字符串	应用程序可扩展组的 Id 引用。
contract 字典	应用策略意图创建的 contract。
idRef 字符串	队列配置文件的 Id 引用。
deletePolicyStatus 字符串	NONE 将策略部署到设备，DELETED 从设备删除策略，RESTORED 恢复到原始配置。
exclusiveContract 字典	应用策略意图创建的 exclusiveContract。
clause 列表 / elements=字典	应用策略意图创建的 clause。
deviceRemovalBehavior 字符串	设备移除行为。
hostTrackingEnabled 布尔值	主机跟踪已启用。 选项 false true
id 字符串	业务相关性或应用策略旋钮子句的 Id。
relevanceLevel 字符串	相关性级别。
type 字符串	类型。
id 字符串	独占合同的 Id。
id 字符串	基于组的策略的 Id。
name 字符串	“<polcy name>_<application-set-name>”或“<polcy name>_global_policy_configuration”或“<polcy name>_queuing_customization”的连接。
policyScope 字符串	策略名称。
priority 字符串	当生产者引用应用程序可扩展组时设置为 4095，否则为 100。
producer 字典	应用策略意图创建的 producer。
id 字符串	生产者的 Id。
scalableGroup 列表 / elements=字典	应用策略意图创建的 scalableGroup。
idRef 字符串	应用程序集或应用程序可扩展组的 Id 引用。
validate_response_schema 布尔值	用于 Cisco DNA Center SDK 启用针对 JSON 模式验证请求体的标志。 选项 false true ← (默认)

注释

注意

• 使用的 SDK 方法是 application_policy.ApplicationPolicy.application_policy_intent_v1，

• 使用的路径是 post /dna/intent/api/v1/app-policy-intent，

• 不支持 check_mode

• 该插件在控制节点上运行，不使用任何 Ansible 连接插件，而是使用 Cisco DNAC SDK 中的嵌入式连接管理器

• 以 dnac_ 开头的参数由 Cisco DNAC Python SDK 用于建立连接

另请参阅

另请参阅

有关应用策略 ApplicationPolicyIntentV1 的 Cisco DNA Center 文档

ApplicationPolicyIntentV1 API 的完整参考。

示例

- name: Create
  cisco.dnac.app_policy_intent_create_v1:
    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}}"
    createList:
    - advancedPolicyScope:
        advancedPolicyScopeElement:
        - groupId:
          - string
          ssid:
          - string
        name: string
      consumer:
        scalableGroup:
        - idRef: string
      contract:
        idRef: string
      deletePolicyStatus: string
      exclusiveContract:
        clause:
        - deviceRemovalBehavior: string
          hostTrackingEnabled: true
          relevanceLevel: string
          type: string
      name: string
      policyScope: string
      priority: string
      producer:
        scalableGroup:
        - idRef: string
    deleteList:
    - string
    updateList:
    - advancedPolicyScope:
        advancedPolicyScopeElement:
        - groupId:
          - string
          id: string
          ssid:
          - string
        id: string
        name: string
      consumer:
        id: string
        scalableGroup:
        - idRef: string
      contract:
        idRef: string
      deletePolicyStatus: string
      exclusiveContract:
        clause:
        - deviceRemovalBehavior: string
          hostTrackingEnabled: true
          id: string
          relevanceLevel: string
          type: string
        id: string
      id: string
      name: string
      policyScope: string
      priority: string
      producer:
        id: string
        scalableGroup:
        - idRef: string

返回值

常见的返回值已在这里记录，以下是此模块特有的字段

键	描述
dnac_response 字典	一个字典或列表，包含 Cisco DNAC Python SDK 返回的响应 返回: 总是 示例: {"response": {"taskId": "string", "url": "string"}, "version": "string"}

作者

• Rafael Campos (@racampos)

集合链接

• 问题跟踪器
• 存储库（源代码）