community.dns.hosttech_dns_zone_info (1.2.3) — module

Install collection

Install with ansible-galaxy collection install community.dns:==1.2.3

Add to requirements.yml

  collections:
    - name: community.dns
      version: 1.2.3

Description

Retrieves zone information in Hosttech DNS service.

Requirements

• lxml

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Retrieve details for foo.com zone
  community.dns.hosttech_dns_zone_info:
    zone: foo.com
    hosttech_username: foo
    hosttech_password: bar
  register: rec

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Retrieve details for zone 23
  community.dns.hosttech_dns_record:
    state: absent
    zone_id: 23
    hosttech_token: access_token

Inputs

    
zone:
    description:
    - The DNS zone to modify.
    - Exactly one of I(zone) and I(zone_id) must be specified.
    type: str

zone_id:
    description:
    - The ID of the DNS zone to modify.
    - Exactly one of I(zone) and I(zone_id) must be specified.
    type: int
    version_added: 0.2.0
    version_added_collection: community.dns

hosttech_token:
    aliases:
    - api_token
    description:
    - The password for the Hosttech API user.
    - Mutually exclusive with I(hosttech_username) and I(hosttech_password).
    - Since community.dns 1.2.0, the alias I(api_token) can be used.
    type: str
    version_added: 0.2.0
    version_added_collection: community.dns

hosttech_password:
    description:
    - The password for the Hosttech API user.
    - If provided, I(hosttech_username) must also be provided.
    - Mutually exclusive with I(hosttech_token).
    type: str

hosttech_username:
    description:
    - The username for the Hosttech API user.
    - If provided, I(hosttech_password) must also be provided.
    - Mutually exclusive with I(hosttech_token).
    type: str

Outputs

zone_id:
  description: The ID of the zone.
  returned: success
  sample: 23
  type: int
zone_name:
  description: The name of the zone.
  returned: success
  sample: example.com
  type: int