community.general.memset_dns_reload module – Request reload of Memset’s DNS infrastructure,

Note

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

You might already have this collection installed if you are using the ansible package. 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.memset_dns_reload.

Synopsis

  • Request a reload of Memset’s DNS infrastructure, and optionally poll until it finishes.

Parameters

Parameter

Comments

api_key

string / required

The API key obtained from the Memset control panel.

poll

boolean

Boolean value, if set will poll the reload job’s status and return when the job has completed (unless the 30 second timeout is reached first). If the timeout is reached then the task will not be marked as failed, but stderr will indicate that the polling failed.

Choices:

  • false ← (default)

  • true

Attributes

Attribute

Support

Description

check_mode

Support: none

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.

Notes

Note

  • DNS reload requests are a best-effort service provided by Memset; these generally happen every 15 minutes by default, however you can request an immediate reload if later tasks rely on the records being created. An API key generated via the Memset customer control panel is required with the following minimum scope - dns.reload. If you wish to poll the job status to wait until the reload has completed, then job.status is also required.

Examples

- name: Submit DNS reload and poll
  community.general.memset_dns_reload:
    api_key: 5eb86c9196ab03919abcf03857163741
    poll: true
  delegate_to: localhost

Return Values

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

Key

Description

memset_api

complex

Raw response from the Memset API.

Returned: always

error

boolean

Whether the job ended in error state.

Returned: always

Sample: true

finished

boolean

Whether the job completed before the result was returned.

Returned: always

Sample: true

id

string

Job ID.

Returned: always

Sample: "c9cc8ad2a3e3fb8c63ed83c424928ef8"

status

string

Job status.

Returned: always

Sample: "DONE"

type

string

Job type.

Returned: always

Sample: "dns"

Authors

  • Simon Weald (@glitchcrab)