cisco.ucs.ucs_vsans 模块 – 在 Cisco UCS Manager 上配置 VSAN

注意

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

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

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

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

概要

  • 在 Cisco UCS Manager 上配置 VSAN。

要求

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

  • ucsmsdk

参数

参数

注释

fabric

字符串

VSAN 的 fabric 配置。 这可以是以下之一

common - VSAN 映射到所有可用 fabric 中的相同 VSAN ID。

A - VSAN 映射到仅存在于 fabric A 中的 VSAN ID。

B - VSAN 映射到仅存在于 fabric B 中的 VSAN ID。

选项

  • "common" ← (默认)

  • "A"

  • "B"

fc_zoning

字符串

Cisco UCS 域的光纤通道分区配置。

光纤通道分区可以设置为以下值之一

disabled - 上游交换机处理光纤通道分区，或者 Cisco UCS 域未实现光纤通道分区。

enabled - Cisco UCS Manager 配置并控制 Cisco UCS 域的光纤通道分区。

如果启用光纤通道分区，请不要使用任何用于光纤通道分区的 VSAN 配置上游交换机。

选项

  • "disabled" ← (默认)

  • "enabled"

hostname

字符串 / 必需

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

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

name

字符串 / 必需

分配给 VSAN 的名称。

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

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

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

password

字符串 / 必需

用于 Cisco UCS Manager 身份验证的密码。

port

整数

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

proxy

字符串

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

state

字符串

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

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

选项

  • "present" ← (默认)

  • "absent"

use_proxy

布尔值

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

选项

  • false

  • true ← (默认)

use_ssl

布尔值

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

选项

  • false

  • true ← (默认)

username

字符串

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

默认： "admin"

vlan_id

字符串

分配给用于光纤通道连接的 VLAN 的唯一字符串标识符。

请注意，Cisco UCS Manager 使用 VLAN ‘4048’。 如果要将 ‘4048’ 分配给 VLAN，请参阅 UCS Manager 配置指南。

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

vsan_id

字符串

分配给 VSAN 的唯一标识符。

ID 可以是 ‘1’ 到 ‘4078’ 之间或 ‘4080’ 到 ‘4093’ 之间的字符串。 ‘4079’ 是保留的 VSAN ID。

此外，如果您计划使用 FC 端主机模式，则 ‘3840’ 到 ‘4079’ 之间的范围也是保留的 VSAN ID 范围。

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

示例

- name: Configure VSAN
  cisco.ucs.ucs_vsans:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: vsan110
    fabric: common
    vsan_id: '110'
    vlan_id: '110'

- name: Remove VSAN
  cisco.ucs.ucs_vsans:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: vsan110
    state: absent

作者

  • David Soper (@dsoper2)

  • John McDonough (@movinalot)

  • CiscoUcs (@CiscoUcs)