community.digitalocean.digital_ocean_domain_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_info。

概要

  • 此模块可用于收集有关 DigitalOcean 提供的域的信息。

  • 在 Ansible 2.9 之前，此模块被称为 digital_ocean_domain_facts。用法没有改变。

别名：digital_ocean_domain_facts

要求

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

  • python >= 2.6

参数

参数

注释

baseurl

字符串

DigitalOcean API 基本 URL。

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

domain_name

字符串

要收集信息的域名。

oauth_token

别名：api_token

字符串

DigitalOcean OAuth 令牌。

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

即， - DO_API_TOKEN, DO_API_KEY, DO_OAUTH_TOKEN 和 OAUTH_TOKEN。

timeout

整数

用于轮询 DigitalOcean API 的超时时间（以秒为单位）。

默认值： 30

validate_certs

布尔值

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

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

选项

  • false

  • true ← (默认)

示例

- name: Gather information about all domains
  community.digitalocean.digital_ocean_domain_info:
    oauth_token: "{{ oauth_token }}"

- name: Gather information about domain with given name
  community.digitalocean.digital_ocean_domain_info:
    oauth_token: "{{ oauth_token }}"
    domain_name: "example.com"

- name: Get ttl from domain
  community.digitalocean.digital_ocean_domain_info:
  register: resp_out
- set_fact:
    domain_ttl: "{{ item.ttl }}"
  loop: "{{ resp_out.data | community.general.json_query(name) }}"
  vars:
    name: "[?name=='example.com']"
- debug:
    var: domain_ttl

返回值

通用返回值记录在此处，以下是此模块特有的字段

键

描述

data

列表 / 元素=字典

DigitalOcean 域信息

已返回： 成功

示例： [{"domain_records": [{"data": "ns1.digitalocean.com", "flags": null, "id": 37826823, "name": "@", "port": null, "priority": null, "tag": null, "ttl": 1800, "type": "NS", "weight": null}], "name": "myexample123.com", "ttl": 1800, "zone_file": "myexample123.com. IN SOA ns1.digitalocean.com. hostmaster.myexample123.com. 1520702984 10800 3600 604800 1800\n"}]

作者

  • Abhijeet Kasurde (@Akasurde)