Spec-Zone.ru › Ansible 2.8

vultr_dns_record – Управляет записями DNS на Vultr

Новая версия 2.5.

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Значения возврата
  • Статус

Обзор

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

Псевдонимы: vr_dns_record

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

  • 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_timeout
целое число
Таймаут HTTP для Vultr API.
Переменная среды VULTR_API_TIMEOUT используется в качестве значения по умолчанию, если она определена.
Значение по умолчанию — 60 секунд, если не указано.
data
-
Данные записи.
Обязательно, если требуется state=present или multiple=yes.
domain
- / обязательно
Домен, к которому относится запись.
multiple
булево
    Варианты:
  • нет ←
  • да
Использовать более одной записи с аналогичным name, включая отсутствие имени и record_type.
Допускается только для некоторых типов записей, например record_type=A, record_type=NS или record_type=MX.
data не будет обновлен, а вместо этого используется в качестве ключа для поиска существующих записей.
name
-
Значение по умолчанию:
""
Имя записи (подзапись).

Псевдонимы: подзапись
priority
-
Значение по умолчанию:
0
Приоритет записи.
record_type
-
    Варианты:
  • A ←
  • AAAA
  • CNAME
  • MX
  • SRV
  • CAA
  • TXT
  • NS
  • SSHFP
Тип записи.

Псевдонимы: тип
state
-
    Варианты:
  • present ←
  • absent
Состояние записи DNS.
ttl
-
Значение по умолчанию:
300
TTL записи.
validate_certs
булево
    Варианты:
  • нет
  • да ←
Проверять SSL-сертификаты Vultr API.

Примечания

Примечание

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

Примеры

- name: Ensure an A record exists
  vultr_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_dns_record:
    name: www
    domain: example.com
    data: 10.10.10.11
    ttl: 60
    multiple: yes

- name: Ensure a CNAME record exists
  vultr_dns_record:
    name: web
    record_type: CNAME
    domain: example.com
    data: www.example.com

- name: Ensure MX record exists
  vultr_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: vultr_dns_record
    name: www
    domain: example.com
    state: absent

- name: Ensure MX record is absent in case multiple exists
  vultr_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

data
строка
успех
Данные записи DNS.

Пример:
10.10.10.10
domain
строка
успех
Домен, к которому относится запись DNS.

Пример:
example.com
id
целое число
успех
Идентификатор записи DNS.

Пример:
1265277
name
строка
успех
Имя записи DNS.

Пример:
web
priority
целое число
успех
Приоритет записи DNS.

Пример:
10
record_type
строка
успех
Тип записи DNS.

Пример:
web
ttl
целое число
успех
Время жизни записи DNS.

Пример:
300


Статус

  • Этот модуль не гарантирует обратную совместимость. [превью]
  • Этот модуль поддерживается сообществом 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.8/modules/vultr_dns_record_module.html

Spec-Zone.ru

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