Модуль vultr.cloud.dns_record — управление DNS-записями в Vultr

Примечание

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

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

Для установки используйте: ansible-galaxy collection install vultr.cloud.

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

Добавлено в vultr.cloud 1.0.0

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Создание, обновление и удаление DNS-записей.

Параметры

Параметр	Комментарии
api_endpoint string	URL конечной точки API (без завершающей косой черты). Резервная переменная окружения `VULTR_API_ENDPOINT`. По умолчанию: `"https://api.vultr.com/v2"`
api_key string / обязательный	Ключ API Vultr. Резервная переменная окружения `VULTR_API_KEY`.
api_results_per_page integer добавлено в vultr.cloud 1.14.0	При получении большого количества ресурсов укажите, сколько результатов должно возвращаться за один вызов API. Это значение не определяет общее количество возвращаемых результатов: возвращаются все ресурсы, соответствующие другим фильтрам. Максимальное значение для API Vultr — 500. Резервная переменная окружения `VULTR_API_RESULTS_PER_PAGE`. По умолчанию: `100`
api_retries integer	Количество повторных попыток в случае, если API Vultr возвращает код ошибки HTTP, например: 429 Too Many Requests (слишком много запросов), 500 Internal Server Error (внутренняя ошибка сервера), 504 Gateway Time-out (истекло время ожидания шлюза). Резервная переменная окружения `VULTR_API_RETRIES`. По умолчанию: `5`
api_retry_max_delay integer	Экспоненциальная задержка между повторными попытками (в секундах) увеличивается до этого максимального значения. Резервная переменная окружения `VULTR_API_RETRY_MAX_DELAY`. По умолчанию: `12`
api_timeout integer	Тайм-аут HTTP-запросов к API Vultr. Резервная переменная окружения `VULTR_API_TIMEOUT`. По умолчанию: `180`
data string	Данные записи. Обязательно, если `state=present`.
domain string / обязательный	Домен, к которому относится запись.
multiple boolean	Использовать ли несколько записей с одинаковыми name (в том числе без имени) и type. Допускается только для некоторых типов записей, например `type=A`, `type=NS` или `type=MX`. Значение data не будет обновляться; оно используется как ключ для поиска существующих записей. Варианты: `false` ← (по умолчанию) `true`
name string	Имя записи. По умолчанию: `""`
priority integer	Приоритет записи.
state string	Состояние DNS-записи. Варианты: `"present"` ← (по умолчанию) `"absent"`
ttl integer	TTL записи. По умолчанию: `300`
type псевдонимы: record_type string	Тип записи. Варианты: `"A"` ← (по умолчанию) `"AAAA"` `"CNAME"` `"NS"` `"MX"` `"SRV"` `"TXT"` `"CAA"` `"SSHFP"`
validate_certs boolean	Проверять SSL-сертификаты API Vultr. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Ensure an A record exists
  vultr.cloud.dns_record:
    name: www
    domain: example.com
    data: 10.10.10.10
    ttl: 3600

- name: Ensure a second A record exists for round robin LB
  vultr.cloud.dns_record:
    name: www
    domain: example.com
    data: 10.10.10.11
    ttl: 60
    multiple: true

- name: Ensure a CNAME record exists
  vultr.cloud.dns_record:
    name: web
    type: CNAME
    domain: example.com
    data: www.example.com

- name: Ensure MX record exists
  vultr.cloud.dns_record:
    type: MX
    domain: example.com
    data: "{{ item.data }}"
    priority: "{{ item.priority }}"
    multiple: true
  with_items:
    - { data: mx1.example.com, priority: 10 }
    - { data: mx2.example.com, priority: 10 }
    - { data: mx3.example.com, priority: 20 }

- name: Ensure a record is absent
  vultr.cloud.dns_record:
    name: www
    domain: example.com
    state: absent

- name: Ensure one MX record is absent if multiple exists
  vultr.cloud.dns_record:
    record_type: MX
    domain: example.com
    data: mx1.example.com
    multiple: true
    state: absent

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

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

Ключ	Описание
dns_record dictionary	Ответ API Vultr. Возвращается: при успехе
data string	Данные DNS-записи. Возвращается: при успехе Пример: `"10.10.10.10"`
id string	Идентификатор DNS-записи. Возвращается: при успехе Пример: `"cb676a46-66fd-4dfb-b839-443f2e6c0b60"`
name string	Имя DNS-записи. Возвращается: при успехе Пример: `"web"`
priority integer	Приоритет DNS-записи. Возвращается: при успехе Пример: `10`
ttl integer	Время жизни DNS-записи. Возвращается: при успехе Пример: `300`
type string	Тип DNS-записи. Возвращается: при успехе Пример: `"A"`
vultr_api dictionary	Ответ API Vultr с некоторыми дополнениями и изменениями. Возвращается: при успехе
api_endpoint string	Конечная точка, используемая для запросов API. Возвращается: при успехе Пример: `"https://api.vultr.com/v2"`
api_results_per_page integer	Количество результатов, возвращаемых за один вызов API. Возвращается: при успехе Пример: `100`
api_retries integer	Максимальное количество повторных попыток для запросов API. Возвращается: при успехе Пример: `5`
api_retry_max_delay integer	Максимальная экспоненциальная задержка в секундах между повторными попытками. Возвращается: при успехе Пример: `12`
api_timeout integer	Тайм-аут, используемый для запросов API. Возвращается: при успехе Пример: `60`

Авторы

René Moser (@resmo)

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

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/vultr/cloud/dns_record_module.html