community.general.dnsimple – Интерфейс с dnsimple.com (услуга хостинга DNS)

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в книге задач укажите: community.general.dnsimple.

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

Обзор

Управляет доменами и записями через 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 строка	Варианты: присутствует ← отсутствует	Указывает, должна ли запись существовать.
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
  community.general.dnsimple:
    account_email: test@example.com
    account_api_token: dummyapitoken
  delegate_to: localhost

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

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

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

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

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

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

- name: Delete the record
  community.general.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.10/collections/community/general/dnsimple_module.html