• Buy Now
    • Rackspace Cloud
    • Email & Apps
    • Fanatical Support for AWS
    • Managed Google Cloud Platform
    • Office 365
  • Log In
    • MyRackspace Portal
    • Cloud Control Panel
    • Rackspace Webmail Login
    • Cloud Office Control Panel
  • Rackspace Logo
  • Developer Home
  • Developer Documentation
  • Blogs ▼
    • Technical Blog
    • Rackspace Blog
    • Solve: Thought Leadership
  • Support Documentation

Developer Docs


Let’s Build Something Powerful Together!

End-to-End Multicloud Solutions.   Solving Together.™   Learn more at Rackspace.com

Submit an issue
  • Cloud DNS 1.0
  • Getting started
    • Get your credentials
    • Sending API requests to Cloud DNS
      • Convert cURL examples to run on Windows
    • Authenticate to the Rackspace Cloud
      • Authenticate by using cURL
      • Send an authentication request
      • Review the authentication response
      • Configure environment variables
    • Concepts
      • DNS
      • Domain
      • Subdomain
      • Record
      • Domain Owner
    • Create and manage DNS domains
      • Creating a new cloud server
      • Creating a domain
      • Listing domain details
      • Adding records
  • General API Information
    • Service access endpoints
    • DNS Service versions
      • Contract version
      • API version headers
    • Request and response types
    • Supported Record Types
      • Notes
      • Notes
    • Synchronous and asynchronous responses
      • Viewing status of all asynchronous job requests
    • IP Address Support
    • DNS propagation
    • Persistent Connections
    • Content Compression
    • Paginated collections
      • Pagination elements and attributes
    • Limits
      • Rate limits
      • Absolute limits
      • Retrieve account limits
    • Faults
    • Date and time format
    • Comments
    • Role-based access control (RBAC)
      • Assigning Roles to Account Users
      • Roles available for Rackspace Cloud DNS
      • Multiproduct global roles and permissions
      • Resolving conflicts between RBAC multiproduct and product-specific roles
      • RBAC permissions cross-reference to Rackspace Cloud DNS API operations
  • API reference
    • Limits operations
      • List limits
      • Show limits
      • List limit types
    • Domains operations
      • List domains
      • List domains by name
      • Create domain
      • Update domains
      • Delete domains
      • Delete domains and subdomains
      • Search domains
      • List domain details without subdomains
      • Show domain
      • Update domain
      • Delete domain
      • Delete domain and its subdomains
      • Show domain changes
      • Export domain
      • Clone domain
      • Import domain
    • Subdomains operations
      • List subdomains
    • Records operations
      • List records
      • Search records
      • Add records
      • Delete records
      • Update records
      • Delete record
      • Update record
      • Show record details
    • Reverse DNS operations
      • Update PTR records
      • Add PTR records
      • List PTR records
      • Delete PTR records
      • Show PTR record
  • Release notes
    • v1.0.34 Configuration Changes, October 24, 2014
      • What's new
      • Resolved issues
      • Known issues
    • v1.0.34, October 14, 2014
      • What's new
      • Resolved issues
      • Known issues
    • v1.0.33, July 29, 2014
      • What's new
      • Resolved issues
      • Known issues
    • v1.0.31 configuration changes, July 16, 2014
      • What's new
      • Resolved issues
      • Known issues
    • v1.0.31, June 26, 2014
      • What's new
      • Resolved issues
      • Known issues
  • Service updates
  • Additional resources
  • Disclaimer

DNS Service versions#

The Cloud DNS Service version defines the contract and build information for the API.

Contract version#

The contract version denotes the data model and behavior that the API supports. The requested contract version is included in all request URLs. Different contract versions of the API may be available at any given time and are not guaranteed to be compatible with one another.

Example: Request URL (contract version is 1.0)

https://dns.api.rackspacecloud.com/v1.0/1234/domains

Note

This document pertains to contract version 1.0.

API version headers#

Every response from the Cloud DNS Service includes custom headers that identify the specific release version of the API that is in use. This information is used to assist in diagnosing issues and should be included in any support request.

API Version Headers

X-API-VERSION
The deployed version of the Cloud DNS Service. This is used to identify releases, and it should correspond to the contract version in the URL (that is, v1.0). Example value: X-API-VERSION=1.0.8
Previous Service access endpoints
Next Request and response types
Developer Network
  • Developer Center
  • API Documentation and User Guides
  • SDKs
  • Rackspace How-To
Blogs
  • Technical Blog
  • Rackspace Blog
  • Solve: Thought Leadership
Other Information
  • Customer Stories
  • Events
  • Programs
  • Careers
  • Style Guide for Technical Content
©2020 Rackspace US, Inc.
  • ©2020 Rackspace US, Inc.
  • About Rackspace
  • Privacy Statement
  • Website Terms
  • Trademarks