cisco.dnac.wireless_settings_dot11be_profiles_v1 模块 – 无线设置 Dot11be 配置文件 V1 的资源模块

注意

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

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

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

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

cisco.dnac 6.15.0 中的新功能

概要

  • 管理无线设置 Dot11be 配置文件 V1 资源的创建、更新和删除操作。

  • 此 API 允许用户创建 802.11be 配置文件。Catalyst Center 会将此配置文件推送到设备的“default-dot11be-profile”。另请注意，802.11be 配置文件仅在 IOS-XE 控制器上受支持，因为设备版本为 17.15。

  • 如果 802.11be 配置文件未映射到任何无线网络配置文件，则此 API 允许用户删除 802.11be 配置文件。

  • 此 API 允许用户更新 802.11be 配置文件。

注意

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

要求

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

  • 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 路径参数。802.11be 配置文件 ID。

布尔值

MU-MIMO 下行链路（默认为 false）。

选择

  • false

  • true

布尔值

MU-MIMO 上行链路（默认为 false）。

选择

  • false

  • true

布尔值

OFDMA 下行链路（默认为 true）。

选择

  • false

  • true

ofdmaMultiRu

布尔值

OFDMA Multi-RU（默认为 false）。

选择

  • false

  • true

布尔值

OFDMA 上行链路（默认为 true）。

选择

  • false

  • true

profileName

字符串

802.11be 配置文件名称。

validate_response_schema

布尔值

Cisco DNA Center SDK 的标志，用于启用针对 JSON 架构的请求正文的验证。

选择

  • false

  • true ←（默认）

备注

注意

  • 使用的 SDK 方法是 wireless.Wireless.create_a80211be_profile_v1、wireless.Wireless.delete_a80211be_profile_v1、wireless.Wireless.update80211be_profile_v1。

  • 使用的路径是 post /dna/intent/api/v1/wirelessSettings/dot11beProfiles、delete /dna/intent/api/v1/wirelessSettings/dot11beProfiles/{id}、put /dna/intent/api/v1/wirelessSettings/dot11beProfiles/{id}。

  • 不支持 check_mode

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

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

另请参阅

另请参阅

Cisco DNA Center 文档，了解 Wireless CreateA80211beProfileV1

CreateA80211beProfileV1 API 的完整参考。

Cisco DNA Center 文档，了解 Wireless DeleteA80211beProfileV1

DeleteA80211beProfileV1 API 的完整参考。

Cisco DNA Center 文档，了解 Wireless Update80211beProfileV1

Update80211beProfileV1 API 的完整参考。

示例

- name: Create
  cisco.dnac.wireless_settings_dot11be_profiles_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}}"
    state: present
    muMimoDownLink: true
    muMimoUpLink: true
    ofdmaDownLink: true
    ofdmaMultiRu: true
    ofdmaUpLink: true
    profileName: string

- name: Delete by id
  cisco.dnac.wireless_settings_dot11be_profiles_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}}"
    state: absent
    id: string

- name: Update by id
  cisco.dnac.wireless_settings_dot11be_profiles_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}}"
    state: present
    id: string
    muMimoDownLink: true
    muMimoUpLink: true
    ofdmaDownLink: true
    ofdmaMultiRu: true
    ofdmaUpLink: true
    profileName: string

返回值

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

键

描述

dnac_response

字典

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

已返回： 始终

示例： {"response": {"taskId": "字符串", "url": "字符串"}, "version": "字符串"}

作者

  • Rafael Campos (@racampos)