community.network.ipadm_addr 模块 – 管理 Solaris/illumos 系统接口上的 IP 地址

注意

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

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

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

要在 playbook 中使用它，请指定：community.network.ipadm_addr。

注意

community.network 集合已弃用，将从 Ansible 12 中移除。有关更多信息，请参阅讨论主题。

已弃用

在以下版本中删除:

版本 6.0.0

原因:

此集合及其中的所有内容均未维护且已弃用。

替代方案:

未知。

概要

  • 在 Solaris/illumos 系统上的网络接口上创建/删除静态/动态 IP 地址。

  • 在 Solaris/illumos 系统上的网络接口上启动/关闭静态/动态 IP 地址。

  • 在 Solaris/illumos 系统上的网络接口上管理 IPv6 链路本地地址。

别名：network.illumos.ipadm_addr

参数

参数

注释

address

别名：addr

字符串

指定要以 CIDR 表示法配置的 IP 地址。

addrobj

字符串 / 必需

指定系统上唯一的 IP 地址。

addrtype

字符串

指定要配置的 IP 地址的类型。

选项

  • "static" ← (默认)

  • "dhcp"

  • "addrconf"

state

字符串

在网络接口上创建/删除/启用/禁用 IP 地址。

选项

  • "absent"

  • "present" ← (默认)

  • "up"

  • "down"

  • "enabled"

  • "disabled"

  • "refreshed"

temporary

布尔值

指定配置的 IP 地址是临时的。临时 IP 地址不会在重启后保留。

选项

  • false ← (默认)

  • true

wait

字符串

指定我们等待通过 DHCP 获取地址的时间（以秒为单位）。

默认值: 60

示例

- name: Configure IP address 10.0.0.1 on e1000g0
  community.network.ipadm_addr: addr=10.0.0.1/32 addrobj=e1000g0/v4 state=present

- name: Delete addrobj
  community.network.ipadm_addr: addrobj=e1000g0/v4 state=absent

- name: Configure link-local IPv6 address
  community.network.ipadm_addr: addtype=addrconf addrobj=vnic0/v6

- name: Configure address via DHCP and wait 180 seconds for address obtaining
  community.network.ipadm_addr: addrobj=vnic0/dhcp addrtype=dhcp wait=180

返回值

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

键

描述

地址

字符串

IP 地址

返回: 仅当 addrtype 为“static”时

示例: "1.3.3.7/32"

addrobj

字符串

地址对象名称

返回: 总是

示例: "bge0/v4"

addrtype

字符串

地址类型

返回: 总是

示例: "static"

state

字符串

目标状态

返回: 总是

示例: "present"

temporary

布尔值

指定操作是否在重启后保留

返回: 总是

示例: true

wait

字符串

我们等待 DHCP 的时间

返回: 仅当 addrtype 为“dhcp”时

示例: "10"

状态

  • 此模块将在 6.0.0 版本中移除。[已弃用]

  • 更多信息请参阅 已弃用。

作者

  • Adam Števko (@xen0l)