Configure and customize DNS zone behavior including TTL, DNSSEC, and other domain-specific settings.
DNS Zones contain domain mapping information and essential DNS data associated with specific resources. Managing DNS Zone settings enables the activation of SOA (State of Authority) information and DNSSEC (Domain Name System Security Extensions) on a domain.
Follow this guide to manage domain DNS Zones using Vultr DNS, the Vultr Customer Portal, API, CLI, or Terraform.
ns1.vultr.com
with your primary name server if available and enter your domain administrator email address in the E-mail Address field.Send a GET
request to the List DNS domains endpoint and note the target domain in your output.
$ curl "https://api.vultr.com/v2/domains" \
-X GET \
-H "Authorization: Bearer ${VULTR_API_KEY}"
Send a GET
request to the Get DNSSec Info endpoint to view the domain's DNSSec status.
$ curl "https://api.vultr.com/v2/domains/{dns-domain}/dnssec" \
-X GET \
-H "Authorization: Bearer ${VULTR_API_KEY}"
Send a PUT
request to the Update a DNS Domain endpoint to enable DNSSec on the domain.
$ curl "https://api.vultr.com/v2/domains/{dns-domain}" \
-X PUT \
-H "Authorization: Bearer ${VULTR_API_KEY}" \
-H "Content-Type: application/json" \
--data '{
"dns_sec" : "enabled"
}'
Send a GET
request to the Get SOA Information endpoint to view the domain's SOA configuration.
$ curl "https://api.vultr.com/v2/domains/{dns-domain}/soa" \
-X GET \
-H "Authorization: Bearer ${VULTR_API_KEY}"
Send a PATCH
request to the Update SOA Information endpoint to update the domain's SOA configuration.
$ curl "https://api.vultr.com/v2/domains/{dns-domain}/soa" \
-X PATCH \
-H "Authorization: Bearer ${VULTR_API_KEY}" \
-H "Content-Type: application/json" \
--data '{
"nsprimary" : "primary-nameserver",
"email" : "adminEmail"
}'
List all domains in your Vultr account and note the target domain.
$ vultr-cli dns domain list
View the domain's DNSSec status.
$ vultr-cli dns domain dnssec-info <domainName>
Enable DNSSec on the domain.
$ vultr-cli dns domain dnssec <domainName> --enabled enabled
View the domain's SOA information.
$ vultr-cli dns domain soa-info <domainName>
Update the domain's SOA information.
$ vultr-cli dns domain soa-update <domainName> --email <adminEmail>--ns-primary <primary-nameserver>
Open your Terraform configuration where the domain is defined.
DNSSEC is managed via vultr_dns_domain
attributes; SOA fields are not exposed via Terraform at this time.
resource "vultr_dns_domain" "example" {
domain = "example.com"
dns_sec = "enabled" # enabled | disabled
}
Apply the configuration and observe the following output:
Apply complete! Resources: 0 added, 1 changed, 0 destroyed.
No comments yet.