community.general.gandi_livedns module – Manage Gandi LiveDNS records

Note

This module is part of the community.general collection (version 6.6.9).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.gandi_livedns.

New in community.general 2.3.0

Synopsis

Parameters

Parameter

Comments

api_key

string / required

Account API token.

domain

string / required

The name of the Domain to work with (for example, “example.com”).

record

string / required

Record to add.

state

string

Whether the record(s) should exist or not.

Choices:

  • "absent"

  • "present" ← (default)

ttl

integer

The TTL to give the new record.

Required when state=present.

type

string / required

The type of DNS record to create.

values

list / elements=string

The record values.

Required when state=present.

Attributes

Attribute

Support

Description

check_mode

Support: full

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: none

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Examples

- 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
    api_key: dummyapitoken
  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
    api_key: dummyapitoken
    state: present

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

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

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

record

dictionary

A dictionary containing the record data.

Returned: success, except on record deletion

domain

string

The domain associated with the record.

Returned: success

Sample: "my.com"

record

string

The record name.

Returned: success

Sample: "www"

ttl

integer

The time-to-live for the record.

Returned: success

Sample: 300

type

string

The record type.

Returned: success

Sample: "A"

values

list / elements=string

The record content (details depend on record type).

Returned: success

Sample: ["192.0.2.91", "192.0.2.92"]

Authors

  • Gregory Thiemonge (@gthiemonge)