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 域名记录的信息。
参数
参数 |
注释 |
---|---|
DigitalOcean API 基本 URL。 默认值: |
|
域名名称。 |
|
DigitalOcean OAuth 令牌。 还有其他几个环境变量可用于提供此值。 例如 - |
|
用于检索特定记录。 |
|
指示目标所需的最终状态。 选项
|
|
用于轮询 DigitalOcean API 的超时秒数。 默认值: |
|
您要检索的记录类型。 选项
|
|
如果设置为 仅应在使用自签名证书的个人控制站点上将其设置为 选项
|
注释
注意
使用 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 域名记录列表 返回: 成功 示例: |