damex.incus.incus_network_zone_records role – Ensure Incus network zone records.

Note

This role is part of the damex.incus collection (version 1.9.0).

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 damex.incus.

To use it in a playbook, specify: damex.incus.incus_network_zone_records.

Entry point `main` – Ensure Incus network zone records.

Synopsis 

Ensure Incus network zone records.

Parameters 

Parameter	Comments
incus_network_zone_records list / elements=dictionary	List of Incus network zone records to ensure.
config dictionary	Network zone record configuration key-value pairs.
description string	Description of the network zone record.
entries list / elements=dictionary	List of DNS entries for the record.
ttl integer	Time to live in seconds.
type string / required	DNS record type (A, AAAA, CNAME, etc.).
value string / required	DNS record value.
name string / required	Name of the network zone record.
project string	Incus project for the network zone record.
state string	Desired state of the network zone record. Choices: `"present"` `"absent"`
zone string	Name of the network zone containing the record.
incus_network_zone_records_client_cert string	Client certificate content for API authentication.
incus_network_zone_records_client_cert_path path	Path to the TLS client certificate for API authentication.
incus_network_zone_records_client_key string	Client key content for API authentication.
incus_network_zone_records_client_key_path path	Path to the TLS client key for API authentication.
incus_network_zone_records_project string	Default Incus project for network zone records.
incus_network_zone_records_server_cert string	Server certificate content for API verification.
incus_network_zone_records_server_cert_path path	Path to the TLS server certificate for API verification.
incus_network_zone_records_socket_path path	Path to the Incus Unix socket.
incus_network_zone_records_state string	Default desired state of the network zone records. Choices: `"present"` `"absent"`
incus_network_zone_records_token string	Authentication token for the Incus API.
incus_network_zone_records_url string	URL of the Incus server API.
incus_network_zone_records_validate_certs boolean	Whether to validate TLS certificates. Choices: `false` `true`
incus_network_zone_records_zone string	Default network zone for network zone records.

Examples 

- name: Ensure incus network zone records
  hosts: incus
  tasks:
    - name: Ensure incus network zone records
      ansible.builtin.import_role:
        name: damex.incus.incus_network_zone_records
      vars:
        incus_network_zone_records_zone: example.com
        incus_network_zone_records:
          - name: web
            description: Web server records
            entries:
              - type: A
                value: 10.0.0.5
              - type: AAAA
                value: fd42::5
          - name: mail
            entries:
              - type: A
                value: 10.0.0.10

Collection links