cisco.ucs.ucs_vlans 模块 – 在 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_vlans。

概要

  • 在 Cisco UCS Manager 上配置 VLAN。

要求

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

  • ucsmsdk

参数

参数

注释

fabric

字符串

VLAN 的结构配置。可以是以下之一：

common - VLAN 应用于两个结构，并在两种情况下使用相同的配置参数。

A — VLAN 仅应用于结构 A。

B — VLAN 仅应用于结构 B。

对于上游不相交的 L2 网络，Cisco 建议您选择 common 来创建应用于两个结构的 VLAN。

选项

  • "common" ← (默认)

  • "A"

  • "B"

hostname

字符串 / 必需

Cisco UCS Manager 的 IP 地址或主机名。

模块可与 UCS 平台模拟器 https://cs.co/ucspe 一起使用

id

字符串

分配给 VLAN 的唯一字符串标识符。

VLAN ID 可以是 '1' 到 '3967'，或 '4048' 到 '4093'。

您不能创建 ID 为 4030 到 4047 的 VLAN。此 VLAN ID 范围已保留。

您指定的 VLAN ID 也必须受您使用的交换机支持。

LAN 云中的 VLAN 和 SAN 云中的 FCoE VLAN 必须具有不同的 ID。

如果状态为 absent，则为可选。

multicast_policy

字符串

与此 VLAN 关联的多播策略。

此选项仅在“共享类型”字段设置为“无”或“主”时有效。

name

字符串 / 必需

分配给 VLAN 的名称。

VLAN 名称区分大小写。

此名称可以是 1 到 32 个字母数字字符。

您不能使用空格或除 -（连字符）、“_”（下划线）、：（冒号）和。（句点）以外的任何特殊字符。

创建 VLAN 后，您不能更改此名称。

native

字符串

将 VLAN 指定为原生 VLAN。

选项

  • "yes"

  • "no" ← (默认)

password

字符串 / 必需

Cisco UCS Manager 身份验证的密码。

port

整数

连接期间要使用的端口号（默认情况下，对于 https 连接使用 443，对于 http 连接使用 80）。

proxy

字符串

如果 use_proxy 为 no，则指定要用于连接的代理。例如，‘http://proxy.xy.z:8080’

sharing

字符串

“共享类型”字段。

此 VLAN 是否细分为专用 VLAN 或辅助 VLAN。可以是以下之一：

none - 此 VLAN 没有任何辅助 VLAN 或专用 VLAN。这是一个常规 VLAN。

primary - 此 VLAN 可以有一个或多个辅助 VLAN，如“辅助 VLAN”区域所示。此 VLAN 是专用 VLAN 域中的主 VLAN。

isolated - 这是与主 VLAN 关联的专用 VLAN。此 VLAN 是一个隔离 VLAN。

community - 此 VLAN 可以与同一社区 VLAN 上的其他端口以及混杂端口通信。此 VLAN 是一个社区 VLAN。

选项

  • "none" ← (默认)

  • "primary"

  • "isolated"

  • "community"

state

字符串

如果为 present，将验证 VLAN 是否存在，如果需要，将创建 VLAN。

如果为 absent，将验证 VLAN 是否不存在，如果需要，将删除 VLAN。

选项

  • "present" ← (默认)

  • "absent"

use_proxy

布尔值

如果为 no，则不会使用系统环境变量定义的代理。

选项

  • false

  • true ← (默认)

use_ssl

布尔值

如果为 no，将使用 HTTP 连接而不是默认的 HTTPS 连接。

选项

  • false

  • true ← (默认)

username

字符串

Cisco UCS Manager 身份验证的用户名。

默认值： "admin"

示例

- name: Configure VLAN
  cisco.ucs.ucs_vlans:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: vlan2
    id: '2'
    native: 'yes'

- name: Remove VLAN
  cisco.ucs.ucs_vlans:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: vlan2
    state: absent

作者

  • David Soper (@dsoper2)

  • CiscoUcs (@CiscoUcs)