cisco.ucs.ucs_vhba_template – Configures vHBA templates on Cisco UCS Manager
cisco.ucs.ucs_vhba_template – Configures vHBA templates on Cisco UCS Manager
Note
This plugin is part of the cisco.ucs collection (version 1.6.0).
To install it use: ansible-galaxy collection install cisco.ucs
.
To use it in a playbook, specify: cisco.ucs.ucs_vhba_template
.
New in version 2.5: of cisco.ucs
Synopsis
- Configures vHBA templates on Cisco UCS Manager.
Requirements
The below requirements are needed on the host that executes this module.
- ucsmsdk
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
description string |
A user-defined description of the template. Enter up to 256 characters. You can use any characters or spaces except the following: ` (accent mark), (backslash), ^ (carat), " (double quote), = (equal sign), > (greater than), < (less than), or ' (single quote).
| |
fabric string |
|
The Fabric ID field. The name of the fabric interconnect that vHBAs created with this template are associated with. |
hostname string / required |
IP address or hostname of Cisco UCS Manager. Modules can be used with the UCS Platform Emulator https://cs.co/ucspe | |
max_data string |
Default: "2048" |
The Max Data Field Size field. The maximum size of the Fibre Channel frame payload bytes that the vHBA supports. Enter an string between '256' and '2112'. |
name string / required |
The name of the virtual HBA template. This name can be between 1 and 16 alphanumeric characters. You cannot use spaces or any special characters other than - (hyphen), "_" (underscore), : (colon), and . (period). You cannot change this name after the template is created. | |
org_dn string |
Default: "org-root" |
Org dn (distinguished name) |
password string / required |
Password for Cisco UCS Manager authentication. | |
pin_group string |
The SAN pin group that is associated with vHBAs created from this template. | |
port integer |
Port number to be used during connection (by default uses 443 for https and 80 for http connection). | |
proxy string |
If use_proxy is no, specfies proxy to be used for connection. e.g. 'http://proxy.xy.z:8080' | |
qos_policy string |
The QoS policy that is associated with vHBAs created from this template. | |
redundancy_type string |
|
The Redundancy Type used for template pairing from the Primary or Secondary redundancy template. primary — Creates configurations that can be shared with the Secondary template. Any other shared changes on the Primary template are automatically synchronized to the Secondary template. secondary — All shared configurations are inherited from the Primary template. none - Legacy vHBA template behavior. Select this option if you do not want to use redundancy. |
state string |
|
If If |
stats_policy string |
Default: "default" |
The statistics collection policy that is associated with vHBAs created from this template. |
template_type string |
|
The Template Type field. This can be one of the following: initial-template — vHBAs created from this template are not updated if the template changes. updating-template - vHBAs created from this template are updated if the template changes. |
use_proxy boolean |
|
If |
use_ssl boolean |
|
If |
username string |
Default: "admin" |
Username for Cisco UCS Manager authentication. |
vsan string |
Default: "default" |
The VSAN to associate with vHBAs created from this template. |
wwpn_pool string |
Default: "default" |
The WWPN pool that a vHBA created from this template uses to derive its WWPN address. |
Examples
- 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
Authors
- David Soper (@dsoper2)
- John McDonough (@movinalot)
- CiscoUcs (@CiscoUcs)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/cisco/ucs/ucs_vhba_template_module.html