dnsmadeeasy – Взаимодействие с dnsmadeeasy.com (сервис хостинга DNS).
Новое в версии 1.3.
Краткое описание
- Управляет записями DNS через REST API v2 сервиса DNS Made Easy. Обрабатывает только записи; пока нет возможности управления доменами или поддержки мониторинга/учета. Смотрите: https://www.dnsmadeeasy.com/integration/restapi/
Требования
Ниже указаны требования к хосту, на котором выполняется этот модуль.
- hashlib
- hmac
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| account_key - / обязательно | Ключ API учетной записи. | |
| account_secret - / обязательно | Секретный ключ учетной записи. | |
| autoFailover логическое добавлено в 2.4 |
| Если true, возврат к основному IP-адресу осуществляется вручную после переключения. Если false, возврат к основному IP-адресу происходит автоматически после переключения. |
| contactList - / обязательно добавлено в 2.4 | Значение по умолчанию: "" | Имя или ID списка контактов, которым будет отправлено уведомление монитора. Значение по умолчанию '' означает владельца учетной записи. |
| domain - / обязательно | Домен для работы. Может быть именем домена (например, "mydomain.com") или числовым ID домена в DNS Made Easy (например, "839989") для более быстрого разрешения | |
| failover логическое добавлено в 2.4 |
| Если yes, добавить или изменить переключение. Это применимо только для записей A. |
| httpFile - добавлено в 2.4 | Файл по Fqdn, который монитор запрашивает для HTTP или HTTPS. | |
| httpFqdn - добавлено в 2.4 | Полностью квалифицированное доменное имя, используемое монитором. | |
| httpQueryString - добавлено в 2.4 | Строка в httpFile, которую монитор запрашивает для HTTP или HTTPS. | |
| ip1 - добавлено в 2.4 | Основной IP-адрес для переключения. Обязательно, если добавляется или изменяется монитор или переключение. | |
| ip2 - добавлено в 2.4 | Вторичный IP-адрес для переключения. Обязательно, если добавляется или изменяется переключение. | |
| ip3 - добавлено в 2.4 | Третичный IP-адрес для переключения. | |
| ip4 - добавлено в 2.4 | Четвертичный IP-адрес для переключения. | |
| ip5 - добавлено в 2.4 | Пятеричный IP-адрес для переключения. | |
| maxEmails - / обязательно добавлено в 2.4 | Значение по умолчанию: 1 | Количество писем, отправляемых монитором в список контактов. |
| monitor логическое добавлено в 2.4 |
| Если yes, добавить или изменить монитор. Это применимо только для записей A. |
| port - / обязательно добавлено в 2.4 | Значение по умолчанию: 80 | Порт, используемый монитором. |
| protocol - / обязательно добавлено в 2.4 |
| Протокол, используемый монитором. |
| record_name - | Имя записи для получения/создания/удаления/обновления. Если record_name не указан; все записи для домена будут возвращены в "result" независимо от аргумента state. | |
| record_ttl - | Значение по умолчанию: 1800 | "Время жизни" записи. Количество секунд, в течение которых запись остается кэшированной на DNS-серверах. |
| record_type - |
| Тип записи. |
| record_value - | Значение записи. HTTPRED: <URL перенаправления>, MX: <приоритет> <целевое имя>, NS: <имя сервера>, PTR: <целевое имя>, SRV: <приоритет> <вес> <порт> <целевое имя>, TXT: <текстовое значение>" Если record_value не указан; никаких изменений не будет внесено, и запись будет возвращена в 'result' (другими словами, этот модуль может использоваться для получения текущего id, типа и ttl записи) | |
| sandbox логическое добавлено в 2.7 |
| Определяет, следует ли использовать API песочницы. В противном случае (по умолчанию) используется производственный API DNS Made Easy. |
| sensitivity - / обязательно добавлено в 2.4 |
| Количество проверок, выполняемых монитором перед переключением, где Низкая = 8, Средняя = 5 и Высокая = 3. |
| state - / обязательно |
| должна ли запись существовать или нет |
| systemDescription - / обязательно добавлено в 2.4 | Значение по умолчанию: "" | Описание, используемое монитором. |
| validate_certs логическое добавлено в 1.5.1 |
| Если no, сертификаты SSL проверяться не будут. Это следует использовать только на лично контролируемых сайтах, использующих самоподписанные сертификаты. |
Примечания
Примечание
- Услуга DNS Made Easy требует, чтобы машины, взаимодействующие с API, имели правильно установленные время и часовой пояс. Убедитесь, что вы находитесь в пределах нескольких секунд от реального времени, используя NTP.
- Этот модуль возвращает запись(и) и монитор(ы) в элементе «result», когда «state» установлено в «present». Эти значения можно регистрировать и использовать в ваших плейбуках.
- Только записи типа A могут иметь монитор или резервирование.
- Для добавления резервирования требуются опции «failover», «autoFailover», «port», «protocol», «ip1» и «ip2».
- Для добавления монитора требуются опции «monitor», «port», «protocol», «maxEmails», «systemDescription» и «ip1».
- Монитор и резервирование будут использовать общие опции «port», «protocol» и «ip1».
Примеры
# fetch my.com domain records
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
register: response
# create / ensure the presence of a record
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_type: A
record_value: 127.0.0.1
# update the previously created record
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_value: 192.0.2.23
# fetch a specific record
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
register: response
# delete a record / ensure it is absent
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
record_type: A
state: absent
record_name: test
# Add a failover
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_type: A
record_value: 127.0.0.1
failover: True
ip1: 127.0.0.2
ip2: 127.0.0.3
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_type: A
record_value: 127.0.0.1
failover: True
ip1: 127.0.0.2
ip2: 127.0.0.3
ip3: 127.0.0.4
ip4: 127.0.0.5
ip5: 127.0.0.6
# Add a monitor
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_type: A
record_value: 127.0.0.1
monitor: yes
ip1: 127.0.0.2
protocol: HTTP # default
port: 80 # default
maxEmails: 1
systemDescription: Monitor Test A record
contactList: my contact list
# Add a monitor with http options
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_type: A
record_value: 127.0.0.1
monitor: yes
ip1: 127.0.0.2
protocol: HTTP # default
port: 80 # default
maxEmails: 1
systemDescription: Monitor Test A record
contactList: 1174 # contact list id
httpFqdn: http://my.com
httpFile: example
httpQueryString: some string
# Add a monitor and a failover
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_type: A
record_value: 127.0.0.1
failover: True
ip1: 127.0.0.2
ip2: 127.0.0.3
monitor: yes
protocol: HTTPS
port: 443
maxEmails: 1
systemDescription: monitoring my.com status
contactList: emergencycontacts
# Remove a failover
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_type: A
record_value: 127.0.0.1
failover: no
# Remove a monitor
- dnsmadeeasy:
account_key: key
account_secret: secret
domain: my.com
state: present
record_name: test
record_type: A
record_value: 127.0.0.1
monitor: no
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Brice Burgess (@briceburg)
Подсказка
Если вы заметили какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/dnsmadeeasy_module.html