domain_record_info.md

domain_record_info

Get info about a Linode Domain Record.

• 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: Get info about domain records by name
  linode.cloud.domain_record_info:
    domain: my-domain.com
    name: my-subdomain
    type: A
    target: 0.0.0.0

- name: Get info about a domain record by id
  linode.cloud.domain_info:
    domain: my-domain.com
    id: 12345

Parameters

Field	Type	Required	Description
domain_id	int	Optional	The ID of the parent Domain. Optional if domain is defined. (Conflicts With: domain)
domain	str	Optional	The name of the parent Domain. Optional if domain_id is defined. (Conflicts With: domain_id)
id	int	Optional	The unique id of the subdomain. Optional if name is defined. (Conflicts With: name)
name	str	Optional	The name of the domain record. Optional if id is defined. (Conflicts With: id)

Return Values

• record - View a single Record on this Domain.

  • Sample Response:

    {
      "created": "2018-01-01T00:01:01",
      "id": 123456,
      "name": "test",
      "port": 80,
      "priority": 50,
      "protocol": null,
      "service": null,
      "tag": null,
      "target": "192.0.2.0",
      "ttl_sec": 604800,
      "type": "A",
      "updated": "2018-01-01T00:01:01",
      "weight": 50
    }

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