cisco.ucs.ucs_ip_pool 模块 – 在 Cisco UCS Manager 上配置 IP 地址池

注意

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

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

要安装它，请使用：ansible-galaxy collection install cisco.ucs。您需要其他需求才能使用此模块，有关详细信息，请参阅 需求。

要在剧本中使用它，请指定：cisco.ucs.ucs_ip_pool。

概要

• 在 Cisco UCS Manager 上配置 IP 地址池和 IP 地址块。

需求

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

• ucsmsdk

参数

参数	注释
description 别名：descr 字符串	IP 地址池的用户定义描述。 最多输入 256 个字符。 您可以使用除以下字符外的任何字符或空格 ` (重音符)、\ (反斜杠)、^ (脱字符)、” (双引号)、= (等号)、> (大于)、< (小于) 或 ‘ (单引号)。
hostname 字符串 / 必需	Cisco UCS Manager 的 IP 地址或主机名。 模块可与 UCS 平台仿真器 https://cs.co/ucspe 一起使用
ipv4_blocks 列表 / 元素=字典	IP 池使用的 IPv4 块列表。
default_gw 字符串	与块中的 IPv4 地址关联的默认网关。 默认值： "0.0.0.0"
first_addr 字符串	IPv4 地址块中的第一个 IPv4 地址。 这是 UCS Manager“添加 IPv4 块”菜单中的“起始”字段。
last_addr 字符串	IPv4 地址块中的最后一个 IPv4 地址。 这是 UCS Manager“添加 IPv4 块”菜单中的“结束”字段。
primary_dns 字符串	此 IPv4 地址块应访问的主 DNS 服务器。 默认值： "0.0.0.0"
secondary_dns 字符串	此 IPv4 地址块应访问的辅助 DNS 服务器。 默认值： "0.0.0.0"
state 字符串	如果为 present，将验证 IP 块是否存在，如果需要，将创建 IP 块。 如果为 absent，将验证 IP 块是否不存在，如果需要，将删除 IP 块。 选项 "present" ← (默认) "absent"
subnet_mask 字符串	与块中的 IPv4 地址关联的子网掩码。 默认值： "255.255.255.0"
ipv6_blocks 列表 / 元素=字典	IP 池使用的 IPv6 块列表。
ipv6_default_gw 字符串	与块中的 IPv6 地址关联的默认网关。 默认值： "::"
ipv6_first_addr 字符串	IPv6 地址块中的第一个 IPv6 地址。 这是 UCS Manager“添加 IPv6 块”菜单中的“起始”字段。
ipv6_last_addr 字符串	IPv6 地址块中的最后一个 IPv6 地址。 这是 UCS Manager“添加 IPv6 块”菜单中的“结束”字段。
ipv6_prefix 字符串	与块中的 IPv6 地址关联的网络地址前缀。 默认值： "64"
ipv6_primary_dns 字符串	此 IPv6 地址块应访问的主 DNS 服务器。 默认值： "::"
ipv6_secondary_dns 字符串	此 IPv6 地址块应访问的辅助 DNS 服务器。 默认值： "::"
state 字符串	如果为 present，将验证 IP 块是否存在，如果需要，将创建 IP 块。 如果为 absent，将验证 IP 块是否不存在，如果需要，将删除 IP 块。 选项 "present" ← (默认) "absent"
name 字符串 / 必需	IP 地址池的名称。 此名称可以是 1 到 32 个字母数字字符。 您不能使用空格或除 - (连字符)、“_” (下划线)、: (冒号) 和 . (句点) 之外的任何特殊字符。 创建 IP 地址池后，您不能更改此名称。
order 字符串	分配顺序字段。 可以是以下之一 default - Cisco UCS Manager 从池中随机选择一个标识。 sequential - Cisco UCS Manager 从池中选择最低可用标识。 选项 "default" ← (默认) "sequential"
org_dn 字符串	组织 DN（可分辨名称） 默认值： "org-root"
password 字符串 / 必需	Cisco UCS Manager 身份验证密码。
port 整数	连接期间要使用的端口号（默认情况下，对 https 连接使用 443，对 http 连接使用 80）。
proxy 字符串	如果 use_proxy 为否，则指定要用于连接的代理。例如，‘http://proxy.xy.z:8080’
state 字符串	如果为 present，将验证 IP 池是否存在，如果需要，将创建 IP 池。 如果为 absent，将验证 IP 池是否不存在，如果需要，将删除 IP 池。 选项 "present" ← (默认) "absent"
use_proxy 布尔值	如果为 no，则不使用系统环境变量定义的代理。 选项 false true ← (默认)
use_ssl 布尔值	如果为no，则将使用 HTTP 连接而不是默认的 HTTPS 连接。 选项 false true ← (默认)
username 字符串	Cisco UCS Manager 身份验证的用户名。 默认值： "admin"

示例

- name: Configure IPv4 and IPv6 address pool
  cisco.ucs.ucs_ip_pool:
    hostname: "{{ ucs_hostname }}"
    username: "{{ ucs_username }}"
    password: "{{ ucs_password }}"
    name: ip-pool-01
    org_dn: org-root/org-level1
    ipv4_blocks:
    - first_addr: 192.168.10.1
      last_addr: 192.168.10.20
      subnet_mask: 255.255.255.128
      default_gw: 192.168.10.2
    - first_addr: 192.168.11.1
      last_addr: 192.168.11.20
      subnet_mask: 255.255.255.128
      default_gw: 192.168.11.2
    ipv6_blocks:
    - ipv6_first_addr: fe80::1cae:7992:d7a1:ed07
      ipv6_last_addr: fe80::1cae:7992:d7a1:edfe
      ipv6_default_gw: fe80::1cae:7992:d7a1:ecff
    - ipv6_first_addr: fe80::1cae:7992:d7a1:ec07
      ipv6_last_addr: fe80::1cae:7992:d7a1:ecfe
      ipv6_default_gw: fe80::1cae:7992:d7a1:ecff

- name: Delete IPv4 and IPv6 address pool blocks
  cisco.ucs.ucs_ip_pool:
    hostname: "{{ ucs_hostname }}"
    username: "{{ ucs_username }}"
    password: "{{ ucs_password }}"
    name: ip-pool-01
    org_dn: org-root/org-level1
    ipv4_blocks:
    - first_addr: 192.168.10.1
      last_addr: 192.168.10.20
      state: absent
    ipv6_blocks:
    - ipv6_first_addr: fe80::1cae:7992:d7a1:ec07
      ipv6_last_addr: fe80::1cae:7992:d7a1:ecfe
      state: absent

- name: Remove IPv4 and IPv6 address pool
  cisco.ucs.ucs_ip_pool:
    hostname: "{{ ucs_hostname }}"
    username: "{{ ucs_username }}"
    password: "{{ ucs_password }}"
    name: ip-pool-01
    state: absent

作者

• Brett Johnson (@sdbrett)

• David Soper (@dsoper2)

• John McDonough (@movinalot)

• CiscoUcs (@CiscoUcs)

资源链接

• 问题追踪器
• 代码仓库