Spec-Zone.ru › Ansible 2.4

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

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

  • Обзор
  • Требования (к хосту, на котором выполняется модуль)
  • Параметры
  • Примеры
    • Статус

Обзор

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

Требования (к хосту, на котором выполняется модуль)

  • dnsimple

Параметры

параметр обязателен по умолчанию выбор комментарии
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. Если опущено, будет возвращен список доменов.
Если domain присутствует, но домен не существует, он будет создан.
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
нет
Значение записи
Должно быть указано при попытке убедиться, что запись существует

Примеры

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

# fetch my.com domain records
- dnsimple:
    domain: my.com
    state: present
  delegate_to: localhost
  register: records

# delete a domain
- dnsimple:
    domain: my.com
    state: absent
  delegate_to: localhost

# create a test.my.com A record to point to 127.0.0.01
- dnsimple:
    domain: my.com
    record: test
    type: A
    value: 127.0.0.1
  delegate_to: localhost
  register: record

# and then delete it
- dnsimple:
    domain: my.com
    record_ids: '{{ record["id"] }}'
  delegate_to: localhost

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

# change it's ttl
- dnsimple:
    domain: my.com
    record: ''
    type: CNAME
    value: example.com
    ttl: 600
    state: present
  delegate_to: localhost

# and delete the record
- dnsimple:
    domain: my.com
    record: ''
    type: CNAME
    value: example.com
    state: absent
  delegate_to: localhost

Статус

Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратной совместимости интерфейса.

Для получения помощи в разработке модулей, если вы этого желаете, прочитайте Информацию о сообществе и участие, Тестирование Ansible и Разработка модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/dnsimple_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API