ansible / ansible.builtin / v2.9.27 / module / dnsimple Interface with dnsimple.com (a DNS hosting service) | "added in version" 1.6 of ansible.builtin" Authors: Alex Coomans (@drcapulet) preview | supported by communityansible.builtin.dnsimple (v2.9.27) — module
pip
Install with pip install ansible==2.9.27
Manages domains and records via the DNSimple API, see the docs: U(http://developer.dnsimple.com/).
- name: Authenticate using email and API token and fetch all domains dnsimple: account_email: test@example.com account_api_token: dummyapitoken delegate_to: localhost
- name: Fetch my.com domain records dnsimple: domain: my.com state: present delegate_to: localhost register: records
- name: Delete a domain dnsimple: domain: my.com state: absent delegate_to: localhost
- name: Create a test.my.com A record to point to 127.0.0.1 dnsimple: domain: my.com record: test type: A value: 127.0.0.1 delegate_to: localhost register: record
- name: Delete record using record_ids dnsimple: domain: my.com record_ids: '{{ record["id"] }}' state: absent delegate_to: localhost
- name: Create a my.com CNAME record to example.com dnsimple: domain: my.com record: '' type: CNAME value: example.com state: present delegate_to: localhost
- name: change TTL value for a record dnsimple: domain: my.com record: '' type: CNAME value: example.com ttl: 600 state: present delegate_to: localhost
- name: Delete the record dnsimple: domain: my.com record: '' type: CNAME value: example.com state: absent delegate_to: localhost
ttl: default: 3600 description: - The TTL to give the new record in seconds. type: int solo: default: false description: - Whether the record should be the only one for that record type and record name. - Only use with C(state) is set to C(present) on a record. type: bool type: choices: - A - ALIAS - CNAME - MX - SPF - URL - TXT - NS - SRV - NAPTR - PTR - AAAA - SSHFP - HINFO - POOL description: - The type of DNS record to create. type: str state: choices: - present - absent default: present description: - whether the record should exist or not. type: str value: description: - Record value. - Must be specified when trying to ensure a record exists. type: str domain: description: - Domain to work with. Can be the domain name (e.g. "mydomain.com") or the numeric ID of the domain in DNSimple. - If omitted, a list of domains will be returned. - If domain is present but the domain doesn't exist, it will be created. type: str record: description: - Record to add, if blank a record for the domain will be created, supports the wildcard (*). type: str priority: description: - Record priority. type: int record_ids: description: - List of records to ensure they either exist or do not exist. type: list account_email: description: - Account email. If omitted, the environment variables C(DNSIMPLE_EMAIL) and C(DNSIMPLE_API_TOKEN) will be looked for. - 'If those aren''t found, a C(.dnsimple) file will be looked for, see: U(https://github.com/mikemaccana/dnsimple-python#getting-started).' type: str account_api_token: description: - Account API token. See I(account_email) for more information. type: str