cisco.dnac.applications 模块 – 应用程序的资源模块

注意

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

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

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

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

cisco.dnac 3.1.0 中的新增功能

概要 

此模块表示模块 applications_v1 的别名

注意

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

要求 

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

dnacentersdk >= 2.4.9
python >= 3.5

参数 

参数	注释
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"`
id 字符串	Id 查询参数。应用程序的 Id。
payload 列表 / 元素=字典	应用程序的有效负载。
applicationSet 字典	应用程序的 applicationSet。
idRef 字符串	Id 参考。
name 字符串	名称。
networkApplications 列表 / 元素=字典	应用程序的 networkApplications。
applicationSubType 字符串	应用程序子类型。
applicationType 字符串	应用程序类型。
appProtocol 字符串	应用程序协议。
categoryId 字符串	类别 Id。
displayName 字符串	显示名称。
dscp 字符串	Dscp。
engineId 字符串	引擎 Id。
helpString 字符串	帮助字符串。
ignoreConflict 字符串	忽略冲突。
longDescription 字符串	长描述。
name 字符串	名称。
popularity 字符串	受欢迎程度。
rank 字符串	排名。
serverName 字符串	服务器名称。
trafficClass 字符串	流量类别。
url 字符串	Url。
networkIdentity 列表 / 元素=字典	应用程序的 networkIdentity。
displayName 字符串	显示名称。
lowerPort 字符串	较低端口。
ports 字符串	端口。
protocol 字符串	协议。
upperPort 字符串	较高端口。
validate_response_schema 布尔值	Cisco DNA Center SDK 用于启用针对 JSON 模式验证请求主体的标志。选择 `false` `true` ←（默认）

备注 

注意

使用的 SDK 方法是 application_policy.ApplicationPolicy.create_application_v1、application_policy.ApplicationPolicy.delete_application_v1、application_policy.ApplicationPolicy.edit_application_v1,
使用的路径是 post /dna/intent/api/v1/applications、delete /dna/intent/api/v1/applications、put /dna/intent/api/v1/applications,
应该注意的是，此模块是 applications_v1 的别名
不支持 check_mode
该插件在控制节点上运行，不使用任何 Ansible 连接插件，而是使用 Cisco DNAC SDK 中的嵌入式连接管理器
以 dnac_ 开头的参数由 Cisco DNAC Python SDK 用于建立连接

参见 

另请参见

Cisco DNA Center 文档，了解应用程序策略 CreateApplicationV1: CreateApplicationV1 API 的完整参考。
Cisco DNA Center 文档，了解应用程序策略 DeleteApplicationV1: DeleteApplicationV1 API 的完整参考。
Cisco DNA Center 文档，了解应用程序策略 EditApplicationV1: EditApplicationV1 API 的完整参考。

示例 

- name: Create
  cisco.dnac.applications:
    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
    payload:
    - applicationSet:
        idRef: string
      name: string
      networkApplications:
      - appProtocol: string
        applicationSubType: string
        applicationType: string
        categoryId: string
        displayName: string
        dscp: string
        engineId: string
        helpString: string
        ignoreConflict: string
        longDescription: string
        name: string
        popularity: string
        rank: string
        serverName: string
        trafficClass: string
        url: string
      networkIdentity:
      - displayName: string
        lowerPort: string
        ports: string
        protocol: string
        upperPort: string

- name: Update all
  cisco.dnac.applications:
    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
    payload:
    - applicationSet:
        idRef: string
      id: string
      name: string
      networkApplications:
      - appProtocol: string
        applicationSubType: string
        applicationType: string
        categoryId: string
        displayName: string
        dscp: string
        engineId: string
        helpString: string
        id: string
        ignoreConflict: string
        longDescription: string
        name: string
        popularity: string
        rank: string
        serverName: string
        trafficClass: string
        url: string
      networkIdentity:
      - displayName: string
        id: string
        lowerPort: string
        ports: string
        protocol: string
        upperPort: string

- name: Delete all
  cisco.dnac.applications:
    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
    id: string

返回值 

通用返回值已在此处文档中说明，以下是此模块特有的字段

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

作者

Rafael Campos (@racampos)