ansible / ansible.builtin / v2.9.0 / module / ucs_ip_pool Configures IP address pools on Cisco UCS Manager | "added in version" 2.5 of ansible.builtin" Authors: David Soper (@dsoper2), CiscoUcs (@CiscoUcs) preview | supported by certifiedansible.builtin.ucs_ip_pool (v2.9.0) — module
pip
Install with pip install ansible==2.9.0
Configures IP address pools and blocks of IP addresses on Cisco UCS Manager.
Examples can be used with the UCS Platform Emulator U(https://communities.cisco.com/ucspe).
- name: Configure IPv4 address pools ucs_ip_pool: hostname: 172.16.143.150 username: admin password: password name: ip-A order: sequential first_addr: 192.168.0.10 last_addr: 192.168.0.19 subnet_mask: 255.255.255.0 default_gw: 192.168.0.1 primary_dns: 172.16.143.136
- name: Configure IPv6 address pools ucs_ip_pool: hostname: 172.16.143.150 username: admin password: password name: ipv6-B ipv6_first_addr: fe80::1cae:7992:d7a1:ed07 ipv6_last_addr: fe80::1cae:7992:d7a1:edfe ipv6_default_gw: fe80::1cae:7992:d7a1:ecff
- name: Remove IPv4 address pools ucs_ip_pool: hostname: 172.16.143.150 username: admin password: password name: ip-A state: absent
- name: Remove IPv6 address pools ucs_ip_pool: hostname: 172.16.143.150 username: admin password: password name: ipv6-B state: absent
name: description: - The name of the IP address 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 IP address pool is created. required: true port: description: - Port number to be used during connection (by default uses 443 for https and 80 for http connection). type: int order: choices: - default - sequential default: default description: - 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. proxy: description: - If use_proxy is no, specfies proxy to be used for connection. e.g. 'http://proxy.xy.z:8080' type: str state: choices: - present - absent default: present description: - If C(present), will verify IP pool is present and will create if needed. - If C(absent), will verify IP pool is absent and will delete if needed. org_dn: default: org-root description: - Org dn (distinguished name) use_ssl: default: true description: - If C(no), an HTTP connection will be used instead of the default HTTPS connection. type: bool hostname: description: - IP address or hostname of Cisco UCS Manager. - Modules can be used with the UCS Platform Emulator U(https://cs.co/ucspe) required: true type: str password: description: - Password for Cisco UCS Manager authentication. required: true type: str username: default: admin description: - Username for Cisco UCS Manager authentication. type: str last_addr: description: - The last IPv4 address in the IPv4 addresses block. - This is the To field in the UCS Manager Add IPv4 Blocks menu. use_proxy: default: true description: - If C(no), will not use the proxy as defined by system environment variable. type: bool default_gw: default: 0.0.0.0 description: - The default gateway associated with the IPv4 addresses in the block. first_addr: description: - The first IPv4 address in the IPv4 addresses block. - This is the From field in the UCS Manager Add IPv4 Blocks menu. description: aliases: - descr - descrption description: - The user-defined description of the IP address 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).' ipv6_prefix: default: '64' description: - The network address prefix associated with the IPv6 addresses in the block. primary_dns: default: 0.0.0.0 description: - The primary DNS server that this block of IPv4 addresses should access. subnet_mask: default: 255.255.255.0 description: - The subnet mask associated with the IPv4 addresses in the block. secondary_dns: default: 0.0.0.0 description: - The secondary DNS server that this block of IPv4 addresses should access. ipv6_last_addr: description: - The last IPv6 address in the IPv6 addresses block. - This is the To field in the UCS Manager Add IPv6 Blocks menu. ipv6_default_gw: default: '::' description: - The default gateway associated with the IPv6 addresses in the block. ipv6_first_addr: description: - The first IPv6 address in the IPv6 addresses block. - This is the From field in the UCS Manager Add IPv6 Blocks menu. ipv6_primary_dns: default: '::' description: - The primary DNS server that this block of IPv6 addresses should access. ipv6_secondary_dns: default: '::' description: - The secondary DNS server that this block of IPv6 addresses should access.