cisco.dnac.pnp_global_settings 模块 – 用于 PnP 全局设置的资源模块

注意

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

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

要安装它,请使用:ansible-galaxy collection install cisco.dnac。您需要其他要求才能使用此模块,请参阅 要求 了解详细信息。

要在 Playbook 中使用它,请指定:cisco.dnac.pnp_global_settings

cisco.dnac 3.1.0 新增功能

概要

  • 此模块表示模块 pnp_global_settings_v1 的别名

注意

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

要求

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

  • dnacentersdk >= 2.4.9

  • python >= 3.5

参数

参数

注释

acceptEula

字符串

接受 Eula。

defaultProfile

字典

Pnp 全局设置的 defaultProfile。

cert

字符串

证书。

fqdnAddresses

列表 / 元素=字符串

Fqdn 地址。

ipAddresses

列表 / 元素=字符串

IP 地址。

port

字符串

端口。

proxy

字符串

代理。

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。

savaMappingList

列表 / 元素=字典

Pnp 全局设置的 savaMappingList。

ccoUser

字符串

Cco 用户。

expiry

字符串

有效期。

profile

字典

Pnp 全局设置的 profile。

addressFqdn

字符串

地址 Fqdn。

addressIpV4

字符串

地址 IPv4。

cert

字符串

证书。

makeDefault

字符串

设为默认值。

name

字符串

名称。

port

字符串

端口。

profileId

字符串

Profile Id。

proxy

字符串

代理。

smartAccountId

字符串

智能账户 ID。

virtualAccountId

字符串

虚拟账户 ID。

validate_response_schema

布尔值

Cisco DNA Center SDK 启用针对 JSON 架构验证请求体的标志。

选项

  • false

  • true ← (默认)

注释

注意

  • 使用的 SDK 方法是 device_onboarding_pnp.DeviceOnboardingPnp.update_pnp_global_settings_v1,

  • 使用的路径是 put /dna/intent/api/v1/onboarding/pnp-settings,

  • 应该注意的是,此模块是 pnp_global_settings_v1 的别名

  • 不支持 check_mode

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

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

另请参阅

另请参阅

有关设备加入 (PnP) UpdatePnPGlobalSettingsV1 的 Cisco DNA Center 文档

UpdatePnPGlobalSettingsV1 API 的完整参考。

示例

- name: Update all
  cisco.dnac.pnp_global_settings:
    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
    acceptEula: string
    defaultProfile:
      cert: string
      fqdnAddresses:
      - string
      ipAddresses:
      - string
      port: string
      proxy: string
    id: string
    savaMappingList:
    - ccoUser: string
      expiry: string
      profile:
        addressFqdn: string
        addressIpV4: string
        cert: string
        makeDefault: string
        name: string
        port: string
        profileId: string
        proxy: string
      smartAccountId: string
      virtualAccountId: string

返回值

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

描述

dnac_response

字典

一个字典或列表,包含 Cisco DNAC Python SDK 返回的响应

返回: 总是

示例: {"aaaCredentials": {"password": "string", "username": "string"}, "acceptEula": true, "defaultProfile": {"cert": "string", "fqdnAddresses": ["string"], "ipAddresses": ["string"], "port": 0, "proxy": true}, "id": "string", "savaMappingList": [{"autoSyncPeriod": 0, "ccoUser": "string", "expiry": 0, "lastSync": 0, "profile": {"addressFqdn": "string", "addressIpV4": "string", "cert": "string", "makeDefault": true, "name": "string", "port": 0, "profileId": "string", "proxy": true}, "smartAccountId": "string", "syncResult": {"syncList": [{"deviceSnList": ["string"], "syncType": "string"}], "syncMsg": "string"}, "syncResultStr": "string", "syncStartTime": 0, "syncStatus": "string", "tenantId": "string", "token": "string", "virtualAccountId": "string"}], "taskTimeOuts": {"configTimeOut": 0, "generalTimeOut": 0, "imageDownloadTimeOut": 0}, "tenantId": "string", "version": 0}

作者

  • Rafael Campos (@racampos)