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 的结构配置。可以是以下之一：

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

A - VSAN 映射到仅在结构 A 中存在的 VSAN ID。

B - VSAN 映射到仅在结构 B 中存在的 VSAN ID。

选项

  • "common" ← (默认)

  • "A"

  • "B"

fc_zoning

字符串

Cisco UCS 域的 Fibre Channel 分区配置。

Fibre Channel 分区可以设置为以下值之一：

disabled — 上游交换机处理 Fibre Channel 分区，或者 Cisco UCS 域未实现 Fibre Channel 分区。

enabled — Cisco UCS Manager 配置和控制 Cisco UCS 域的 Fibre Channel 分区。

如果启用 Fibre Channel 分区，请不要使用任何用于 Fibre Channel 分区的 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

字符串

分配给用于 Fibre Channel 连接的 VLAN 的唯一字符串标识符。

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

如果 state 为 absent，则可选。

vsan_id

字符串

分配给 VSAN 的唯一标识符。

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

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

如果 state 为 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)