ClouDns icon

ClouDns

Consume Cloud Dns API (v.0.1.2)

Actions5

Records → List

AI-generated

Overview

This node interacts with the Cloud DNS API to list DNS records for a specified domain or reverse zone. It allows users to retrieve DNS records with various filtering and pagination options, such as filtering by host, record type, and sorting order. This node is useful for managing and auditing DNS records programmatically, for example, to automate DNS record retrieval for monitoring or integration with other systems.

Use Case Examples

  1. List all DNS records for a domain to audit current DNS settings.
  2. Retrieve DNS records filtered by host or record type for targeted management.
  3. Paginate through DNS records to handle large sets of data efficiently.

Properties

Name Meaning
Domain Name The domain name or reverse zone name whose DNS records you want to list.
Host Filter records by the exact host name.
Host Like Filter records by a partial match on the host name, ignoring the exact host filter if used.
Type Filter records by DNS record type (e.g., A, CNAME, MX).
Rows Per Page Number of results to return per page, with allowed values 10, 20, 30, 50, or 100.
Page The page number of results to retrieve.
Order By Sort the records by either host or points-to fields.
Simplify Output Option to simplify the returned data structure for easier consumption.

Output

JSON

  • status - Status of the API response indicating success or failure.
  • records
    • ``
      * host - Host name of the DNS record.
      * type - Type of the DNS record (e.g., A, CNAME).
      * record - The DNS record data (e.g., IP address for A record).
      * ttl - Time to live for the DNS record.

Dependencies

  • Cloud DNS API

Troubleshooting

  • Ensure the API credentials (auth-id and auth-password) are correctly configured and valid, as authentication failures will cause errors.
  • If the API returns a 'Failed' status, check the statusDescription for details and verify the domain name and parameters are correct.
  • Pagination parameters (Rows Per Page and Page) must be within allowed ranges; invalid values may cause errors or empty results.
  • Using 'Host Like' will ignore the exact 'Host' filter; ensure only one is used to avoid confusion.

Links

Discussion