Модуль community.general.gandi_livedns — Управление записями Gandi LiveDNS

Примечание

Этот модуль входит в коллекцию community.general (версия 9.5.0).

Вы, возможно, уже установили эту коллекцию, если используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в книге задач, укажите: community.general.gandi_livedns.

Добавлена в community.general 2.3.0

Обзор
Параметры
Атрибуты
Примеры
Возвращаемые значения

Обзор

Управляет записями DNS с помощью API Gandi LiveDNS, см. документацию: https://doc.livedns.gandi.net/.

Параметры

Параметр	Комментарии
api_key строка	Токен API учётной записи. Обратите внимание, что такие ключи устарели и могут перестать работать в какой-то момент. Используйте вместо них токены персонального доступа. Один из `personal_access_token` и `api_key` должен быть указан.
domain строка / обязательный	Имя домена для работы (например, “example.com”).
personal_access_token строка добавлено в community.general 9.0.0	Токен API с ограниченным доступом. Один из `personal_access_token` и `api_key` должен быть указан.
record строка / обязательный	Запись для добавления.
state строка	Нужно ли создать запись(и) или нет. Варианты: `"absent"` `"present"` ← (по умолчанию)
ttl целое число	Время жизни (TTL) новой записи. Требуется, когда `state=present`.
type строка / обязательный	Тип записи DNS для создания.
values список / элементы=строка	Значения записи. Требуется, когда `state=present`.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в `check_mode` и возвращать прогноз изменения статуса без изменения целевого объекта.
diff_mode	Поддержка: отсутствует	Возвратит детали изменений (или, возможно, необходимых изменений в `check_mode`), когда режим diff включен.

Примеры

- name: Create a test A record to point to 127.0.0.1 in the my.com domain
  community.general.gandi_livedns:
    domain: my.com
    record: test
    type: A
    values:
    - 127.0.0.1
    ttl: 7200
    personal_access_token: dummytoken
  register: record

- name: Create a mail CNAME record to www.my.com domain
  community.general.gandi_livedns:
    domain: my.com
    type: CNAME
    record: mail
    values:
    - www
    ttl: 7200
    personal_access_token: dummytoken
    state: present

- name: Change its TTL
  community.general.gandi_livedns:
    domain: my.com
    type: CNAME
    record: mail
    values:
    - www
    ttl: 10800
    personal_access_token: dummytoken
    state: present

- name: Delete the record
  community.general.gandi_livedns:
    domain: my.com
    type: CNAME
    record: mail
    personal_access_token: dummytoken
    state: absent

- name: Use a (deprecated) API Key
  community.general.gandi_livedns:
    domain: my.com
    record: test
    type: A
    values:
    - 127.0.0.1
    ttl: 7200
    api_key: dummyapikey

Значения возврата

Общие значения возврата документированы здесь, следующие — поля, уникальные для этого модуля:

Ключ	Описание
record словарь	Словарь, содержащий данные записи. Возвращается: успешно, за исключением удаления записи
domain строка	Домен, связанный с записью. Возвращается: успешно Пример: `"my.com"`
record строка	Имя записи. Возвращается: успешно Пример: `"www"`
ttl целое число	Время жизни записи. Возвращается: успешно Пример: `300`
type строка	Тип записи. Возвращается: успешно Пример: `"A"`
values список / элементы=строка	Содержимое записи (подробности зависят от типа записи). Возвращается: успешно Пример: `["192.0.2.91", "192.0.2.92"]`

Авторы

Gregory Thiemonge (@gthiemonge)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/gandi_livedns_module.html