ucs_mac_pool – Configures MAC address pools on Cisco UCS Manager
ucs_mac_pool – Configures MAC address pools on Cisco UCS Manager
New in version 2.5.
Synopsis
- Configures MAC address pools and MAC address blocks on Cisco UCS Manager.
- Examples can be used with the UCS Platform Emulator https://communities.cisco.com/ucspe.
Requirements
The below requirements are needed on the host that executes this module.
- ucsmsdk
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
descrption - |
A description of the MAC pool. 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).
| |
first_addr - |
The first MAC address in the block of addresses. This is the From field in the UCS Manager MAC Blocks menu. | |
hostname string / required |
IP address or hostname of Cisco UCS Manager. | |
last_addr - |
The last MAC address in the block of addresses. This is the To field in the UCS Manager Add MAC Blocks menu. | |
name - / required |
The name of the MAC pool. This name can be between 1 and 32 alphanumeric characters. You cannot use spaces or any special characters other than - (hyphen), "_" (underscore), : (colon), and . (period). You cannot change this name after the MAC pool is created. | |
order - |
|
The Assignment Order field. This can be one of the following: default - Cisco UCS Manager selects a random identity from the pool. sequential - Cisco UCS Manager selects the lowest available identity from the pool. |
org_dn - |
Default: "org-root" |
The distinguished name (dn) of the organization where the resource is assigned. |
password string / required |
Password for Cisco UCS Manager authentication. | |
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' | |
state - |
|
If If |
use_proxy boolean |
|
If |
use_ssl boolean |
|
If |
username string |
Default: "admin" |
Username for Cisco UCS Manager authentication. |
Examples
- name: Configure MAC address pool
ucs_mac_pool:
hostname: 172.16.143.150
username: admin
password: password
name: mac-A
first_addr: 00:25:B5:00:66:00
last_addr: 00:25:B5:00:67:F3
order: sequential
- name: Remove MAC address pool
ucs_mac_pool:
hostname: 172.16.143.150
username: admin
password: password
name: mac-A
state: absent
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by an Ansible Partner. [certified]
Authors
- David Soper (@dsoper2)
- CiscoUcs (@CiscoUcs)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/ucs_mac_pool_module.html