community.general.ipwcli_dns 模块 – 通过 ipwcli 管理爱立信 IPWorks 的 DNS 记录

注意

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

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

要安装它，请使用：ansible-galaxy collection install community.general。您需要其他要求才能使用此模块，请参阅 要求 以了解详情。

要在剧本中使用它，请指定：community.general.ipwcli_dns。

community.general 0.2.0 中的新增功能

概要

  • 管理爱立信 IPWorks DNS 服务器的 DNS 记录。该模块将使用 ipwcli 部署 DNS 记录。

要求

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

  • ipwcli（安装在爱立信 IPWorks 上）

参数

参数

注释

address

字符串

A 或 AAAA 记录的 IP 地址。

对于 type=A 或 type=AAAA 为必填。

container

字符串 / 必填

设置记录的容器区域。

dnsname

字符串 / 必填

记录的名称。

flags

字符串

设置 NAPTR 记录的可能标志之一。

对于 type=NAPTR 为必填。

选项

  • "S"

  • "A"

  • "U"

  • "P"

order

整数

设置 NAPTR 记录的顺序。

对于 type=NAPTR 为必填。

password

字符串 / 必填

登录 ipwcli 的密码。

port

整数

设置 SRV 记录的端口。

对于 type=SRV 为必填。

preference

整数

设置 NAPTR 记录的首选项。

对于 type=NAPTR 为必填。

priority

整数

设置 SRV 记录的优先级。

默认值： 10

replacement

字符串

设置 NAPTR 记录的替换。

对于 type=NAPTR 为必填。

service

字符串

设置 NAPTR 记录的服务。

对于 type=NAPTR 为必填。

state

字符串

记录是否存在。

选项

  • "absent"

  • "present" ← (默认)

target

字符串

设置 SRV 记录的目标。

对于 type=SRV 为必填。

ttl

整数

设置记录的 TTL。

默认值： 3600

type

字符串 / 必填

记录的类型。

选项

  • "NAPTR"

  • "SRV"

  • "A"

  • "AAAA"

username

字符串 / 必填

登录 ipwcli 的用户名。

weight

整数

设置 SRV 记录的权重。

默认值： 10

属性

属性

支持

描述

check_mode

支持：完全支持

可以在 check_mode 下运行，并在不修改目标的情况下返回更改状态预测。

diff_mode

支持：不支持

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

备注

注意

  • 要使 DNS 记录更改生效，需要在 ipwcli 上运行 update dnsserver。

示例

- name: Create A record
  community.general.ipwcli_dns:
    dnsname: example.com
    type: A
    container: ZoneOne
    address: 127.0.0.1

- name: Remove SRV record if exists
  community.general.ipwcli_dns:
    dnsname: _sip._tcp.test.example.com
    type: SRV
    container: ZoneOne
    ttl: 100
    state: absent
    target: example.com
    port: 5060

- name: Create NAPTR record
  community.general.ipwcli_dns:
    dnsname: test.example.com
    type: NAPTR
    preference: 10
    container: ZoneOne
    ttl: 100
    order: 10
    service: 'SIP+D2T'
    replacement: '_sip._tcp.test.example.com.'
    flags: S

返回值

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

键

描述

record

字符串

根据输入参数创建的记录

返回：始终返回

作者

  • Christian Wollinger (@cwollinger)