ip_rdns.md

ip_rdns

Manage a Linode IP address's rDNS.

• Minimum Required Fields
• Examples
• Parameters
• Return Values

Minimum Required Fields

Field	Type	Required	Description
api_token	str	Required	The Linode account personal access token. It is necessary to run the module. It can be exposed by the environment variable LINODE_API_TOKEN instead. See details in Usage.

Examples

- name: Update reverse DNS
  linode.cloud.ip_rdns:
    state: present
    address: 97.107.143.141
    rdns: 97.107.143.141.nip.io

- name: Remove the reverse DNS
  linode.cloud.ip_rdns:
    state: absent
    address: 97.107.143.141

Parameters

Field	Type	Required	Description
address	str	Required	The IP address.
state	str	Optional	The state of this rDNS of the IP address. (Choices: present, absent)
rdns	str	Optional	The desired RDNS value. (Updatable)

Return Values

• ip - The updated IP address with the new reverse DNS in JSON serialized form.

  • Sample Response:

    {
      "address": "97.107.143.141",
      "gateway": "97.107.143.1",
      "linode_id": 123,
      "prefix": 24,
      "public": true,
      "rdns": "test.example.org",
      "region": "us-east",
      "subnet_mask": "255.255.255.0",
      "type": "ipv4",
      "vpc_nat_1_1": {
        "vpc_id": 242,
        "subnet_id": 194,
        "address": "139.144.244.36"
      }
    }

  • See the Linode API response documentation for a list of returned fields