ansible / ansible.builtin / v2.4.6.0-1 / 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.4.6.0-1) — module
pip
Install with pip install ansible==2.4.6.0.post1
Manages domains and records via the DNSimple API, see the docs: U(http://developer.dnsimple.com/)
# authenticate using email and API token and fetch all domains - dnsimple: account_email: test@example.com account_api_token: dummyapitoken delegate_to: localhost
# fetch my.com domain records - dnsimple: domain: my.com state: present delegate_to: localhost register: records
# delete a domain - dnsimple: domain: my.com state: absent delegate_to: localhost
# create a test.my.com A record to point to 127.0.0.01 - dnsimple: domain: my.com record: test type: A value: 127.0.0.1 delegate_to: localhost register: record
# and then delete it - dnsimple: domain: my.com record_ids: '{{ record["id"] }}' delegate_to: localhost
# create a my.com CNAME record to example.com - dnsimple: domain: my.com record: '' type: CNAME value: example.com state: present delegate_to: localhost
# change it's ttl - dnsimple: domain: my.com record: '' type: CNAME value: example.com ttl: 600 state: present delegate_to: localhost
# and delete the record - dnsimple: domain: my.com record: '' type: CNAME value: example.com state: absent delegate_to: localhost
ttl: default: 3600 (one hour) description: - The TTL to give the new record required: false solo: default: null description: - Whether the record should be the only one for that record type and record name. Only use with state=present on a record required: false type: choices: - A - ALIAS - CNAME - MX - SPF - URL - TXT - NS - SRV - NAPTR - PTR - AAAA - SSHFP - HINFO - POOL default: null description: - The type of DNS record to create required: false state: choices: - present - absent default: null description: - whether the record should exist or not required: false value: default: null description: - Record value - Must be specified when trying to ensure a record exists required: false domain: default: null 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. required: false record: default: null description: - Record to add, if blank a record for the domain will be created, supports the wildcard (*) required: false priority: default: null description: - Record priority required: false record_ids: default: null description: - List of records to ensure they either exist or don't exist required: false account_email: default: null description: - 'Account email. If omitted, the env variables DNSIMPLE_EMAIL and 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) ' required: false account_api_token: default: null description: - Account API token. See I(account_email) for info. required: false