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

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

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

Обзор

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

Требования

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

dnsimple >= 1.0.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
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 boolean	Варианты: no yes	Определяет, должна ли запись быть единственной для данного типа и имени записи. Используйте только когда `state` установлено в `present` для записи.
state -	Варианты: present absent	Указывает, должна ли запись существовать или нет.
ttl -	По умолчанию: 3600	Время жизни (TTL) новой записи в секундах.
type -	Варианты: A ALIAS CNAME MX SPF URL TXT NS SRV NAPTR PTR AAAA SSHFP HINFO POOL	Тип записи DNS для создания.
value -		Значение записи. Должно быть указано при попытке убедиться, что запись существует.

Примечания

Примечание

API DNSimple v1 устарел. Пожалуйста, установите dnsimple-python>=1.0.0, который использует API v2.

Примеры

- name: Authenticate using email and API token and fetch all domains
  dnsimple:
    account_email: test@example.com
    account_api_token: dummyapitoken
  delegate_to: localhost

- name: Fetch my.com domain records
  dnsimple:
    domain: my.com
    state: present
  delegate_to: localhost
  register: records

- name: Delete a domain
  dnsimple:
    domain: my.com
    state: absent
  delegate_to: localhost

- name: Create a test.my.com A record to point to 127.0.0.1
  dnsimple:
    domain: my.com
    record: test
    type: A
    value: 127.0.0.1
  delegate_to: localhost
  register: record

- name: Delete record using record_ids
  dnsimple:
    domain: my.com
    record_ids: '{{ record["id"] }}'
    state: absent
  delegate_to: localhost

- name: Create a my.com CNAME record to example.com
  dnsimple:
    domain: my.com
    record: ''
    type: CNAME
    value: example.com
    state: present
  delegate_to: localhost

- name: change TTL value for a record
  dnsimple:
    domain: my.com
    record: ''
    type: CNAME
    value: example.com
    ttl: 600
    state: present
  delegate_to: localhost

- name: Delete the record
  dnsimple:
    domain: my.com
    record: ''
    type: CNAME
    value: example.com
    state: absent
  delegate_to: localhost

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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