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

Примечание

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

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

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

Для использования в playbook, укажите: 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 / required	API ключ Vultr API. Резервная переменная окружения `VULTR_API_KEY`.
api_retries integer	Количество попыток в случае, если Vultr API возвращает код ошибки 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 для Vultr API. Резервная переменная окружения `VULTR_API_TIMEOUT`. По умолчанию: `180`
data string	Данные записи. Обязательно, если `state=present`.
domain string / required	Домен, к которому относится запись.
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 aliases: record_type string	Тип записи. Варианты: `"A"` ← (по умолчанию) `"AAAA"` `"CNAME"` `"NS"` `"MX"` `"SRV"` `"TXT"` `"CAA"` `"SSHFP"`
validate_certs boolean	Проверять ли SSL-сертификаты Vultr API. Варианты: `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 словарь	Ответ от API Vultr. Возвращено: успешно
data строка	Данные DNS-записи. Возвращено: успешно Пример: `"10.10.10.10"`
id строка	Идентификатор DNS-записи. Возвращено: успешно Пример: `"cb676a46-66fd-4dfb-b839-443f2e6c0b60"`
name строка	Имя DNS-записи. Возвращено: успешно Пример: `"web"`
priority целое число	Приоритет DNS-записи. Возвращено: успешно Пример: `10`
ttl целое число	Время жизни DNS-записи. Возвращено: успешно Пример: `300`
type строка	Имя DNS-записи. Возвращено: успешно Пример: `"A"`
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`

Авторы

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_record_module.html