Модуль 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.

Чтобы использовать ее в плейбуке, укажите: community.digitalocean.digital_ocean_domain_record_info.

Новое в community.digitalocean 1.16.0

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Сбор информации о записях домена DigitalOcean.

Параметры

Параметр	Комментарии
baseurl строка	Базовый URL API DigitalOcean. По умолчанию: `"https://api.digitalocean.com/v2"`
name псевдонимы: domain, domain_name строка / обязательный	Имя домена.
oauth_token псевдонимы: api_token строка	Токен DigitalOcean OAuth. Существует несколько других переменных среды, которые можно использовать для предоставления этого значения. Например, - `DO_API_TOKEN`, `DO_API_KEY`, `DO_OAUTH_TOKEN` и `OAUTH_TOKEN`.
record_id целое число	Используется для получения конкретной записи.
state строка	Указывает желаемое состояние целевого объекта. Варианты: `"present"` ← (по умолчанию)
timeout целое число	Таймаут в секундах, используемый для опроса API DigitalOcean. По умолчанию: `30`
type строка	Тип записи, которую вы хотите получить. Варианты: `"A"` `"AAAA"` `"CNAME"` `"MX"` `"TXT"` `"SRV"` `"NS"` `"CAA"`
validate_certs логическое	Если установлено значение `no`, сертификаты SSL не будут проверены. Это следует устанавливать только в `no` при работе с сайтами под личным контролем с использованием самозаверяемых сертификатов. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Используется версия 2 API DigitalOcean.
Количество запросов, которые могут быть сделаны через API, в настоящее время ограничено 5000 в час на один токен OAuth.

Примеры

- 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

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Описание
data список / элементы=словарь	список записей домена 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)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/digitalocean/digital_ocean_domain_record_info_module.html