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

Примечание

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

Для его установки используйте: 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/dnsimple_module.html