dnsimple - Взаимодействие с dnsimple.com (сервис хостинга DNS).
Новая версия 1.6.
Обзор
- Управляет доменными именами и записями через API DNSimple, см. документацию: http://developer.dnsimple.com/
Требования (к хосту, на котором выполняется модуль)
- dnsimple
Параметры
| параметр | обязателен | по умолчанию | выбор | комментарии |
|---|---|---|---|---|
| account_api_token | нет | Токен API учетной записи. См. account_email для получения информации. | ||
| account_email | нет | Электронная почта учетной записи. Если опущено, будут проверены переменные окружения DNSIMPLE_EMAIL и DNSIMPLE_API_TOKEN. Если они не найдены, будет проверен файл .dnsimple, см.: https://github.com/mikemaccana/dnsimple-python#getting-started | ||
| domain | нет | Домен, с которым работать. Может быть именем домена (например, "mydomain.com") или числовым идентификатором домена в DNSimple. Если опущено, будет возвращен список доменов. Если domain присутствует, но домен не существует, он будет создан. | ||
| priority | нет | Приоритет записи | ||
| record | нет | Запись для добавления, если пусто, будет создана запись для домена, поддерживает подстановку (*) | ||
| record_ids | нет | Список записей, для которых необходимо убедиться, что они либо существуют, либо не существуют | ||
| solo | нет | Является ли запись единственной для данного типа и имени записи. Используйте только со значением state=present для записи | ||
| state | нет |
| должна ли запись существовать или нет | |
| ttl | нет | 3600 (один час) | TTL для новой записи | |
| type | нет |
| Тип DNS-записи для создания | |
| value | нет | Значение записи Должно быть указано при попытке убедиться, что запись существует |
Примеры
# authenticate using email and API token and fetch all domains
- dnsimple:
account_email: test@example.com
account_api_token: dummyapitoken
delegate_to: localhost
# fetch my.com domain records
- dnsimple:
domain: my.com
state: present
delegate_to: localhost
register: records
# delete a domain
- dnsimple:
domain: my.com
state: absent
delegate_to: localhost
# create a test.my.com A record to point to 127.0.0.01
- dnsimple:
domain: my.com
record: test
type: A
value: 127.0.0.1
delegate_to: localhost
register: record
# and then delete it
- dnsimple:
domain: my.com
record_ids: '{{ record["id"] }}'
delegate_to: localhost
# create a my.com CNAME record to example.com
- dnsimple:
domain: my.com
record: ''
type: CNAME
value: example.com
state: present
delegate_to: localhost
# change it's ttl
- dnsimple:
domain: my.com
record: ''
type: CNAME
value: example.com
ttl: 600
state: present
delegate_to: localhost
# and delete the record
- dnsimple:
domain: my.com
record: ''
type: CNAME
value: example.com
state: absent
delegate_to: localhost
Статус
Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратной совместимости интерфейса.
Для получения помощи в разработке модулей, если вы этого желаете, прочитайте Информацию о сообществе и участие, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/dnsimple_module.html