cisco.ucs.ucs_vhba_template 模块 – 在 Cisco UCS Manager 上配置 vHBA 模板

注意

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

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

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

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

概要

• 在 Cisco UCS Manager 上配置 vHBA 模板。

需求

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

• ucsmsdk

参数

参数	注释
description 别名：descr 字符串	模板的用户定义描述。 最多输入 256 个字符。 您可以使用除以下字符外的任何字符或空格 `（重音符）、\（反斜杠）、^（脱字符）、”（双引号）、=（等号）、>（大于）、<（小于）或’（单引号）。
fabric 字符串	Fabric ID 字段。 使用此模板创建的 vHBA 关联的 Fabric Interconnect 的名称。 选项 "A" ← (默认) "B"
hostname 字符串 / 必需	Cisco UCS Manager 的 IP 地址或主机名。 模块可与 UCS 平台模拟器 https://cs.co/ucspe 一起使用
max_data 字符串	最大数据字段大小字段。 vHBA 支持的 Fibre Channel 帧有效负载字节的最大大小。 输入介于“256”和“2112”之间的字符串。 默认值： "2048"
name 字符串 / 必需	虚拟 HBA 模板的名称。 此名称可以是 1 到 16 个字母数字字符。 您不能使用空格或除 -（连字符）、“_”（下划线）、：（冒号）和。（句点）以外的任何特殊字符。 模板创建后，您无法更改此名称。
org_dn 字符串	组织 DN（可分辨名称） 默认值： "org-root"
password 字符串 / 必需	Cisco UCS Manager 身份验证的密码。
pin_group 字符串	与使用此模板创建的 vHBA 关联的 SAN pin 组。
port 整数	连接期间要使用的端口号（默认情况下，对于 https 连接使用 443，对于 http 连接使用 80）。
proxy 字符串	如果 use_proxy 为 no，则指定要用于连接的代理。例如，`http://proxy.xy.z:8080`
qos_policy 字符串	与使用此模板创建的 vHBA 关联的 QoS 策略。
redundancy_type 字符串	用于从主或辅助冗余模板进行模板配对的冗余类型。 primary — 创建可以与辅助模板共享的配置。 主模板上的任何其他共享更改都会自动同步到辅助模板。 secondary — 所有共享配置都继承自主模板。 none - 旧版 vHBA 模板行为。如果您不想使用冗余，请选择此选项。 选项 "none" ← (默认) "primary" "secondary"
state 字符串	如果 present，将验证 vHBA 模板是否存在，如果需要则创建。 如果 absent，将验证 vHBA 模板是否不存在，如果需要则删除。 选项 "present" ← (默认) "absent"
stats_policy 字符串	与使用此模板创建的 vHBA 关联的统计信息收集策略。 默认值： "default"
template_type 字符串	模板类型字段。 这可以是以下之一 initial-template — 如果模板更改，则使用此模板创建的 vHBA 不会更新。 updating-template - 如果模板更改，则使用此模板创建的 vHBA 会更新。 选项 "initial-template" ← (默认) "updating-template"
use_proxy 布尔值	如果 no，则不使用系统环境变量定义的代理。 选项 false true ← (默认)
use_ssl 布尔值	如果 no，则将使用 HTTP 连接而不是默认的 HTTPS 连接。 选项 false true ← (默认)
username 字符串	Cisco UCS Manager 身份验证的用户名。 默认值： "admin"
vsan 字符串	与使用此模板创建的 vHBA 关联的 VSAN。 默认值： "default"
wwpn_pool 字符串	使用此模板创建的 vHBA 用于派生其 WWPN 地址的 WWPN 池。 默认值： "default"

示例

- name: Configure vHBA template
  cisco.ucs.ucs_vhba_template:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: vHBA-A
    fabric: A
    vsan: VSAN-A
    wwpn_pool: WWPN-Pool-A

- name: Remote vHBA template
  cisco.ucs.ucs_vhba_template:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: vHBA-A
    state: absent

作者

• David Soper (@dsoper2)

• John McDonough (@movinalot)

• CiscoUcs (@CiscoUcs)

集合链接

• 问题追踪器
• 代码库（源代码）