inspur.ispim.edit_ipv4 模块 – 设置 IPv4 信息

注意

此模块是 inspur.ispim 集合 (版本 2.2.3) 的一部分。

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

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

要在 playbook 中使用它，请指定： inspur.ispim.edit_ipv4。

inspur.ispim 1.0.0 中的新增功能

概要 

在 Inspur 服务器上设置 IPv4 信息。

要求 

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

Python 3.7+
inspursmsdk

参数 

参数	注释
host 字符串	指定通过指定的传输连接到远程设备的 DNS 主机名或地址。host 的值用作传输的目标地址。
interface_name 字符串 / 必填	设置 interface_name。选项 `"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: ism
  connection: local
  gather_facts: no
  vars:
    ism:
      host: "{{ ansible_ssh_host }}"
      username: "{{ username }}"
      password: "{{ password }}"

  tasks:

  - name: "Set ipv4 information"
    inspur.ispim.edit_ipv4:
      interface_name: "eth0"
      ipv4_status: "disable"
      provider: "{{ ism }}"

  - name: "Set ipv4 information"
    inspur.ispim.edit_ipv4:
      interface_name: "eth0"
      ipv4_status: "enable"
      ipv4_dhcp_enable: "dhcp"
      provider: "{{ ism }}"

  - name: "Set ipv4 information"
    inspur.ispim.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: "{{ ism }}"

返回值 

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

键	描述
changed 布尔值	检查设备上是否进行了更改。返回：始终
message 字符串	模块执行后返回的消息。返回：始终
state 字符串	模块执行后的状态。返回：始终

作者

王宝山 (@ispim)