dnsimple - Взаимодействие с dnsimple.com (услугой хостинга DNS).

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

Обзор
- Требования
Параметры
Примеры
Статус
- Автор

Обзор

Управляет доменами и записями через API DNSimple, см. документацию: http://developer.dnsimple.com/

Требования

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

dnsimple

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
account_api_token	Значение по умолчанию: None	Токен API учетной записи. См. account_email для получения информации.
account_email	Значение по умолчанию: None	Электронная почта учетной записи. Если опущено, будут проверены переменные среды DNSIMPLE_EMAIL и DNSIMPLE_API_TOKEN. Если они не найдены, будет проверен файл `.dnsimple`, см.: https://github.com/mikemaccana/dnsimple-python#getting-started
domain	Значение по умолчанию: None	Домен для работы. Может быть именем домена (например, "mydomain.com") или числовым идентификатором домена в DNSimple. Если опущено, будет возвращен список доменов. Если domain присутствует, но домен не существует, он будет создан.
priority	Значение по умолчанию: None	Приоритет записи
record	Значение по умолчанию: None	Запись для добавления, если пусто, будет создана запись для домена, поддерживает символ подстановки (*)
record_ids	Значение по умолчанию: None	Список записей, чтобы убедиться, что они существуют или не существуют
solo	Значение по умолчанию: None	Указывает, должна ли запись быть единственной для данного типа и имени записи. Используйте только со state=present для записи
state	Варианты: present absent Значение по умолчанию: None	Указывает, должна ли запись существовать или нет
ttl	Значение по умолчанию: 3600 (один час)	TTL для новой записи
type	Варианты: A ALIAS CNAME MX SPF URL TXT NS SRV NAPTR PTR AAAA SSHFP HINFO POOL Значение по умолчанию: None	Тип DNS-записи для создания
value	Значение по умолчанию: None	Значение записи Должно быть указано, когда требуется убедиться в существовании записи

Примеры

# 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

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимости.

Автор

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.5/modules/dnsimple_module.html