vultr_dns_domain_facts – Сбор фактов о доменных именах Vultr DNS
Новое в версии 2.7.
УСТАРЕЛО
| Удалено в Ansible: | |
|---|---|
| версия: 2.13 | |
| Почему: | Заменено на модуль _info. |
| Альтернатива: | Используйте vultr_dns_domain_info вместо этого. |
Описание
- Сбор фактов о доменных именах DNS, доступных в Vultr.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_account
строка
|
Значение по умолчанию: "default" |
Имя раздела ini в файле
vultr.ini. Переменная среды
VULTR_API_ACCOUNT используется как значение по умолчанию, если она определена. |
| api_endpoint
строка
|
URL конечной точки API (без заключительного слэша).
Переменная среды
VULTR_API_ENDPOINT используется как значение по умолчанию, если она определена.Если не указано, используется значение по умолчанию https://api.vultr.com.
|
|
| api_key
строка
|
Ключ API Vultr API.
Переменная среды
VULTR_API_KEY используется как значение по умолчанию, если она определена. |
|
| api_retries
целое число
|
Количество попыток при возврате Vultr API кода HTTP 503.
Переменная среды
VULTR_API_RETRIES используется как значение по умолчанию, если она определена.Значение по умолчанию – 5 попыток, если не указано другое.
|
|
| api_retry_max_delay
целое число
добавлен в 2.9 |
Задержка отката при повторных попытках в секундах, экспоненциально возрастает до этого максимального значения.
Переменная среды
VULTR_API_RETRY_MAX_DELAY используется как значение по умолчанию, если она определена.Значение по умолчанию – 12 секунд.
|
|
| api_timeout
целое число
|
Таймаут HTTP для Vultr API.
Переменная среды
VULTR_API_TIMEOUT используется как значение по умолчанию, если она определена.Значение по умолчанию – 60 секунд, если не указано другое.
|
|
| validate_certs
логический тип
|
|
Проверка SSL-сертификатов Vultr API. |
Примечания
Примечание
- Также см. документацию API по адресу https://www.vultr.com/api/.
Примеры
- name: Gather Vultr DNS domains facts
local_action:
module: vultr_dns_domains_facts
- name: Print the gathered facts
debug:
var: ansible_facts.vultr_dns_domain_facts
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращено | Описание | |
|---|---|---|---|
| vultr_api
сложный тип
|
успех |
Ответ от Vultr API с некоторыми дополнениями/изменениями
|
|
| api_account
строка
|
успех |
Аккаунт, использованный в файле ini для выбора ключа
Пример:
default
|
|
| api_endpoint
строка
|
успех |
Конечная точка, используемая для запросов API
Пример:
https://api.vultr.com
|
|
| api_retries
целое число
|
успех |
Максимальное количество попыток запросов API
Пример:
5
|
|
| api_retry_max_delay
целое число
добавлен в 2.9 |
успех |
Экспоненциальная задержка отката в секундах между повторными попытками до этого максимального значения.
Пример:
12
|
|
| api_timeout
целое число
|
успех |
Таймаут, используемый для запросов API
Пример:
60
|
|
| vultr_dns_domain_facts
сложный тип
|
успех |
Ответ от Vultr API
Пример:
{'vultr_dns_domain_facts': [{'date_created': '2018-07-19 07:14:21', 'domain': 'ansibletest.com'}]}
|
|
Статус
- Этот модуль будет удален в версии 2.13. [устарело]
- Дополнительную информацию см. в разделе УСТАРЕЛО.
Авторы
- Yanis Guenane (@Spredzy)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/vultr_dns_domain_facts_module.html
