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 логическое	Варианты: нет ← да	Указывает, должна ли запись быть единственной для данного типа и имени записи. Используйте только если `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.9/modules/dnsimple_module.html