Last updated on: 2018-05-16
Authored by: Rackspace Support
Previous section: Rackspace Cloud DNS available features
Implementation of Rackspace Cloud DNS is available through our RESTful API. To use our API, you should have a general understanding of Domain Name Systems (DNS) management and be familiar with the following elements:
For the full list and technical details of all available Cloud DNS API operations, see the Cloud DNS API reference.
Currently available domain and record operations include those shown in the following chart:
|List domains||List records|
|Lists all domains and subdomains manageable by the specified account and displays the IDs and names.||Lists all records that are configured for the domain or lists the details for a specific record.|
|List domain details||List record details|
|Lists the details of the specified domain and displays all details, including records. It cannot return details for a domain that has been deleted.||Lists the details of the specified record.|
|Create domain||Add record|
|Based on the configuration defined in the request object, provisions one or more new DNS domains under the account specified. Failures in the validation process are non-recoverable and require the caller to correct the cause of the failure and POST the request again.||Adds new records to the domain.|
|Modify domain||Modify record|
|Modifies DNS domain attributes. Records cannot be added, modified, or removed. Only the Time To Live (TTL) and email address attributes of a domain can be modified.||Modifies the configuration of a record in a domain.|
|Delete domain||Remove record|
|Removes the specified domains from the account. When a domain is deleted, its immediate resource records are also deleted from the account. By default, if a deleted domain had subdomains, each subdomain becomes a root domain and is not deleted. When a domain is deleted, purges any and all configuration data immediately. The domain cannot be recovered by using the API. In a request to remove multiple domains, a failure on a single part of the request causes the entire request to fail.||Removes a record from a domain.|
|Import domain||Export domain|
|Provisions a new DNS domain under the account specified by the BIND9-formatted file configuration contents defined in the request object. Failures in the validation process are non-recoverable and require the caller to correct the cause of the failure and POST the request again.||Provides the BIND9-formatted contents of the requested domain. This operation is intended for a single domain only, so no subdomain information is provided.|
The Cloud DNS API service provides support for Name Server (NS), TXT and SRV records. The following detailed information describes each of these record types:
For a full list of record types and their definitions, click here.
Next steps: Rackspace Cloud DNS API example
©2020 Rackspace US, Inc.
Except where otherwise noted, content on this site is licensed under a Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License