cisco.ucs.ucs_vlan_find 模块 – 在 Cisco UCS Manager 上查找 VLAN

注意

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

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

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

要在 playbook 中使用它，请指定：cisco.ucs.ucs_vlan_find。

概要 

根据不同的条件查找 Cisco UCS Manager 上的 VLAN。

需求 

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

ucsmsdk

参数 

参数	注释
fabric 字符串	VLAN 的结构配置。可以是以下之一： common - VLAN 应用于两个结构，并在两种情况下使用相同的配置参数。 A — VLAN 只应用于结构 A。 B — VLAN 只应用于结构 B。选项 `"common"` ← (默认) `"A"` `"B"`
hostname 字符串 / 必需	Cisco UCS Manager 的 IP 地址或主机名。模块可与 UCS 平台仿真器 https://cs.co/ucspe 一起使用
password 字符串 / 必需	Cisco UCS Manager 身份验证的密码。
pattern 字符串	在 fabricVlan 类的 name 属性中查找的正则表达式模式。如果未提供 `vlanid` 参数，则需要此参数。
port 整数	连接期间要使用的端口号（默认情况下，对于 https 连接使用 443，对于 http 连接使用 80）。
proxy 字符串	如果 use_proxy 为 no，则指定要用于连接的代理。例如，‘http://proxy.xy.z:8080’
use_proxy 布尔值	如果为 `no`，则不会使用系统环境变量定义的代理。选项 `false` `true` ← (默认)
use_ssl 布尔值	如果为 `no`，则将使用 HTTP 连接而不是默认的 HTTPS 连接。选项 `false` `true` ← (默认)
username 字符串	Cisco UCS Manager 身份验证的用户名。默认值： `"admin"`
vlanid 字符串	分配给 VLAN 的唯一字符串标识符。 VLAN ID 可以是 '1' 到 '3967'，或 '4048' 到 '4093'。如果未提供 `pattern` 参数，则需要此参数。

示例 

- name: Get all vlans in fabric A
  cisco.ucs.ucs_vlan_find:
    hostname: 172.16.143.150
    username: admin
    password: password
    fabric: 'A'
    pattern: '.'
- name: Confirm if vlan 15 is present
  cisco.ucs.ucs_vlan_find:
    hostname: 172.16.143.150
    username: admin
    password: password
    vlanid: '15'

返回值 

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

键	描述
vlan_list 列表 / 元素=字符串	找到的 VLAN 的基本详细信息返回：成功时示例： `[{"id": "0", "name": "vlcloud1"}]`

作者

David Martinez (@dx0xm)
David Soper (@dsoper2)
John McDonough (@movinalot)
CiscoUcs (@CiscoUcs)