Spec-Zone.ru › Ansible 2.9

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_retry_max_delay
целое число
добавлено в 2.9
Задержка повторных попыток в секундах экспоненциально возрастает до этого максимального значения.
Переменная среды VULTR_API_RETRY_MAX_DELAY используется по умолчанию, если определена.
Значение по умолчанию — 12 секунд.
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
сложный
успех
Ответ от API Vultr с несколькими дополнениями/изменениями

api_account
строка
успех
Аккаунт, используемый в файле ini для выбора ключа

Пример:
default
api_endpoint
строка
успех
Конечная точка, используемая для запросов API

Пример:
https://api.vultr.com
api_retries
целое число
успех
Максимальное количество попыток повтора для запросов API

Пример:
5
api_retry_max_delay
целое число
добавлено в 2.9
успех
Задержка экспоненциального отката в секундах между повторами запросов до этого максимального значения задержки.

Пример:
12
api_timeout
целое число
успех
Тайм-аут, используемый для запросов API

Пример:
60
vultr_dns_record
сложный
успех
Ответ от API Vultr

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. [community]

Авторы

  • 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.9/modules/vultr_dns_record_module.html

Spec-Zone.ru

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