Spec-Zone.ru › Ansible 2.6

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
    Варианты:
  • A ←
  • AAAA
  • CNAME
  • MX
  • SRV
  • ALIAS
  • SPF
  • TXT
  • NS
Тип записи.

Псевдонимы: тип
state
    Варианты:
  • present ←
  • absent
Состояние записи 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API