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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/gandi_livedns_module.html