vr_dns_record - Управляет записями DNS на Vultr.
Новое в версии 2.5.
Обзор
- Создание, обновление и удаление записей DNS.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_account | Значение по умолчанию: "default" | Имя раздела ini в файле vultr.ini. Переменная среды VULTR_API_ACCOUNT используется в качестве значения по умолчанию, если определена. |
| api_endpoint | Значение по умолчанию: "https://api.vultr.com" | URL конечной точки API (без конечной косой черты). Переменная среды VULTR_API_ENDPOINT используется в качестве значения по умолчанию, если определена. |
| api_key | Ключ API Vultr API. Переменная среды VULTR_API_KEY используется в качестве значения по умолчанию, если определена. | |
| api_retries | Значение по умолчанию: 5 | Количество попыток при получении кода HTTP 503 от Vultr API. Переменная среды VULTR_API_RETRIES используется в качестве значения по умолчанию, если определена. |
| api_timeout | Значение по умолчанию: 60 | Таймаут HTTP-соединения с Vultr API. Переменная среды VULTR_API_TIMEOUT используется в качестве значения по умолчанию, если определена. |
| data | Данные записи. Требуется, если state=present или multiple=yes. | |
| domain обязательно | Домен, к которому относится запись. | |
| multiple bool |
| Использовать более одной записи с аналогичными name, включая имя и record_type. Допускается только для некоторых типов записей, например, record_type=A, record_type=NS или record_type=MX. data не будет обновляться, вместо этого используется в качестве ключа для поиска существующих записей. |
| name | Значение по умолчанию: "" | Имя записи (подзапись). Псевдонимы: подзапись |
| priority | Значение по умолчанию: 0 | Приоритет записи. |
| record_type |
| Тип записи. Псевдонимы: тип |
| state |
| Состояние записи DNS. |
| ttl | Значение по умолчанию: 300 | TTL записи. |
| validate_certs bool |
| Проверка SSL-сертификатов Vultr API. |
Примечания
Примечание
- См. также документацию API по адресу https://www.vultr.com/api/.
Примеры
- name: Ensure an A record exists
vr_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
vr_dns_record:
name: www
domain: example.com
data: 10.10.10.11
ttl: 60
multiple: yes
- name: Ensure a CNAME record exists
vr_dns_record:
name: web
record_type: CNAME
domain: example.com
data: www.example.com
- name: Ensure MX record exists
vr_dns_record:
record_type: MX
domain: example.com
data: "{{ item.data }}"
priority: "{{ item.priority }}"
multiple: yes
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
local_action:
module: vr_dns_record
name: www
domain: example.com
state: absent
- name: Ensure MX record is absent in case multiple exists
vr_dns_record:
record_type: MX
domain: example.com
data: mx1.example.com
multiple: yes
state: absent
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| vultr_api сложный | успех | Ответ от Vultr API с несколькими дополнениями/изменениями | |
| api_account строка | успех | Аккаунт, используемый в файле ini для выбора ключа Пример: default | |
| api_timeout целое число | успех | Таймаут, используемый для запросов API Пример: 60 | |
| vultr_dns_record сложный | успех | Ответ от Vultr API | |
| id целое число | успех | ID записи DNS. Пример: 1265277 | |
| name строка | успех | Имя записи DNS. Пример: web | |
| record_type строка | успех | Имя записи DNS. Пример: web | |
| data строка | успех | Данные записи DNS. Пример: 10.10.10.10 | |
| domain строка | успех | Домен, к которому относится запись DNS. Пример: example.com | |
| priority целое число | успех | Приоритет записи DNS. Пример: 10 | |
| ttl целое число | успех | Время жизни записи DNS. Пример: 300 | |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратной совместимостью.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Подробнее см. Техническое обслуживание и поддержка модулей.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- René Moser (@resmo)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/vr_dns_record_module.html