sitehost.cloud.dns (1.2.0) — module

Install collection

Install with ansible-galaxy collection install sitehost.cloud:==1.2.0

Add to requirements.yml

  collections:
    - name: sitehost.cloud
      version: 1.2.0

Description

Used for creating, deleting and updating DNS records and DNS zones on your SiteHost accout.

Inputs

    
name:
    description:
    - The host name, alias, or service being defined by the record.
    - Please use the FQDN instead of relative names like C(@) or C(www)
    type: str

type:
    choices:
    - A
    - AAAA
    - CNAME
    - MX
    - TXT
    - CAA
    - SRV
    description:
    - The type of record you would like to use.
    type: str

state:
    description:
    - Desired state of the DNS zone / record.
    - C(present) will either upgrade or create a DNS zone or record.
    - C(absent) will delete a DNS zone or record.
    required: true
    type: str

domain:
    aliases:
    - zone
    - dns_zone
    description:
    - The selected DNS zone.
    - If DNS zone does not exist when adding a new DNS record, it will be automatically
      created.
    required: true
    type: str

content:
    description:
    - This is the value of the record, depending on the record type.
    type: str

priority:
    description:
    - The priority of the host for C(SRV,MX) records.
    type: int

record_id:
    description:
    - The id of an exisiting DNS record to update or delete.
    type: int

Outputs

dns:
  description: The dns record being created or modified.
  returned: success
  sample:
    change_date: '1695252962'
    content: 255.255.255.255"
    id: '1234567'
    name: www.mydomain.co.nz
    prio: '0'
    state: '0'
    ttl: '3600'
    type: A
  type: dict
msg:
  description: A short messages showing the state of the module execution.
  returned: always
  sample: 'DNS record created with id: 1234567'
  type: str