DNS Records

This is a simple module that supports listing DNS Records.

Example Syntax


name: List all Records in zone
ionoscloudsdk.ionoscloud.dns_record_info:
  zone: 'test.example.test.ansible.com'
register: records_response

Returned object

{
    "changed": false,
    "records": [
        {
            "id": "c76bf816-c11a-5dfc-8ef3-badfbee48451",
            "type": "record",
            "href": "/zones/b4021310-5e39-50bb-95f6-448b21bf0142/records/c76bf816-c11a-5dfc-8ef3-badfbee48451",
            "metadata": {
                "last_modified_date": "2023-10-05T14:38:56+00:00",
                "created_date": "2023-10-05T14:38:56+00:00",
                "state": "AVAILABLE",
                "fqdn": "<FQDN>",
                "zone_id": "b4021310-5e39-50bb-95f6-448b21bf0142"
            },
            "properties": {
                "name": "<RECORD_NAME>",
                "type": "CNAME",
                "content": "<CONTENT>",
                "ttl": 3600,
                "priority": 0,
                "enabled": true
            }
        }
    ],
    "failed": false
}

For more examples please check out the tests here.

Available parameters:

NameRequiredDescription

zone str

False

The ID or name of an existing Zone. Will be prioritized if both this and secondary_zone are set.

secondary_zone str

False

The ID or name of an existing Secondary Zone.

filters dict

False

Filter that can be used to list only objects which have a certain set of propeties. Filters should be a dict with a key containing keys and value pair in the following format: 'properties.name': 'server_name'

api_url str

False

The Ionos API base URL.

certificate_fingerprint str

False

The Ionos API certificate fingerprint.

username str

False

The Ionos username. Overrides the IONOS_USERNAME environment variable.

password str

False

The Ionos password. Overrides the IONOS_PASSWORD environment variable.

token str

False

The Ionos token. Overrides the IONOS_TOKEN environment variable.

Last updated