kaytus.ksmanage.edit_ipv4 模块 – 设置 IPv4 信息

注意

此模块是 kaytus.ksmanage 集合(版本 2.0.0)的一部分。

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

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

要在 Playbook 中使用它,请指定:kaytus.ksmanage.edit_ipv4

kaytus.ksmanage 1.0.0 中的新功能

概要

  • 在 kaytus 服务器上设置 IPv4 信息。

要求

执行此模块的主机需要满足以下要求。

  • Python 3.7+

  • inManage

参数

参数

注释

host

字符串

指定用于通过指定传输连接到远程设备的 DNS 主机名或地址。host 的值用作传输的目标地址。

interface_name

字符串 / 必需

设置接口名称。选择要配置的 LAN 接口。

选项

  • "eth0"

  • "eth1"

  • "bond0"

ipv4_address

字符串

如果禁用 DHCP,请指定要为选定接口配置的静态 IPv4 地址。

当 *ipv4_dhcp_enable=static* 时是必需的。

ipv4_dhcp_enable

字符串

启用“启用 DHCP”以使用动态主机配置协议 (DHCP) 动态配置 IPv4 地址。

选项

  • "dhcp"

  • "static"

ipv4_gateway

字符串

如果禁用 DHCP,请指定要为选定接口配置的静态默认网关。

当 *ipv4_dhcp_enable=static* 时是必需的。

ipv4_status

字符串

启用或禁用 IPV4。

选项

  • "enable"

  • "disable"

ipv4_subnet

字符串

如果禁用 DHCP,请指定要为选定接口配置的静态子网掩码。

当 *ipv4_dhcp_enable=static* 时是必需的。

password

字符串

指定用于验证与远程设备连接的密码。如果任务中未指定该值,则将改为使用环境变量 ANSIBLE_NET_PASSWORD 的值。

provider

字典

包含连接详细信息的字典对象。

host

字符串

指定用于通过指定传输连接到远程设备的 DNS 主机名或地址。host 的值用作传输的目标地址。

password

字符串

指定用于验证与远程设备连接的密码。如果任务中未指定该值,则将改为使用环境变量 ANSIBLE_NET_PASSWORD 的值。

username

字符串

配置用于验证与远程设备连接的用户名。如果任务中未指定该值,则将改为使用环境变量 ANSIBLE_NET_USERNAME 的值。

username

字符串

配置用于验证与远程设备连接的用户名。如果任务中未指定该值,则将改为使用环境变量 ANSIBLE_NET_USERNAME 的值。

说明

注意

  • 不支持 check_mode

示例

- name: Ipv4 test
  hosts: ksmanage
  connection: local
  gather_facts: false
  vars:
    ksmanage:
      host: "{{ ansible_ssh_host }}"
      username: "{{ username }}"
      password: "{{ password }}"

  tasks:

  - name: "Set ipv4 information"
    kaytus.ksmanage.edit_ipv4:
      interface_name: "eth0"
      ipv4_status: "disable"
      provider: "{{ ksmanage }}"

  - name: "Set ipv4 information"
    kaytus.ksmanage.edit_ipv4:
      interface_name: "eth0"
      ipv4_status: "enable"
      ipv4_dhcp_enable: "dhcp"
      provider: "{{ ksmanage }}"

  - name: "Set ipv4 information"
    kaytus.ksmanage.edit_ipv4:
      interface_name: "eth0"
      ipv4_status: "enable"
      ipv4_dhcp_enable: "static"
      ipv4_address: "100.2.36.10"
      ipv4_subnet: "255.255.255.0"
      ipv4_gateway: "100.2.36.1"
      provider: "{{ ksmanage }}"

返回值

通用返回值记录在此处,以下是此模块特有的字段

描述

changed

布尔值

检查设备上是否进行了更改。

返回: 总是

message

字符串

模块执行后返回的消息。

返回: 总是

state

字符串

模块执行后的状态。

返回: 总是

作者

  • WangBaoshan (@ieisystem)