community.digitalocean.digital_ocean_domain_record_info 模块 – 收集 DigitalOcean 域名记录的信息

注意

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

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

要安装它,请使用:ansible-galaxy collection install community.digitalocean

要在 playbook 中使用它,请指定:community.digitalocean.digital_ocean_domain_record_info

community.digitalocean 1.16.0 中的新增功能

概要

  • 收集 DigitalOcean 域名记录的信息。

参数

参数

注释

baseurl

字符串

DigitalOcean API 基本 URL。

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

name

别名:domain, domain_name

字符串 / 必需

域名名称。

oauth_token

别名:api_token

字符串

DigitalOcean OAuth 令牌。

还有其他几个环境变量可用于提供此值。

例如 - DO_API_TOKENDO_API_KEYDO_OAUTH_TOKENOAUTH_TOKEN

record_id

整数

用于检索特定记录。

state

字符串

指示目标所需的最终状态。

选项

  • "present" ← (默认)

timeout

整数

用于轮询 DigitalOcean API 的超时秒数。

默认值: 30

type

字符串

您要检索的记录类型。

选项

  • "A"

  • "AAAA"

  • "CNAME"

  • "MX"

  • "TXT"

  • "SRV"

  • "NS"

  • "CAA"

validate_certs

布尔值

如果设置为 no,则不会验证 SSL 证书。

仅应在使用自签名证书的个人控制站点上将其设置为 no

选项

  • true ← (默认)

注释

注意

  • 使用 DigitalOcean API 的版本 2。

  • 当前通过 API 发出的请求数量限制为每个 OAuth 令牌每小时 5,000 个。

示例

- name: Retrieve all domain records for example.com
  community.digitalocean.digital_ocean_domain_record_info:
    state: present
    oauth_token: "{{ lookup('ansible.builtin.env', 'DO_API_TOKEN') }}"
    domain: example.com

- name: Get specific domain record by ID
  community.digitalocean.digital_ocean_domain_record_info:
    state: present
    oauth_token: "{{ lookup('ansible.builtin.env', 'DO_API_TOKEN') }}"
    record_id: 12345789
  register: result

- name: Retrieve all A domain records for example.com
  community.digitalocean.digital_ocean_domain_record_info:
    state: present
    oauth_token: "{{ lookup('ansible.builtin.env', 'DO_API_TOKEN') }}"
    domain: example.com
    type: A

返回值

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

描述

数据

列表 / 元素=字典

DigitalOcean 域名记录列表

返回: 成功

示例: [{"data": "ns1.digitalocean.com", "flags": null, "id": 296972269, "name": "@", "port": null, "priority": null, "tag": null, "ttl": 1800, "type": "NS", "weight": null}]

作者

  • Adam Papai (@woohgit)

  • Mark Mercado (@mamercad)