vultr.cloud.dns_domain 模块 – 在 Vultr 上管理 DNS 域名

注意

此模块是 vultr.cloud 集合（版本 1.13.0）的一部分。

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

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

要在 playbook 中使用它，请指定：vultr.cloud.dns_domain。

vultr.cloud 1.0.0 中的新功能

概要

  • 创建和删除 DNS 域名。

参数

参数

注释

api_endpoint

字符串

API 端点的 URL（不带尾部斜杠）。

备用环境变量 VULTR_API_ENDPOINT。

默认值: "https://api.vultr.com/v2"

api_key

字符串 / 必填

Vultr API 的 API 密钥。

备用环境变量 VULTR_API_KEY。

api_retries

整数

如果 Vultr API 返回 HTTP 错误代码（例如 - 429 请求过多 - 500 内部服务器错误 - 504 网关超时），则重试次数。

备用环境变量 VULTR_API_RETRIES。

默认值: 5

api_retry_max_delay

整数

重试退避延迟（以秒为单位）呈指数增长，直到达到此最大值（以秒为单位）。

备用环境变量 VULTR_API_RETRY_MAX_DELAY。

默认值: 12

api_timeout

整数

到 Vultr API 的 HTTP 超时。

备用环境变量 VULTR_API_TIMEOUT。

默认值: 180

dns_sec

字符串

确保启用或禁用 DNSSEC。

选择

  • "已启用"

  • "已禁用" ← (默认)

domain

别名: name

字符串 / 必填

域名。

ip

别名: server_ip

字符串

默认服务器 IP。

使用 vultr.cloud.dns_record 在创建域后更改它。

如果 state=present，则为必填项。

state

字符串

DNS 域的状态。

选择

  • "present" ← (默认)

  • "absent"

validate_certs

布尔值

验证 Vultr API 的 SSL 证书。

选择

  • false

  • true ← (默认)

注释

注意

示例

- name: Ensure a domain exists with DNSSEC
  vultr.cloud.dns_domain:
    name: example.com
    dns_sec: enabled
    server_ip: 10.10.10.10

- name: Ensure a domain is absent
  vultr.cloud.dns_domain:
    name: example.com
    state: absent

返回值

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

键

描述

vultr_api

字典

来自 Vultr API 的响应，其中包含一些添加/修改。

返回: 成功

api_endpoint

字符串

用于 API 请求的端点。

返回: 成功

示例: "https://api.vultr.com/v2"

api_retries

整数

API 请求的最大重试次数。

返回: 成功

示例: 5

api_retry_max_delay

整数

重试之间以秒为单位的指数退避延迟，直到达到此最大延迟值。

返回: 成功

示例: 12

api_timeout

整数

用于 API 请求的超时。

返回: 成功

示例: 60

vultr_dns_domain

字典

来自 Vultr API 的响应。

返回: 成功

date_created

字符串

创建 DNS 域的日期。

返回: 成功

示例: "2020-10-10T01:56:20+00:00"

dns_sec

字符串

是否启用或禁用 DNSSEC。

返回: 成功

示例: "已禁用"

name

字符串

DNS 域的名称。

返回: 成功

示例: "example.com"

作者

  • René Moser (@resmo)