Frequently Asked Questions
- Can I create a zone in VinylDNS?
- How do I know my zone ID?
- How can I create a record with the same name as my zone?
- When I try to connect to my zone, I am seeing REFUSED
- When I try to connect to my zone, I am seeing NOTAUTH
- When I try to connect to my zone, I am seeing “dotted host” errors
- When I try to connect to my zone, I am seeing “invalid name server” errors
- How do I get API credentials?
- How are requests authenticated to the VinylDNS API?
To get started with VinylDNS, you must have an existing DNS zone. VinylDNS currently does not create zones, rather it connects to existing zones.
When viewing your zone in the portal, the zone ID is listed in the Manage Zone tab
of your zone. This ID is also present in the URL (if on that page it’s the ID after
To create a record with the same name as your zone, you have to use the special
@ character for the record name when you create your record set.
You cannot create CNAME records with @ as those are not supported. While some DNS services like
Route 53 support an ALIAS record type that does support a CNAME style @, ALIAS are not an official standard yet.
All other record types should be fine using the @ symbol.
When VinylDNS connects to a zone, it first validates that the zone is suitable for use in VinylDNS. To do so, it tests that the connections work, and that the zone data is valid.
REFUSED indicates that VinylDNS could not do a zone transfer to load the DNS records for examination. A few reasons for this are:
- The Transfer Connection you entered is invalid. Please verify that the TSIG
information you entered works. You can attempt to do a
digand request a zone transfer from the command line.
- You did not setup a Transfer Connection, but the VinylDNS default keys do not have transfer access to your zone. Steps must be taken outside of VinylDNS.
NOTAUTH indicates that the primary connection that VinylDNS uses to validate the zone is not working. The reasons are:
- The Connection you entered is invalid. Please verify that the TSIG information you entered works.
- You did not setup a Connection, but the VinylDNS default keys do not have update access to your zone. Steps must be taken outside of VinylDNS.
VinylDNS validates zones upon connect. One validation is to make sure that there are no “dotted” host.
A “dotted host” is a record label inside of a zone that has a “dot” in it’s name, but is not part of a subdomain of the zone.
For example, “foo.bar.example.com” is invalid, and considered a “dotted host”, if it lives inside of the “example.com” DNS zone. For this to be a valid record, this label would need to be a record named “foo” inside of the “bar.example.com” zone.
You will not be able to use VinylDNS for zones with dotted hosts until they are remediated. All remediation steps must be taken outside of VinylDNS.
- If possible, use dashes instead of dots. In the example, you can have “foo-bar.example.com”
One of the validations VinylDNS performs is to make sure the name servers that are in use in the zone are in a list of approved name servers. If your zone is hosted on name servers that are not in this list, you will not be able to use VinylDNS to manage your zone.
After logging in to the portal, click your username at the top right and select Download API Credentials.
If you need new API credentials select Regenerate Credentials. This will invalidate your previous credentials. If you use any VinylDNS tools beyond the portal you will need to provide those tools with your new credentials.
Refer to API Authentication.