community.general.infinity 模块 – 使用 Rest API 管理 Infinity IPAM

注意

此模块是 community.general 集合（版本 10.1.0）的一部分。

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

要安装它，请使用：ansible-galaxy collection install community.general。

要在 playbook 中使用它，请指定：community.general.infinity。

概要

  • 使用 REST API 管理 Infinity IPAM。

参数

参数

注释

action

字符串 / 必需

要执行的操作

选择

  • "add_network"

  • "delete_network"

  • "get_network"

  • "get_network_id"

  • "release_ip"

  • "release_network"

  • "reserve_network"

  • "reserve_next_available_ip"

ip_address

字符串

用于保留或释放的 IP 地址。

network_address

字符串

具有 CIDR 格式的网络地址（例如，192.168.310.0）。

network_family

字符串

Infinity 定义的网络系列，例如 IPv4、IPv6 和双栈

选择

  • "4" ← (默认)

  • "6"

  • "dual"

network_id

字符串

网络 ID。

network_location

整数

给定网络的父网络 ID。

默认: -1

network_name

字符串

网络的名称。

network_size

字符串

网络位掩码（例如，255.255.255.220）或 CIDR 格式（例如，/26）。

network_type

字符串

Infinity 定义的网络类型

选择

  • "lan" ← (默认)

  • "shared_lan"

  • "supernet"

password

字符串 / 必需

Infinity 密码。

server_ip

字符串 / 必需

具有 IP 地址的 Infinity server_ip。

username

字符串 / 必需

用于访问 Infinity 的用户名。

用户必须具有 REST API 权限。

属性

属性

支持

描述

check_mode

支持: 无

可以在 check_mode 中运行，并返回更改的状态预测，而无需修改目标。

diff_mode

支持: 无

当处于差异模式时，将返回有关已更改（或可能需要在 check_mode 中更改）的详细信息。

示例

---
- hosts: localhost
  connection: local
  strategy: debug
  tasks:
    - name: Reserve network into Infinity IPAM
      community.general.infinity:
        server_ip: 80.75.107.12
        username: username
        password: password
        action: reserve_network
        network_name: reserve_new_ansible_network
        network_family: 4
        network_type: lan
        network_id: 1201
        network_size: /28
      register: infinity

返回值

常见返回值在此处记录 此处，以下是此模块独有的字段

键

描述

ip_info

字符串

当从网络保留下一个可用的 IP 地址时，将返回 IP 地址信息。

返回: 成功

示例: "{\"address\": \"192.168.10.3\", \"hostname\": \"\", \"FQDN\": \"\", \"domainname\": \"\", \"id\": 3229}"

network_id

字符串

给定网络的 ID

返回: 成功

示例: "1501"

network_info

字符串

当通过提供 network_size 从 Infinity 超网保留 LAN 网络时，将返回有关保留网络的信息。

返回: 成功

示例: "{'description': None, 'network_address': '192.168.10.32/28', 'network_family': '4', 'network_id': 3102, 'network_location': '3085', 'network_name': \"'reserve_new_ansible_network'\", 'network_size': None, 'network_type': 'lan', 'ranges': {'first_ip': None, 'id': 0, 'last_ip': None, 'name': None, 'type': None}}"

作者

  • Meirong Liu (@MeganLiu)