ieisystem.inmanage.edit_dns 模块 – 设置 DNS 信息

注意

此模块是 ieisystem.inmanage 集合(版本 3.0.0)的一部分。

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

要安装它,请使用:ansible-galaxy collection install ieisystem.inmanage。您需要进一步的要求才能使用此模块,请参阅 要求 了解详细信息。

要在 playbook 中使用它,请指定:ieisystem.inmanage.edit_dns

ieisystem.inmanage 1.0.0 中的新增功能

概要

  • 在 ieisystem 服务器上设置 DNS 信息。

要求

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

  • Python 3.7+

  • inManage

参数

参数

注释

dns_iface

字符串

DNS 接口,输入类似 'eth0'、'eth1'、'bond0'。

dns_manual=auto 时必需。

dns_manual

字符串

DNS 设置。选择是手动配置还是自动配置 DNS 接口。

选项

  • "manual"

  • "auto"

dns_priority

字符串

IP 优先级。

dns_manual=auto 时必需。

选项

  • "4"

  • "6"

dns_server1

字符串

DNS 服务器 1 IPv4 或 IPv6 地址。

dns_manual=manual 时必需。

dns_server2

字符串

DNS 服务器 2 IPv4 或 IPv6 地址。

dns_manual=manual 时必需。

dns_server3

字符串

DNS 服务器 3 IPv4 或 IPv6 地址。

dns_manual=manual 时必需。

dns_status

字符串

DNS 状态。

选项

  • "enable"

  • "disable"

domain_iface

字符串

网络接口,输入类似 'eth0_v4'、'eth0_v6'、'eth1_v4'、'eth1_v6'、'bond0_v4'、'bond0_v6'。

domain_manual=auto 时必需。

domain_manual

字符串

域设置。选择是手动配置还是自动配置域接口。

选项

  • "manual"

  • "auto"

domain_name

字符串

域名。

domain_manual=manual 时必需。

host

字符串

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

host_cfg

字符串

主机设置。选择是手动配置还是自动配置主机名。

选项

  • "manual"

  • "auto"

host_name

字符串

主机名。

host_cfg=manual 时必需。

password

字符串

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

provider

字典

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

host

字符串

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

password

字符串

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

username

字符串

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

register_status1

字符串

BMC 注册状态 1。

只有 M6 型号支持此参数。

选项

  • "enable"

  • "disable"

register_status2

字符串

BMC 注册状态 2。

只有 M6 型号支持此参数。

选项

  • "enable"

  • "disable"

registration_method1

字符串

注册方法 1。

只有 M6 型号支持此参数。

register_status1=enable 时必需。

选项

  • "nsupdate"

  • "dhcp"

  • "hostname"

registration_method2

字符串

注册方法 2。

只有 M6 型号支持此参数。

register_status2=enable 时必需。

选项

  • "nsupdate"

  • "dhcp"

  • "hostname"

username

字符串

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

注释

注意

  • 不支持 check_mode

示例

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

  tasks:

  - name: "Set dns information"
    ieisystem.inmanage.edit_dns:
      dns_status: "disable"
      provider: "{{ inmanage }}"

  - name: "Set dns information"
    ieisystem.inmanage.edit_dns:
      dns_status: "enable"
      host_cfg: "manual"
      host_name: "123456789"
      domain_manual: "auto"
      domain_iface: "eth0_v4"
      dns_manual: "manual"
      dns_server1: "100.2.2.2"
      dns_server2: "100.2.2.3"
      dns_server3: "100.2.2.4"
      provider: "{{ inmanage }}"

  - name: "Set dns information"
    ieisystem.inmanage.edit_dns:
      dns_status: "enable"
      host_cfg: "manual"
      host_name: "123456789"
      domain_manual: "manual"
      domain_name: "test.com"
      dns_manual: "auto"
      dns_iface: "eth0"
      dns_priority: "4"
      provider: "{{ inmanage }}"

返回值

常见的返回值记录在这里,以下是此模块特有的字段

描述

changed

布尔值

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

返回: 总是

message

字符串

模块执行后返回的消息。

返回: 总是

state

字符串

模块执行后的状态。

返回: 总是

作者

  • WangBaoshan (@ieisystem)