Модуль vultr.cloud.dns_domain — Управление DNS-доменами на Vultr

Примечание

Этот модуль является частью коллекции vultr.cloud (версия 1.13.0).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install vultr.cloud.

Чтобы использовать её в плейбуке, укажите: vultr.cloud.dns_domain.

Новое в vultr.cloud 1.0.0

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

Обзор

Создание и удаление DNS-доменов.

Параметры

Параметр	Комментарии
api_endpoint строка	URL конечной точки API (без конечной косой черты). Значение по умолчанию из переменной окружения `VULTR_API_ENDPOINT`. По умолчанию: `"https://api.vultr.com/v2"`
api_key строка / обязательно	Ключ API для Vultr API. Значение по умолчанию из переменной окружения `VULTR_API_KEY`.
api_retries целое число	Количество попыток при ошибках Vultr API, таких как - 429 Слишком много запросов - 500 Внутренняя ошибка сервера - 504 Время ожидания шлюза истекло Значение по умолчанию из переменной окружения `VULTR_API_RETRIES`. По умолчанию: `5`
api_retry_max_delay целое число	Максимальная задержка повторных попыток в секундах (экспоненциально возрастающая). Значение по умолчанию из переменной окружения `VULTR_API_RETRY_MAX_DELAY`. По умолчанию: `12`
api_timeout целое число	Таймаут HTTP-запросов к Vultr API. Значение по умолчанию из переменной окружения `VULTR_API_TIMEOUT`. По умолчанию: `180`
dns_sec строка	Включить или выключить DNSSEC. Варианты: `"enabled"` `"disabled"` ← (по умолчанию)
domain псевдонимы: name строка / обязательно	Имя домена.
ip псевдонимы: server_ip строка	IP адрес сервера по умолчанию. Используйте vultr.cloud.dns_record, чтобы изменить его после создания домена. Обязательно укажите, если `state=present`.
state строка	Состояние DNS-домена. Варианты: `"present"` ← (по умолчанию) `"absent"`
validate_certs булево	Проверять SSL-сертификаты Vultr API. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Также см. документацию API по адресу https://www.vultr.com/api/.

Примеры

- name: Ensure a domain exists with DNSSEC
  vultr.cloud.dns_domain:
    name: example.com
    dns_sec: enabled
    server_ip: 10.10.10.10

- name: Ensure a domain is absent
  vultr.cloud.dns_domain:
    name: example.com
    state: absent

END_OF_DOCUMENT_MARKER

Значения возврата

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

Ключ	Описание
vultr_api словарь	Ответ от API Vultr с некоторыми добавленными/изменёнными элементами. Возвращаемое значение: успех
api_endpoint строка	Точка доступа, используемая для запросов API. Возвращаемое значение: успех Пример: `"https://api.vultr.com/v2"`
api_retries целое число	Максимальное количество попыток повторных запросов к API. Возвращаемое значение: успех Пример: `5`
api_retry_max_delay целое число	Задержка экспоненциального возврата в секундах между повторными попытками до достижения максимального значения задержки. Возвращаемое значение: успех Пример: `12`
api_timeout целое число	Таймаут, используемый для запросов API. Возвращаемое значение: успех Пример: `60`
vultr_dns_domain словарь	Ответ от API Vultr. Возвращаемое значение: успех
date_created строка	Дата создания доменного имени DNS. Возвращаемое значение: успех Пример: `"2020-10-10T01:56:20+00:00"`
dns_sec строка	Включен или отключён DNSSEC. Возвращаемое значение: успех Пример: `"disabled"`
name строка	Имя доменного имени DNS. Возвращаемое значение: успех Пример: `"example.com"`

Авторы

René Moser (@resmo)

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

© 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/vultr/cloud/dns_domain_module.html