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. Если опущено, будет возвращен список доменов. Если домен указан, но домен не существует, он будет создан. | |
| 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. См. Поддержка и обслуживание модулей для получения дополнительной информации.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- Alex Coomans (@drcapulet)
Подсказка
Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/dnsimple_module.html