Модуль 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. Для использования этого модуля требуются дополнительные требования, см. Требования для получения подробностей.

Для использования в книге задач укажите: community.digitalocean.digital_ocean_domain_info.

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

Описание

Этот модуль можно использовать для сбора информации о доменных именах, предоставленных DigitalOcean.
Этот модуль назывался digital_ocean_domain_facts до Ansible 2.9. Способ использования не изменился.

Псевдонимы: digital_ocean_domain_facts

Требования

Ниже приведены требования к хосту, на котором выполняется этот модуль.

python >= 2.6

Параметры

Параметр	Комментарии
baseurl строка	Базовый URL API DigitalOcean. По умолчанию: `"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 целое число	Время ожидания в секундах, используемое для опроса API DigitalOcean. По умолчанию: `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 Возвращается: success Пример: `[{"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"}]`

Ключ

Описание

data

список / элементы=словарь

Информация о домене DigitalOcean

Возвращается: success

Пример: [{"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)

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

© 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_info_module.html