ClouDns icon

ClouDns

Consume Cloud Dns API (v.0.1.2)

Actions5

Records → Create

AI-generated

Overview

This node interacts with the ClouDns API to manage DNS records. Specifically, the 'Create' operation under the 'Records' resource allows users to add new DNS records to a specified domain or reverse zone. This is useful for automating DNS management tasks such as adding A, AAAA, MX, CNAME, TXT, and other types of DNS records programmatically. For example, a user can create an A record pointing a subdomain to an IP address or add an MX record for email routing.

Use Case Examples

  1. Create an A record for 'example.com' pointing to IP '10.10.10.10' with a TTL of 3600 seconds.
  2. Add an MX record to a domain with a specified priority and TTL.
  3. Create a CNAME record for a subdomain pointing to another domain name.

Properties

Name Meaning
Domain Name The domain name or reverse zone name where the DNS record will be created.
Record Type The type of DNS record to create, such as A, AAAA, MX, CNAME, TXT, NS, SRV, and others.
Record The value of the DNS record to add, e.g., an IP address or a domain name.
TTL Time to live for the DNS record, specifying how long the record is cached by DNS resolvers.
Additional Fields Optional additional parameters for the DNS record, such as host/subdomain, priority, weight, port, frame settings for web redirects, mail for RP records, SSHFP algorithm details, status, GeoDNS location, CAA flags and values, TLSA record details, and other advanced DNS record attributes.
Simplify Output Whether to simplify the returned data structure for easier consumption.

Output

JSON

  • status - Status of the API request, e.g., 'Success' or 'Failed'.
  • statusDescription - Description or message related to the status of the request.
  • recordId - Identifier of the created DNS record.
  • success - Boolean indicating if the record creation was successful.

Dependencies

  • ClouDns API

Troubleshooting

  • Ensure that the API credentials (auth-id and auth-password) are correctly configured and valid, as authentication failures will cause errors.
  • Verify that the domain name and record type are correctly specified and supported by the API.
  • Check that required fields such as domainName, recordType, record, and ttl are provided; missing required fields will cause the operation to fail.
  • If the API returns a 'Failed' status, review the statusDescription for specific error details and adjust parameters accordingly.

Links

  • ClouDns API Documentation - Official documentation for the ClouDns API, including details on record creation and supported record types.

Discussion