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

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

Описание

Управляет доменными именами и записями через 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. [сообщество]

Авторы

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